@wildo-ai/framework-knowledge 1.1.11 → 1.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +170 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +27 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -17,12 +17,17 @@ its minimum sender assurance, or read a conversation thread.
|
|
|
17
17
|
/**
|
|
18
18
|
* What a message arrived on.
|
|
19
19
|
*
|
|
20
|
-
*
|
|
21
|
-
*
|
|
20
|
+
* Chat and Slack join this vocabulary when a provider can fill them — a channel nothing can receive on is a
|
|
21
|
+
* slot no configuration can satisfy.
|
|
22
22
|
*/
|
|
23
23
|
export enum InboundChannelKind {
|
|
24
24
|
/** Email received through the application's `EMAIL_INBOUND` provider and routed to an organization. */
|
|
25
25
|
EMAIL = 'email',
|
|
26
|
+
/**
|
|
27
|
+
* A text message received by the application's SMS provider on a number the application assigned to an
|
|
28
|
+
* organization (#3394), routed to that organization by the number it was sent TO, never by its sender.
|
|
29
|
+
*/
|
|
30
|
+
SMS = 'sms',
|
|
26
31
|
/**
|
|
27
32
|
* A signed HTTP delivery from another system (#1596). Derived for provider and application endpoint
|
|
28
33
|
* deliveries; a handler never declares it.
|
|
@@ -63,6 +68,13 @@ export enum InboundSenderAssurance {
|
|
|
63
68
|
* and `From` is the address that token was issued to.
|
|
64
69
|
*/
|
|
65
70
|
THREAD_TOKEN_BOUND = 'thread_token_bound',
|
|
71
|
+
/**
|
|
72
|
+
* SMS: the sending number is the verified phone number (`UserCredentials.phoneNumberVerified`) of exactly one
|
|
73
|
+
* active member of the routed organization. Verified when the member confirmed a code sent to it; the sender of
|
|
74
|
+
* THIS text is still not authenticated (caller ID can be spoofed onto SMS), so it identifies the member and
|
|
75
|
+
* grants nothing. Two members holding one number identify nobody.
|
|
76
|
+
*/
|
|
77
|
+
VERIFIED_MEMBER_NUMBER = 'verified_member_number',
|
|
66
78
|
}
|
|
67
79
|
|
|
68
80
|
/** The assurance levels meaningful on each channel — the type a channel's ladder and minimum are drawn from. */
|
|
@@ -72,6 +84,10 @@ export interface InboundSenderAssuranceByChannel {
|
|
|
72
84
|
| InboundSenderAssurance.DOMAIN_ALIGNED
|
|
73
85
|
| InboundSenderAssurance.KNOWN_CONTACT
|
|
74
86
|
| InboundSenderAssurance.THREAD_TOKEN_BOUND;
|
|
87
|
+
[InboundChannelKind.SMS]:
|
|
88
|
+
| InboundSenderAssurance.UNVERIFIED
|
|
89
|
+
| InboundSenderAssurance.KNOWN_CONTACT
|
|
90
|
+
| InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
|
|
75
91
|
[InboundChannelKind.WEBHOOK]: InboundSenderAssurance.UNVERIFIED | InboundSenderAssurance.SOURCE_SIGNED;
|
|
76
92
|
}
|
|
77
93
|
|
|
@@ -89,6 +105,16 @@ export const INBOUND_SENDER_ASSURANCE_LADDERS: { readonly [C in InboundChannelKi
|
|
|
89
105
|
InboundSenderAssurance.KNOWN_CONTACT,
|
|
90
106
|
InboundSenderAssurance.THREAD_TOKEN_BOUND,
|
|
91
107
|
],
|
|
108
|
+
/*
|
|
109
|
+
* A member's verified number outranks a contact the application recognises: the member proved the number by a code
|
|
110
|
+
* the engine sent to it, while a contact's number is whatever the application recorded. Neither authenticates the
|
|
111
|
+
* sender of this text (SMS has no counterpart of DMARC), which is why the ladder only ever IDENTIFIES.
|
|
112
|
+
*/
|
|
113
|
+
[InboundChannelKind.SMS]: [
|
|
114
|
+
InboundSenderAssurance.UNVERIFIED,
|
|
115
|
+
InboundSenderAssurance.KNOWN_CONTACT,
|
|
116
|
+
InboundSenderAssurance.VERIFIED_MEMBER_NUMBER,
|
|
117
|
+
],
|
|
92
118
|
[InboundChannelKind.WEBHOOK]: [InboundSenderAssurance.UNVERIFIED, InboundSenderAssurance.SOURCE_SIGNED],
|
|
93
119
|
};
|
|
94
120
|
|
|
@@ -276,6 +302,49 @@ export function isEmailMessageId(value: unknown): value is string {
|
|
|
276
302
|
return typeof value === 'string' && EMAIL_MESSAGE_ID_PATTERN.test(value);
|
|
277
303
|
}
|
|
278
304
|
|
|
305
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
306
|
+
// SMS: deriving sender assurance and a text's route tag
|
|
307
|
+
// ─────────────────────────────────────────────────────────────────────────────
|
|
308
|
+
|
|
309
|
+
/** What the routed organization knows about the number a text came from (#3394). */
|
|
310
|
+
export enum SmsSenderNumberMatch {
|
|
311
|
+
/** Not one member's verified number, and not a contact the application recognises. */
|
|
312
|
+
NONE = 'none',
|
|
313
|
+
/** The verified phone number of exactly one active member of the routed organization (sets `memberUserId`). */
|
|
314
|
+
VERIFIED_MEMBER = 'verified_member',
|
|
315
|
+
/** The handler's contact resolver recognised the number. The engine keeps no contacts of its own. */
|
|
316
|
+
APPLICATION_CONTACT = 'application_contact',
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
/**
|
|
320
|
+
* A text's sender assurance (#3394). PURE: the input is a lookup the engine made, never what the text says.
|
|
321
|
+
*
|
|
322
|
+
* SMS carries no sender authentication — no counterpart of DMARC, and caller ID can be spoofed onto a text — so every
|
|
323
|
+
* level above the floor IDENTIFIES the sender by a number someone verified or recorded, and none of them
|
|
324
|
+
* authenticates it. A handler's roles never depend on it (I8); a handler only states the minimum it acts on.
|
|
325
|
+
*/
|
|
326
|
+
export function deriveSmsSenderAssurance(match: SmsSenderNumberMatch): SenderAssuranceOf<InboundChannelKind.SMS> {
|
|
327
|
+
switch (match) {
|
|
328
|
+
case SmsSenderNumberMatch.VERIFIED_MEMBER: return InboundSenderAssurance.VERIFIED_MEMBER_NUMBER;
|
|
329
|
+
case SmsSenderNumberMatch.APPLICATION_CONTACT: return InboundSenderAssurance.KNOWN_CONTACT;
|
|
330
|
+
case SmsSenderNumberMatch.NONE: return InboundSenderAssurance.UNVERIFIED;
|
|
331
|
+
default: {
|
|
332
|
+
const unhandled: never = match;
|
|
333
|
+
return unhandled;
|
|
334
|
+
}
|
|
335
|
+
}
|
|
336
|
+
}
|
|
337
|
+
|
|
338
|
+
/**
|
|
339
|
+
* What an SMS `routeTag` looks like: the first word of a text, lower-cased, when it is a tag a handler declares
|
|
340
|
+
* (`INBOUND_ROUTE_TAG_PATTERN`'s shape). A text has no sub-address, so its first word is the only place a tag can be.
|
|
341
|
+
*/
|
|
342
|
+
export function smsRouteTagCandidate(text: string): string | undefined {
|
|
343
|
+
const first = text.normalize('NFKC').trim().split(/\s+/u)[0] ?? '';
|
|
344
|
+
const word = first.replace(/[^\p{L}\p{N}-]+$/gu, '').toLowerCase();
|
|
345
|
+
return /^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(word) ? word : undefined;
|
|
346
|
+
}
|
|
347
|
+
|
|
279
348
|
/**
|
|
280
349
|
* What an inbound handler's `ref` looks like: lower-case, dot-separated segments of `[a-z0-9-]`
|
|
281
350
|
* (`todos.intake`, `matters.mail-intake`). One definition for the backend's `inboundHandlerRef()`, which
|
|
@@ -308,8 +377,9 @@ export interface InboundChannelSource<C extends InboundChannelKind = InboundChan
|
|
|
308
377
|
readonly kind: InboundSourceKind.CHANNEL;
|
|
309
378
|
readonly channel: C;
|
|
310
379
|
/**
|
|
311
|
-
* The tag routing names — for email, `tag` in `cases+tag@firm.example
|
|
312
|
-
*
|
|
380
|
+
* The tag routing names — for email, `tag` in `cases+tag@firm.example`; for SMS, the text's first word
|
|
381
|
+
* (`BOOKING tomorrow 9am` carries `booking`), since a text has no sub-address. Lower-case letters, digits
|
|
382
|
+
* and hyphens. An SMS text whose first word no handler claims goes to the default.
|
|
313
383
|
*/
|
|
314
384
|
readonly routeTag?: string;
|
|
315
385
|
/** Take every message no `routeTag` claims. */
|
|
@@ -318,11 +388,12 @@ export interface InboundChannelSource<C extends InboundChannelKind = InboundChan
|
|
|
318
388
|
|
|
319
389
|
/** Who sent a message, as far as the engine could establish. */
|
|
320
390
|
export interface InboundMessageSender<C extends InboundChannelKind = InboundChannelKind> {
|
|
391
|
+
/** The sender's address: an email address, or for SMS the sending number in E.164. */
|
|
321
392
|
readonly address: string;
|
|
322
393
|
readonly name?: string;
|
|
323
394
|
/** Identification, never authentication — see `InboundSenderAssurance`. It grants nothing. */
|
|
324
395
|
readonly assurance: SenderAssuranceOf<C>;
|
|
325
|
-
/** Set when the sender is a verified, active member of the routed organization. */
|
|
396
|
+
/** Set when the sender is a verified, active member of the routed organization (for SMS: by their verified phone number). */
|
|
326
397
|
readonly memberUserId?: string;
|
|
327
398
|
}
|
|
328
399
|
|
|
@@ -368,9 +439,21 @@ export interface InboundEmailPayload {
|
|
|
368
439
|
readonly routeTag?: string;
|
|
369
440
|
}
|
|
370
441
|
|
|
442
|
+
/**
|
|
443
|
+
* What an SMS handler receives about a text beyond its words (#3394). A text has no subject and no copy list: only the
|
|
444
|
+
* application number it was sent to, which is also the number a reply goes out from.
|
|
445
|
+
*/
|
|
446
|
+
export interface InboundSmsPayload {
|
|
447
|
+
/** The application's number the text was sent to, in E.164 — one the application assigned to the organization. */
|
|
448
|
+
readonly to: string;
|
|
449
|
+
/** The tag the text was routed on (its first word), when a handler claims it. */
|
|
450
|
+
readonly routeTag?: string;
|
|
451
|
+
}
|
|
452
|
+
|
|
371
453
|
/** The payload each channel carries — total over the channels a handler can be declared for. */
|
|
372
454
|
export interface InboundChannelPayloadByChannel {
|
|
373
455
|
[InboundChannelKind.EMAIL]: InboundEmailPayload;
|
|
456
|
+
[InboundChannelKind.SMS]: InboundSmsPayload;
|
|
374
457
|
}
|
|
375
458
|
|
|
376
459
|
/** A channel a handler may be declared for. `WEBHOOK` is the endpoint handlers' channel, never declared here. */
|
|
@@ -406,6 +489,9 @@ export interface InboundContactLookups {
|
|
|
406
489
|
* The application's answer to "is this address a contact of this organization?" (#1630 M6). The engine
|
|
407
490
|
* keeps no contacts: without a resolver, only members of the organization reach `KNOWN_CONTACT`. Asked
|
|
408
491
|
* only for a domain-aligned sender, and a resolver that throws counts as "no".
|
|
492
|
+
*
|
|
493
|
+
* SMS (#3394): `address` is the sending number in E.164, and the resolver is asked for every text that is
|
|
494
|
+
* not a member's verified number (SMS has no alignment to gate on, so the answer only ever identifies).
|
|
409
495
|
*/
|
|
410
496
|
export type InboundContactResolver = (input: {
|
|
411
497
|
readonly organizationId: string;
|
|
@@ -419,6 +505,29 @@ export interface InboundReplyRequest {
|
|
|
419
505
|
readonly templateRef: string;
|
|
420
506
|
/** Rendered into the template as `additionalContext`. Stored on the reply's message row until the reply's retention ends. */
|
|
421
507
|
readonly variables: Readonly<Record<string, unknown>>;
|
|
508
|
+
/**
|
|
509
|
+
* Files to send with the reply (#1856): a signed copy, a receipt, the document the sender asked for. Each must be a
|
|
510
|
+
* file the HANDLER can read with its own roles in the delivery's organization — a file on a record it can READ, or one
|
|
511
|
+
* this delivery produced itself — and is refused, with the file named, when the reply is queued otherwise. Never
|
|
512
|
+
* another organization's file, whatever the handler learned its id from. At most `CONVERSATION_REPLY_MAX_ATTACHMENTS`.
|
|
513
|
+
*/
|
|
514
|
+
readonly attachmentFileIds?: readonly string[];
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
/**
|
|
518
|
+
* What an SMS handler asks `ctx.reply` to send (#3394): the words of the reply. A text has no template; what it says
|
|
519
|
+
* is the handler's, at most `CONVERSATION_SMS_REPLY_MAX_LENGTH` characters (refused when queued, never cut). It goes
|
|
520
|
+
* out from the application number the text was sent to, only while the thread is open, and never to a number that
|
|
521
|
+
* replied STOP.
|
|
522
|
+
*/
|
|
523
|
+
export interface InboundSmsReplyRequest {
|
|
524
|
+
readonly text: string;
|
|
525
|
+
}
|
|
526
|
+
|
|
527
|
+
/** The reply request each channel takes — total over the channels a handler can be declared for. */
|
|
528
|
+
export interface InboundReplyRequestByChannel {
|
|
529
|
+
[InboundChannelKind.EMAIL]: InboundReplyRequest;
|
|
530
|
+
[InboundChannelKind.SMS]: InboundSmsReplyRequest;
|
|
422
531
|
}
|
|
423
532
|
|
|
424
533
|
/** The reply that was queued — one per call, idempotent per delivery and template (see `ctx.reply`). */
|
|
@@ -462,19 +571,20 @@ export type InboundChannelHandlerContextBase = Omit<InboundHandlerContext, 'deli
|
|
|
462
571
|
};
|
|
463
572
|
|
|
464
573
|
/**
|
|
465
|
-
* The context a handler of reply mode `M` receives. Under `THREAD` it can answer
|
|
466
|
-
* is `never`, so calling it does not compile.
|
|
574
|
+
* The context a handler of reply mode `M` on channel `C` receives. Under `THREAD` it can answer, with the
|
|
575
|
+
* channel's own reply request; under `NONE` `reply` is `never`, so calling it does not compile.
|
|
467
576
|
*/
|
|
468
|
-
export type InboundChannelHandlerContext<M extends InboundReplyMode> = InboundChannelHandlerContextBase & (
|
|
577
|
+
export type InboundChannelHandlerContext<M extends InboundReplyMode, C extends DeclarableInboundChannel = DeclarableInboundChannel> = InboundChannelHandlerContextBase & (
|
|
469
578
|
M extends InboundReplyMode.THREAD
|
|
470
579
|
? {
|
|
471
580
|
/**
|
|
472
581
|
* Answer on the thread the message arrived on, and only there (I7). Writes the reply as an OUTBOUND
|
|
473
|
-
* message and queues it; the reply worker sends it
|
|
474
|
-
* provider with the thread's headers
|
|
475
|
-
*
|
|
582
|
+
* message and queues it; the reply worker sends it on the thread's channel: for email through the
|
|
583
|
+
* application's transactional email provider with the thread's headers, for SMS through the SMS
|
|
584
|
+
* provider from the number the text was sent to. Calling it twice with the same template (or, for
|
|
585
|
+
* SMS, the same text) in one delivery queues ONE reply — a retried handler does not answer twice.
|
|
476
586
|
*/
|
|
477
|
-
readonly reply: (request:
|
|
587
|
+
readonly reply: (request: InboundReplyRequestByChannel[C]) => Promise<InboundQueuedReply>;
|
|
478
588
|
}
|
|
479
589
|
: { readonly reply?: never }
|
|
480
590
|
);
|
|
@@ -498,7 +608,7 @@ export interface InboundChannelHandlerDefinition<C extends DeclarableInboundChan
|
|
|
498
608
|
/** The handler's whole authority, in the routed organization. Never the super-administrator role. */
|
|
499
609
|
readonly actingRoles: { readonly organization: readonly string[] };
|
|
500
610
|
readonly retry?: InboundRetryPolicy;
|
|
501
|
-
handle(ctx: InboundChannelHandlerContext<M>, message: InboundMessage<C>): Promise<void>;
|
|
611
|
+
handle(ctx: InboundChannelHandlerContext<M, C>, message: InboundMessage<C>): Promise<void>;
|
|
502
612
|
}
|
|
503
613
|
|
|
504
614
|
/** Identity function that infers the channel and the reply mode, so `ctx.reply` is typed from the declaration. */
|
|
@@ -558,8 +668,10 @@ export interface InboundAdoptedAttachment {
|
|
|
558
668
|
* - **Recorded** — every adoption writes `inbound_attachment_adopted` on the organization's audit trail.
|
|
559
669
|
*
|
|
560
670
|
* What the copy MAY do is decided by your write, not here: `ctx.resources.create/update` authorizes the write with
|
|
561
|
-
* the handler's roles as for any caller, and links the copy then.
|
|
562
|
-
*
|
|
671
|
+
* the handler's roles as for any caller, and links the copy then. Only this delivery may name it, and a handler can name
|
|
672
|
+
* no other unlinked file: an id taken from a sender's payload that names someone's upload answers `NOT_FOUND` (#3330). A
|
|
673
|
+
* copy your handler never names (the write failed, or a retry found the record already filed) is swept a day later like
|
|
674
|
+
* any upload nobody attached.
|
|
563
675
|
*/
|
|
564
676
|
export interface InboundAttachmentOperations {
|
|
565
677
|
adopt(fileId: string, target: InboundAttachmentAdoptionTarget): Promise<InboundAdoptedAttachment>;
|
|
@@ -652,7 +764,7 @@ export const ConversationThreadSchema = z.object({
|
|
|
652
764
|
channel: z.enum(InboundChannelKind).systemEnum('InboundChannelKind').isSummaryField().excludeFromUpdate()
|
|
653
765
|
.describe('The channel the thread runs on. Replies go out on this channel only.'),
|
|
654
766
|
threadKey: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
|
|
655
|
-
.describe("The channel's correlation key: for email, the Message-ID of the message that opened the thread."),
|
|
767
|
+
.describe("The channel's correlation key: for email, the Message-ID of the message that opened the thread; for SMS, the two numbers and the opening text's provider id."),
|
|
656
768
|
/** The address the application is exchanging messages with. Changing it revokes the previous counterpart's tokens. */
|
|
657
769
|
counterpartAddress: address().isDBIndexed().isSummaryField()
|
|
658
770
|
.describe('The address the application is exchanging messages with on this thread.'),
|
|
@@ -685,6 +797,20 @@ export const ConversationOutboundThreadingSchema = z.strictObject({
|
|
|
685
797
|
references: z.array(z.string().max(998)).max(100).default([]).describe('The thread\'s Message-IDs, oldest first, ending with the one answered.'),
|
|
686
798
|
});
|
|
687
799
|
|
|
800
|
+
/**
|
|
801
|
+
* The most files one reply carries. A reply answers one message, and a person reading it expects the few documents it
|
|
802
|
+
* is about (a signed copy, a receipt), not an archive; the email service also caps the attachments' total size
|
|
803
|
+
* (`OUTBOUND_ATTACHMENT_TOTAL_BYTES_LIMIT`), so the count is the bound a handler meets first, with the file named.
|
|
804
|
+
*/
|
|
805
|
+
export const CONVERSATION_REPLY_MAX_ATTACHMENTS = 10;
|
|
806
|
+
|
|
807
|
+
/**
|
|
808
|
+
* The longest text reply (#3394): what the SMS vendors accept in one message body (Twilio's `Body` and Telnyx's `text`
|
|
809
|
+
* both stop at 1600 characters, split by the carrier into segments). A reply longer than this is refused when it is
|
|
810
|
+
* queued, rather than cut.
|
|
811
|
+
*/
|
|
812
|
+
export const CONVERSATION_SMS_REPLY_MAX_LENGTH = 1600;
|
|
813
|
+
|
|
688
814
|
/** One message of a thread, in either direction. */
|
|
689
815
|
export const ConversationMessageSchema = z.object({
|
|
690
816
|
_id: z.string().min(1).isPrimaryKey().isSummaryField(),
|
|
@@ -693,9 +819,13 @@ export const ConversationMessageSchema = z.object({
|
|
|
693
819
|
.describe('The thread this message belongs to.'),
|
|
694
820
|
direction: z.enum(ConversationMessageDirection).systemEnum('ConversationMessageDirection').isSummaryField().excludeFromUpdate()
|
|
695
821
|
.describe('Whether the message was received from the counterpart or sent by the application.'),
|
|
696
|
-
/**
|
|
822
|
+
/**
|
|
823
|
+
* The RFC 5322 Message-ID on the wire — what a later In-Reply-To or References names. A text message has none: an
|
|
824
|
+
* SMS row carries `<providerMessageId@sms.invalid>` (the provider's id for the text, or the reply's submission id),
|
|
825
|
+
* which nothing on the wire ever names.
|
|
826
|
+
*/
|
|
697
827
|
rfcMessageId: z.string().min(1).max(998).isDBIndexed().excludeFromUpdate()
|
|
698
|
-
.describe('The Message-ID the message carried on the wire, angle brackets included.'),
|
|
828
|
+
.describe('The Message-ID the message carried on the wire, angle brackets included; for a text message, the provider\'s id for it.'),
|
|
699
829
|
fromAddress: address().isSummaryField().describe('Who sent the message.'),
|
|
700
830
|
// RESET, not MASK: the treatment belongs to the ARRAY, and a mask string is not an array. Erasure returns
|
|
701
831
|
// the list to its default — empty.
|
|
@@ -740,6 +870,15 @@ export const ConversationMessageSchema = z.object({
|
|
|
740
870
|
outboundStatus: z.enum(ConversationOutboundStatus).systemEnum('ConversationOutboundStatus').isDBIndexed().nullable().default(null)
|
|
741
871
|
.excludeFromCreate().excludeFromUpdate()
|
|
742
872
|
.describe('For a reply, where it stands with the sending provider; null for a received message.'),
|
|
873
|
+
/**
|
|
874
|
+
* OUTBOUND, SMS (#3394): the words the handler answered a text with. A text reply has no template — what it says is
|
|
875
|
+
* the handler's, as for the other texts the application sends — so the row keeps it until the reply's retention ends,
|
|
876
|
+
* as an email reply keeps its template variables. Null on every other row.
|
|
877
|
+
*/
|
|
878
|
+
replyText: addImpersonalizeWith(
|
|
879
|
+
z.string().max(CONVERSATION_SMS_REPLY_MAX_LENGTH).nullable().default(null).excludeFromUpdate().dataCategories(PersonalDataCategory.USER_CONTENT),
|
|
880
|
+
RedactionType.RESET,
|
|
881
|
+
).describe('For a reply by text message, what it said.'),
|
|
743
882
|
/** OUTBOUND: the template the HANDLER chose, and the variables it rendered with. */
|
|
744
883
|
templateRef: z.string().max(200).nullable().default(null).excludeFromUpdate()
|
|
745
884
|
.describe('For a reply, the email template the handler chose.'),
|
|
@@ -750,6 +889,15 @@ export const ConversationMessageSchema = z.object({
|
|
|
750
889
|
).describe('For a reply, the variables the template rendered with.'),
|
|
751
890
|
locale: z.string().max(35).nullable().default(null).excludeFromUpdate()
|
|
752
891
|
.describe('For a reply, the locale the template rendered in.'),
|
|
892
|
+
/**
|
|
893
|
+
* OUTBOUND: the files the handler attached to the reply (#1856), from the moment it is queued to the moment it is
|
|
894
|
+
* sent — this row is the reply's only record, so nothing else survives to the send attempt. Each was checked against
|
|
895
|
+
* the handler's own READ authority in the delivery's organization when the reply was queued, and the send confines
|
|
896
|
+
* them to that organization again. Ids only: a file's name and bytes stay with the file. Empty for a received message,
|
|
897
|
+
* whose attachments live in its channel record.
|
|
898
|
+
*/
|
|
899
|
+
attachmentFileIds: z.array(z.string().min(1)).max(CONVERSATION_REPLY_MAX_ATTACHMENTS).default([]).excludeFromUpdate()
|
|
900
|
+
.describe('For a reply, the ids of the files sent with it as attachments.'),
|
|
753
901
|
/**
|
|
754
902
|
* For a reply, while it is QUEUED: the Reply-To address its first send attempt composed. It carries the
|
|
755
903
|
* reply token IN PLAINTEXT (I12), so it is backend-only — no API returns it — and it is cleared when the
|
|
@@ -853,18 +1001,16 @@ export function EmbedLinkedConversations({ className }: EmbedLinkedConversations
|
|
|
853
1001
|
{ hostResourceType },
|
|
854
1002
|
);
|
|
855
1003
|
}
|
|
856
|
-
|
|
1004
|
+
// Threads are linked by type and id, not by a relationship, so this embed confines them itself (#3072).
|
|
1005
|
+
return compositeResourceContext.buildOperationContext({
|
|
857
1006
|
resourceType: CoreResourceType.CONVERSATION_THREADS,
|
|
858
1007
|
operationLike: CoreResourceOperation.LIST,
|
|
859
1008
|
requireAddressable: false,
|
|
860
|
-
});
|
|
861
|
-
return {
|
|
862
|
-
...threads,
|
|
863
1009
|
pinnedFilters: {
|
|
864
1010
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
|
|
865
1011
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
|
|
866
1012
|
},
|
|
867
|
-
};
|
|
1013
|
+
});
|
|
868
1014
|
}, [compositeResourceContext, hostResourceType, hostResourceId]);
|
|
869
1015
|
|
|
870
1016
|
return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
|
|
@@ -279,7 +279,17 @@ export type InboundChatActingMember = Extract<InboundChatMember, { readonly stan
|
|
|
279
279
|
* the decision notice's job (#2664 S5b), not the click's.
|
|
280
280
|
*/
|
|
281
281
|
export type InboundChatDecisionAnswer =
|
|
282
|
-
| {
|
|
282
|
+
| {
|
|
283
|
+
readonly member: InboundChatActingMember;
|
|
284
|
+
readonly outcome: HumanDecision_ActOutcome;
|
|
285
|
+
/**
|
|
286
|
+
* #2923: where the person answers this decision instead, when a chat answer cannot settle it (it requires a step-up,
|
|
287
|
+
* which a chat answer cannot carry, or its kind does not admit a chat answer): the decision's address in the
|
|
288
|
+
* application's inbox. Present exactly then, and when the application has a public address. A handler posts it as
|
|
289
|
+
* the message's link (`openInApplication`), never a refusal with nowhere to go.
|
|
290
|
+
*/
|
|
291
|
+
readonly openInApplicationUrl?: string;
|
|
292
|
+
}
|
|
283
293
|
| { readonly member: Exclude<InboundChatMember, InboundChatActingMember> };
|
|
284
294
|
|
|
285
295
|
/**
|
|
@@ -353,6 +363,16 @@ export enum ChatConverseRefusal {
|
|
|
353
363
|
BUSY_TOO_LONG = 'busy_too_long',
|
|
354
364
|
/** The message said nothing once the bot's mention was removed. */
|
|
355
365
|
EMPTY_MESSAGE = 'empty_message',
|
|
366
|
+
/**
|
|
367
|
+
* #2750: the message alone is larger than the chat agent's model can be sent, so it was refused rather than cut. Not
|
|
368
|
+
* kept; a shorter message is admitted.
|
|
369
|
+
*/
|
|
370
|
+
MESSAGE_TOO_LONG = 'message_too_long',
|
|
371
|
+
/**
|
|
372
|
+
* The chosen agent's system is open only to the roles it declares (`config.accessControl[].roles`), and the linked
|
|
373
|
+
* member holds none of them in the organization (#2544 follow-up). Not kept; an administrator can give them a role.
|
|
374
|
+
*/
|
|
375
|
+
SYSTEM_ROLE_NOT_HELD = 'system_role_not_held',
|
|
356
376
|
}
|
|
357
377
|
|
|
358
378
|
/** What a message waits for. */
|
|
@@ -635,6 +655,23 @@ export interface InboundHandlerDefinition<P = unknown> {
|
|
|
635
655
|
readonly dedupKey?: (delivery: VerifiedInboundDelivery) => string;
|
|
636
656
|
/** Deliveries sharing a non-null key run one at a time, in receive order. */
|
|
637
657
|
readonly orderingKey?: (delivery: VerifiedInboundDelivery, payload: P) => string | null;
|
|
658
|
+
/**
|
|
659
|
+
* The people this delivery's payload names (#1642): each person's email address, LOWER-CASED, or their user id in
|
|
660
|
+
* this application. Computed once, at receipt, from the parsed payload, and stored on the delivery (`subjectKeys`).
|
|
661
|
+
*
|
|
662
|
+
* Declare it whenever the payload can name a person (a contact, a signer, a customer). The stored body cannot be
|
|
663
|
+
* searched, so these keys are the only way the delivery is found for that person: when they are erased, every stored
|
|
664
|
+
* delivery whose keys hold their user id or their email address is DELETED inside the erasure, and an administrator
|
|
665
|
+
* finds the deliveries for a person through the SEARCH filter `subjectKeys`. A delivery that names someone and
|
|
666
|
+
* declares nothing keeps them in its payload until its retention period ends.
|
|
667
|
+
*
|
|
668
|
+
* The receiver trims each key and drops duplicates and empty ones. More than 20 keys, or a key longer than 320
|
|
669
|
+
* characters, cannot be stored: the delivery is refused as malformed, like a dedup key that cannot be stored.
|
|
670
|
+
*
|
|
671
|
+
* @example
|
|
672
|
+
* subjectKeys: (_delivery, payload) => [payload.contact.email.toLowerCase()],
|
|
673
|
+
*/
|
|
674
|
+
readonly subjectKeys?: (delivery: VerifiedInboundDelivery, payload: P) => readonly string[];
|
|
638
675
|
readonly scopeMode: InboundHandlerScopeMode;
|
|
639
676
|
/** Required for `ORGANIZATION_REQUIRED` and `RESOLVED_PER_DELIVERY`; refused for `APPLICATION`. */
|
|
640
677
|
readonly resolveScope?: (delivery: VerifiedInboundDelivery, payload: P, lookups: InboundScopeLookups) => Promise<InboundResolvedScope>;
|
|
@@ -116,14 +116,53 @@ meanwhile.
|
|
|
116
116
|
|
|
117
117
|
## What a stored delivery keeps
|
|
118
118
|
|
|
119
|
-
The raw payload, which can carry personal data
|
|
120
|
-
|
|
121
|
-
|
|
119
|
+
The raw payload, which can carry personal data, and the people that payload names as the handler declared
|
|
120
|
+
them (`subjectKeys`).
|
|
121
|
+
|
|
122
|
+
The body is stored base64, so nothing can search it: `subjectKeys` is the only way a delivery is found for
|
|
123
|
+
a person. Declare it on every handler whose payload can name someone:
|
|
124
|
+
|
|
125
|
+
```ts
|
|
126
|
+
import { inboundSubjectKeyForEmailAddress, inboundSubjectKeyForPhoneNumber } from '@wildo-ai/saas-models';
|
|
127
|
+
|
|
128
|
+
subjectKeys: (_delivery, payload) => [
|
|
129
|
+
inboundSubjectKeyForEmailAddress(payload.contact.email),
|
|
130
|
+
inboundSubjectKeyForPhoneNumber(payload.contact.phone ?? ''),
|
|
131
|
+
].filter((key): key is string => key !== undefined),
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
- A key is one of three things: a person's email address, LOWER-CASED (`inboundSubjectKeyForEmailAddress`);
|
|
135
|
+
their phone number in E.164 form with its `+`, separators removed (`inboundSubjectKeyForPhoneNumber`,
|
|
136
|
+
which answers `undefined` for a national number, since nothing could match it); or their user id in this
|
|
137
|
+
application. The receiver trims the keys and drops empty and repeated ones; more than 20, or one longer
|
|
138
|
+
than 320 characters, refuses the delivery as malformed (`400`), like a dedup key that cannot be stored.
|
|
139
|
+
- When a person with an account is erased, every stored delivery whose keys hold their user id, their email
|
|
140
|
+
address, or a phone number on their profile or their sign-in credentials is DELETED inside the erasure, in
|
|
141
|
+
both delivery tables, unless a legal hold keeps it. The erasure receipt lists the deleted delivery ids
|
|
142
|
+
(`row_deleted`), never the payload.
|
|
143
|
+
- The engine keys its own deliveries the same way: an email received through the email channel by its
|
|
144
|
+
sender, recipients and copied addresses (cut to 20, sender first), an email provider's notification
|
|
145
|
+
likewise (a pushed message, or a fetched provider's notification, which names the sender and recipients
|
|
146
|
+
too), and an SMS provider notification by the number of the person it is about. The SMS report the
|
|
147
|
+
engine records from that notification carries the same key and is deleted with it.
|
|
148
|
+
- A person's access export reads the deliveries naming them by the same keys; a delivery that also names
|
|
149
|
+
someone else is handed without its payload.
|
|
150
|
+
- An administrator finds a person's deliveries with the SEARCH filter `subjectKeys` (an address or a user
|
|
151
|
+
id), for an access request or a person who has no account here.
|
|
152
|
+
- For a person with NO account here (a lead, a contact, someone who only wrote or texted), the scope's
|
|
153
|
+
administrator erases their deliveries with the `eraseForSubjectKey` operation: the person's email address,
|
|
154
|
+
phone number or a key your handler declared (`identifierKind` + `identifier`), and a written
|
|
155
|
+
`justification`. It deletes only that scope's deliveries (the application's also deletes the SMS reports
|
|
156
|
+
naming the person), keeps what a legal hold covers, and answers the deleted ids. Its audit event,
|
|
157
|
+
`INBOUND_DELIVERY_ERASED`, names the ids and a sha256 of the key, never the key.
|
|
158
|
+
- A delivery whose handler declares no keys keeps whoever it names until the retention period below ends,
|
|
159
|
+
or until its organization is purged. Declaring keys on a handler does not reach deliveries stored before
|
|
160
|
+
it did.
|
|
122
161
|
|
|
123
162
|
## Audit events
|
|
124
163
|
|
|
125
164
|
`INBOUND_DELIVERY_REJECTED` · `_ACCEPTED` · `_UNROUTABLE` · `_PROCESSED` · `_FAILED` (each retry) ·
|
|
126
|
-
`_DEAD` · `_REPLAYED`. None carries the payload; the stored delivery does.
|
|
165
|
+
`_DEAD` · `_REPLAYED` · `_ERASED`. None carries the payload; the stored delivery does.
|
|
127
166
|
|
|
128
167
|
## How long a delivery is kept
|
|
129
168
|
|
|
@@ -9,8 +9,8 @@ message gets to it.
|
|
|
9
9
|
|
|
10
10
|
| Step | What happens | Fails closed how |
|
|
11
11
|
|---|---|---|
|
|
12
|
-
| Notification | The provider POSTs
|
|
13
|
-
| Fetch |
|
|
12
|
+
| Notification | The provider POSTs to `/api/v1/webhooks/<provider>/<endpoint>`: a small signed notification (Resend), or the whole message, attachments included (Postmark); the engine verifies it and stores it once | Unsigned, forged or wrong credentials → `401`, nothing stored; a pushed message over 10 MB of JSON → `413`, audited |
|
|
13
|
+
| Fetch | A notified provider: the engine fetches the message, its attachments and its raw bytes from it. A pushing provider: the engine reads them out of the body it verified, and empties that body once the message is stored | Only from the provider's declared hosts, never following a redirect; a pushed attachment the body lacks refuses the message |
|
|
14
14
|
| Route | Each recipient address is routed to ONE organization (below) | An address no rule reaches is `UNROUTABLE` and audited, never guessed |
|
|
15
15
|
| Store | One `inboundEmails` row per organization the message reached | A message over the size limit is kept as its envelope only (`REJECTED_LIMIT`) |
|
|
16
16
|
| Scan | Every attachment, and the raw bytes, are scanned before anything may serve them | Infected, or unscannable (no scanner configured) → withheld, with the reason |
|
|
@@ -82,7 +82,19 @@ Three declarations, all required:
|
|
|
82
82
|
|
|
83
83
|
3. **The secrets** in each environment: the provider's API key and its webhook signing secret
|
|
84
84
|
(`wildo secrets list` names them; for Resend, `RESEND_API_KEY` and `RESEND_WEBHOOK_SECRET`). Then register
|
|
85
|
-
the notification URL with the provider for the `email.received` event.
|
|
85
|
+
the notification URL with the provider for the `email.received` event. For Postmark (the registry provider,
|
|
86
|
+
`wildo registry add wildo/providers/postmark`), the secret is `POSTMARK_INBOUND_WEBHOOK_CREDENTIAL`, a
|
|
87
|
+
`user-id:password` you generate, and the URL you give the Postmark server's inbound webhook carries it:
|
|
88
|
+
`https://<user-id>:<password>@<api host>/api/v1/webhooks/postmark/inbound-email`. Postmark receives on ONE inbound
|
|
89
|
+
domain per server: make it the shared domain. For Mailgun (`wildo registry add wildo/providers/mailgun`), the
|
|
90
|
+
secrets are `MAILGUN_API_KEY` (it also hosts organizations' domains) and `MAILGUN_WEBHOOK_SIGNING_KEY`, the
|
|
91
|
+
account's webhook signing key (Settings, API Security; not the API key). Create a route whose `forward()` URL is
|
|
92
|
+
`https://<api host>/api/v1/webhooks/mailgun/inbound-email-json`: only a URL ending in `json` makes Mailgun post the
|
|
93
|
+
message as JSON with its signature in headers; any other URL posts a form, which is refused (`415`).
|
|
94
|
+
|
|
95
|
+
A provider that receives on one domain for the whole application (Postmark) hosts no organization's own domain: a
|
|
96
|
+
`claim` is refused with `EMAIL_DOMAIN_SINGLE_INBOUND_DOMAIN`, and organizations receive at their address on the
|
|
97
|
+
shared domain. It also reports no SPF, DKIM or DMARC result, so its senders are identified as unverified.
|
|
86
98
|
|
|
87
99
|
`email.inbound` also takes `rawMimeRetention` (`KEEP` by default: only the original bytes can be re-verified),
|
|
88
100
|
`organizationSendingDomainUse` (below) and `maxMessageSizeBytes` (25 MB by default).
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
# The SMS channel — texts people send to the application's numbers
|
|
2
|
+
|
|
3
|
+
Read this when people should be able to text the application (booking changes, a reply to a reminder, a short
|
|
4
|
+
request) and the text should reach code you write, or be answered by text.
|
|
5
|
+
|
|
6
|
+
## What reaches your handler, and what never does
|
|
7
|
+
|
|
8
|
+
The SMS provider posts every text it receives to its notification endpoint. The engine verifies it, records it
|
|
9
|
+
(the `smsProviderEvents` row), and reads it for the carrier keywords first:
|
|
10
|
+
|
|
11
|
+
| the text | what happens |
|
|
12
|
+
|---|---|
|
|
13
|
+
| `STOP` (and the other opt-out words), `START`/`UNSTOP`, `HELP`/`INFO` — as the WHOLE message | a CONTROL message: the opt-out list moves (or the vendor answers HELP). It never reaches a handler |
|
|
14
|
+
| anything else, sent to a number the application gave an organization | admitted to that organization's SMS channel handler |
|
|
15
|
+
| anything else, sent to any other number (the application's own sender number, a withdrawn number, a short code) | stored as an UNROUTABLE inbound delivery, audited, run by nobody |
|
|
16
|
+
|
|
17
|
+
"Stop by tomorrow?" is a message, not a STOP: only the whole message counts as a keyword.
|
|
18
|
+
|
|
19
|
+
An application that declares no SMS channel handler still receives texts: they are recorded and read for STOP and
|
|
20
|
+
START, nothing more.
|
|
21
|
+
|
|
22
|
+
## Which organization a text belongs to
|
|
23
|
+
|
|
24
|
+
A text has no sub-address, so the number it was sent TO is the only thing that says whose it is. The application's
|
|
25
|
+
super-administrator gives each organization a number it holds at its SMS provider, as an `smsNumberAssignments` row
|
|
26
|
+
(`phoneNumber` in E.164 with its `+`, `assignedOrganizationId`). One number belongs to one organization.
|
|
27
|
+
|
|
28
|
+
- An organization cannot claim a number itself. Every number sits in the application's own provider account, so no
|
|
29
|
+
organization can prove a number is its own, and a self-claim would let one tenant take another's texts.
|
|
30
|
+
- The application's own sender number (`providerConfigurations.<sms provider>.SMS_PROVIDER.fromNumber`) is never
|
|
31
|
+
assigned: sign-in codes and notifications go out from it, and the answers to them belong to no organization.
|
|
32
|
+
- Withdrawing a number (DELETE) stops routing at once; the next text to it is UNROUTABLE.
|
|
33
|
+
|
|
34
|
+
## Who sent it — the SMS ladder
|
|
35
|
+
|
|
36
|
+
| level | means |
|
|
37
|
+
|---|---|
|
|
38
|
+
| `UNVERIFIED` | nothing is known about the number |
|
|
39
|
+
| `KNOWN_CONTACT` | your handler's `contactResolver` recognised the number (it is asked with the number, in E.164) |
|
|
40
|
+
| `VERIFIED_MEMBER_NUMBER` | the number is the VERIFIED phone number of exactly one active member of the organization; `message.sender.memberUserId` names them |
|
|
41
|
+
|
|
42
|
+
Two members holding the same number identify nobody. And SMS has no sender authentication at all (caller ID can be
|
|
43
|
+
spoofed onto a text), so every level IDENTIFIES and none authenticates: the handler's `actingRoles` are the same for
|
|
44
|
+
every sender. Choose `minimumSenderAssurance` for what the handler does, exactly as for email; a text below it goes
|
|
45
|
+
to your `belowMinimumHandlerRef`, or is stored and audited.
|
|
46
|
+
|
|
47
|
+
**A text never authorizes anything.** Not a payment change, not an approval, not a new recipient, not a cancellation
|
|
48
|
+
of something that costs money — record the request and have a person confirm it through a trusted channel.
|
|
49
|
+
|
|
50
|
+
## Routing between handlers
|
|
51
|
+
|
|
52
|
+
One handler per channel declares `isDefault: true`. Another may declare a `routeTag`: a text whose FIRST WORD is
|
|
53
|
+
that tag goes to it (`CANCEL my 3pm` → `routeTag: 'cancel'`), with the tag in `message.payload.routeTag`. A first
|
|
54
|
+
word no handler claims goes to the default. Once you declare any SMS handler, the default is required (startup
|
|
55
|
+
refuses otherwise), so an untagged text always has an owner.
|
|
56
|
+
|
|
57
|
+
## Threads
|
|
58
|
+
|
|
59
|
+
A thread is one exchange between the organization's number and the person's number: the next text of the same pair
|
|
60
|
+
joins the newest OPEN thread, another number or a closed thread starts a new one. `message.thread` and
|
|
61
|
+
`ctx.thread.link` work as for email; the thread's `counterpartAddress` is the person's number. A text carries no
|
|
62
|
+
attachments (MMS is not received).
|
|
63
|
+
|
|
64
|
+
## Replying by text
|
|
65
|
+
|
|
66
|
+
Declare `replyMode: InboundReplyMode.THREAD`, then:
|
|
67
|
+
|
|
68
|
+
```ts
|
|
69
|
+
await ctx.reply({ text: 'Friday at 10 works. Reply STOP to stop these messages.' });
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
- The words are yours: no template. At most 1600 characters; longer, empty or not a string is refused (VALIDATION)
|
|
73
|
+
and nothing is queued.
|
|
74
|
+
- The reply goes FROM the number the text was sent to, TO the person who texted, and only while the thread is OPEN.
|
|
75
|
+
- It goes through the application's SMS send, so a number that replied STOP is never texted: the reply settles
|
|
76
|
+
FAILED with `recipient_opted_out`.
|
|
77
|
+
- Calling `ctx.reply` twice with the same text in one delivery queues one reply.
|
|
78
|
+
- A text reply is sent AT MOST ONCE. SMS vendors take no idempotency key, so a send whose answer was lost is never
|
|
79
|
+
retried (it would text twice): the reply row settles FAILED, `InboundReplySmsOutcomeUnknown`, and the operator sees
|
|
80
|
+
that the text may or may not have gone.
|
|
81
|
+
- A reply answers the person's own message. It does not imply consent to any other text: notifications still need
|
|
82
|
+
their recorded SMS consent.
|
|
83
|
+
|
|
84
|
+
## Enabling it
|
|
85
|
+
|
|
86
|
+
1. The SMS capability with a provider that declares a notification half (Twilio; Telnyx, `provider-telnyx`), on
|
|
87
|
+
the backend scope with `SMS_PROVIDER` and `WEBHOOK_ORIGINATOR`, its notification endpoint enabled, and the public
|
|
88
|
+
API URL set so the provider can reach it. Without the endpoint served, an SMS channel handler refuses startup.
|
|
89
|
+
2. Give each organization its number: Settings → Administration → SMS numbers (the `application-sms-numbers`
|
|
90
|
+
destination, shown where the SMS capability is enabled), or `POST` on `smsNumberAssignments` — both as the
|
|
91
|
+
application's super-administrator.
|
|
92
|
+
3. Declare the handler with `defineInboundChannelHandler`, `source: { kind: InboundSourceKind.CHANNEL, channel:
|
|
93
|
+
InboundChannelKind.SMS, isDefault: true }`, and list it in the module's `inboundHandlers`.
|