@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
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 +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +321 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- 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 +0 -3
- 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 +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- 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 +8 -5
- 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 +55 -10
- 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 +1 -1
- 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 +1 -6
- 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 +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 +1 -6
- 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 +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 +0 -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 +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- 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 +10 -3
- 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 +7 -3
- 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 +8 -3
- 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 +1 -1
- 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 +0 -1
- 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 +7 -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 +9 -4
- 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 +3 -2
- 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 +4 -3
- 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 +1 -1
- 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 +1 -3
- 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 +1 -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 +0 -1
- 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 +10 -3
- 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 +8 -3
- 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 +12 -5
- 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 +33 -5
- 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 +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- 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 +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +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 +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- 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 +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +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 +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +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.js +1 -1
- 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.js +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 +0 -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 +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -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 +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -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 +0 -1
- 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 +1 -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 +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.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 +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- 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 +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5957 -1729
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -0,0 +1,301 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: inbound-channels
|
|
3
|
+
description: Declare code that runs when a message ARRIVES — a signed webhook from another system, or an email from a person — on `BackendDomainModule.inboundHandlers`, stored once, retried and replayable, with the sender's assurance deciding whether the handler runs and never what it may do. Use when the user says "receive a webhook from X", "add an inbound webhook endpoint", "handle Svix / Resend webhooks", "a client's system should create records in our app", "verify an HMAC-signed callback", "replay a failed webhook", "why does /webhooks/app/<key> answer 404", "clients should email documents to a case", "turn incoming email into tickets", "reply to the sender automatically", "only accept mail from known contacts", "let each organization receive mail at its own domain", or "give each client a mailbox on our domain".
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Inbound channels — handlers for messages other systems send
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
An inbound handler is backend code that runs on one message sent to your application: a signed delivery
|
|
24
|
+
from another system (an ENDPOINT handler), or an email from a person (a CHANNEL handler,
|
|
25
|
+
`references/email-channel.md`). You declare WHAT the message means; the engine owns everything between the wire and your
|
|
26
|
+
code: body limits, signature verification, a durable dedup ledger, scope resolution, retries, a DEAD
|
|
27
|
+
state and operator replay. The handler runs later, in a worker, with the roles you declare — in exactly
|
|
28
|
+
the one organization (or the application) the message resolved to, never in more.
|
|
29
|
+
|
|
30
|
+
## App Paths
|
|
31
|
+
|
|
32
|
+
| Surface | Glob (relative to the app root) |
|
|
33
|
+
|---|---|
|
|
34
|
+
| Handler definition | `backend-api/src/modules/<slug>/inbound/<name>.inbound-handler.ts` |
|
|
35
|
+
| Registration | `backend-api/src/modules/<slug>/index.ts` → `backendModule.inboundHandlers` |
|
|
36
|
+
| Payload resource writes | the module's resources, via `ctx.resources` |
|
|
37
|
+
| Secret | `infrastructure/<env>/secrets/secrets.json` → `inboundEndpointEnv.WILDO_INBOUND_<ENDPOINT_KEY>__SECRET` |
|
|
38
|
+
| Operator surface | Settings → Inbound deliveries (organization) / Administration → Inbound deliveries |
|
|
39
|
+
| Email channel handler | `backend-api/src/modules/<slug>/inbound/<handlerRef>.inbound-channel-handler.ts` — the file is NAMED after the handler's `ref` (`matters.mail-intake` → `matters.mail-intake.inbound-channel-handler.ts`), imported by the module's `index.ts` from `./inbound/<handlerRef>.inbound-channel-handler` and listed in its `inboundHandlers`. A build task producing the handler lands when that index imports that path |
|
|
40
|
+
| Receiving email | `wildo.saas.config.ts` → `engineCapabilities` enables `EMAIL_INBOUND`, with a receiving provider selected (`config-saas`) and declared on the backend scope with `EMAIL_INBOUND_PROVIDER` + `WEBHOOK_ORIGINATOR` |
|
|
41
|
+
| Shared receiving domain | `backend-api/src/saas-config.backend.ts` → `email.inbound.sharedDomain` |
|
|
42
|
+
| Organization domains, client mailboxes | engine resources `organizationEmailDomains` / `clientMailboxes` — organization settings, no code |
|
|
43
|
+
| Reply templates | the module's email templates (`email-add-template`) |
|
|
44
|
+
|
|
45
|
+
## When to Use
|
|
46
|
+
|
|
47
|
+
- A partner, client or SaaS tool POSTs signed JSON to your application and something must happen.
|
|
48
|
+
- You need each event stored once, retried until it succeeds or is dead, and a way to replay what failed.
|
|
49
|
+
- People email your application — documents to a case, requests to a support address — and the message
|
|
50
|
+
should file, create or answer something.
|
|
51
|
+
|
|
52
|
+
## When NOT to Use
|
|
53
|
+
|
|
54
|
+
- Receiving a PROVIDER's webhooks the engine already handles (billing) — that is the provider's own wiring.
|
|
55
|
+
- An AI agent calling you — that is A2A (`flows-actors-a2a-exposure`) or MCP (`resource-mcp-tool-exposure`).
|
|
56
|
+
- A human submitting a form on your public website — `website-inbound-contact-forms`.
|
|
57
|
+
- Sending webhooks OUT to customers — the outbound webhook configuration, not a handler.
|
|
58
|
+
- Sending email your application starts (notifications, invitations) — `email-add-template`. A channel
|
|
59
|
+
handler only ANSWERS a message it received.
|
|
60
|
+
|
|
61
|
+
## Workflow
|
|
62
|
+
|
|
63
|
+
1. **Pick the scheme** the sender signs with (`references/inbound-delivery-lifecycle.md` → "Choosing the
|
|
64
|
+
scheme"). A scheme without a signed id (`HMAC_SHA256_HEADER`) needs `dedupKey`.
|
|
65
|
+
2. **Pick the scope mode** from where the sender's events belong ("Choosing the scope mode"). An
|
|
66
|
+
organization-scoped handler declares `resolveScope` and `actingRoles.organization`.
|
|
67
|
+
3. **Declare the handler** with `defineInboundHandler` and a `payloadSchema` for the body
|
|
68
|
+
(`references/framework-inbound-handler-api.md`). Keep `actingRoles` to what the handler writes —
|
|
69
|
+
never `APP_ADMIN_SUPER_ADMIN`.
|
|
70
|
+
4. **Register it** on the module's `inboundHandlers`. A misdeclaration stops the backend at startup
|
|
71
|
+
with the rule it broke.
|
|
72
|
+
5. **Provide the secret** in each environment's `secrets.json`, under `inboundEndpointEnv`, keyed by the
|
|
73
|
+
name the engine derives from the endpoint key: `todo-intake` → `WILDO_INBOUND_TODO_INTAKE__SECRET`
|
|
74
|
+
(`deriveInboundEndpointSecretEnvVarName` from `@wildo-ai/saas-models`). `wildo config sync` delivers
|
|
75
|
+
it to the backend only. Without it the route is not mounted and senders get `404`.
|
|
76
|
+
6. **Verify** with the checks below, then send a signed test delivery.
|
|
77
|
+
|
|
78
|
+
**For email** (`references/email-channel.md`), the steps differ:
|
|
79
|
+
|
|
80
|
+
1. **Enable `EMAIL_INBOUND`** with a receiving provider, its two protocols, its secrets and a shared domain
|
|
81
|
+
(`references/receiving-email.md` → "Configuring receiving"). A channel handler refuses startup without
|
|
82
|
+
the capability and the provider.
|
|
83
|
+
2. **Pick the minimum sender assurance** for each handler ("Choosing the minimum"), and decide where a
|
|
84
|
+
message below it goes (`belowMinimumHandlerRef`, or stored and audited).
|
|
85
|
+
3. **Pick the route**: one handler per channel with `isDefault: true`, others by `routeTag`.
|
|
86
|
+
4. **Declare `replyMode`** — `NONE`, or `THREAD` to answer with a template you registered.
|
|
87
|
+
5. **Declare the handler** with `defineInboundChannelHandler` (`references/framework-inbound-channel-api.md`)
|
|
88
|
+
and register it on `inboundHandlers` beside any endpoint handler.
|
|
89
|
+
6. **Never let a message authorize** a payment change, an approval or a new recipient — record it and
|
|
90
|
+
have a person confirm through a trusted channel ("Authorizing actions never come from a message").
|
|
91
|
+
7. **Show the conversation** on the record it is about: the handler links the thread with
|
|
92
|
+
`ctx.thread.link`, and the record's READ view places `EmbedLinkedConversations`.
|
|
93
|
+
|
|
94
|
+
## Worked Example
|
|
95
|
+
|
|
96
|
+
A client system asks for a todo in one list. Svix-verified; the organization is the one that OWNS that
|
|
97
|
+
list, looked up in the application's data rather than read from the sender; the list id is the ordering
|
|
98
|
+
key so one list's requests are created in order; `ORG_MEMBER` is the whole authority; a short retry policy
|
|
99
|
+
because someone asking for a todo expects it within a minute:
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
## Usage Example
|
|
103
|
+
|
|
104
|
+
```typescript
|
|
105
|
+
/** The event types the intake endpoint takes, as the sender names them in the body's `type`. */
|
|
106
|
+
export enum TodoIntakeEventType {
|
|
107
|
+
/** A client system asks for one todo in one of its lists. */
|
|
108
|
+
TODO_REQUESTED = 'todo.requested',
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
export const TodoIntakePayloadSchema = z.object({
|
|
112
|
+
type: z.literal(TodoIntakeEventType.TODO_REQUESTED),
|
|
113
|
+
// No organization: the list decides it (see the header).
|
|
114
|
+
todoListId: z.string().min(1),
|
|
115
|
+
title: z.string().min(1).max(200),
|
|
116
|
+
description: z.string().max(1000).optional(),
|
|
117
|
+
});
|
|
118
|
+
|
|
119
|
+
export const todoIntakeInboundHandler = defineInboundHandler({
|
|
120
|
+
ref: inboundHandlerRef('todos.intake'),
|
|
121
|
+
source: {
|
|
122
|
+
kind: InboundSourceKind.APPLICATION_ENDPOINT,
|
|
123
|
+
endpointKey: 'todo-intake',
|
|
124
|
+
verification: { scheme: InboundVerificationScheme.SVIX_V1 },
|
|
125
|
+
eventTypes: [TodoIntakeEventType.TODO_REQUESTED],
|
|
126
|
+
},
|
|
127
|
+
payloadSchema: TodoIntakePayloadSchema,
|
|
128
|
+
// Svix signs a delivery id, so the engine deduplicates on it; no `dedupKey` needed.
|
|
129
|
+
// Requests for one list are created in the order they arrived.
|
|
130
|
+
orderingKey: (_delivery, payload) => payload.todoListId,
|
|
131
|
+
// A signed delivery from another system has no thread to answer on (#1630).
|
|
132
|
+
replyMode: InboundReplyMode.NONE,
|
|
133
|
+
scopeMode: InboundHandlerScopeMode.ORGANIZATION_REQUIRED,
|
|
134
|
+
// The tenant is whoever owns the named list — read from this application's data, never from the sender.
|
|
135
|
+
resolveScope: async (_delivery, payload, lookups) => {
|
|
136
|
+
const organizationId = await lookups.findOrganizationIdByField(TasksManager_ResourceType.TODO_LISTS, '_id', payload.todoListId);
|
|
137
|
+
return organizationId ? { kind: InboundResolvedScopeKind.ORGANIZATION, organizationId } : { kind: InboundResolvedScopeKind.UNROUTABLE };
|
|
138
|
+
},
|
|
139
|
+
actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
|
|
140
|
+
// Someone asking for a todo expects it within a minute, not within the default's three days: three
|
|
141
|
+
// attempts twenty seconds apart, then DEAD, and an organization administrator replays it once the
|
|
142
|
+
// cause (a deleted list, a revoked role) is fixed.
|
|
143
|
+
retry: { maxAttempts: 3, maxWindowSeconds: 60 * 60, backoff: { kind: InboundRetryBackoffKind.FIXED, baseSeconds: 20 } },
|
|
144
|
+
handle: async (ctx, payload) => {
|
|
145
|
+
// An archived list takes no new work. The attempt fails, and once someone reactivates the list an
|
|
146
|
+
// administrator replays the delivery from Settings → Inbound deliveries.
|
|
147
|
+
const list = await ctx.resources.read<TodoLists>(TasksManager_ResourceType.TODO_LISTS, payload.todoListId);
|
|
148
|
+
if (list?.status !== TodoLists_Status.ACTIVE) {
|
|
149
|
+
throw Object.assign(new Error('The todo list is not accepting new todos'), { name: 'TodoListNotAcceptingTodos' });
|
|
150
|
+
}
|
|
151
|
+
// A handler runs AT LEAST once: a crash after this create and before the delivery is settled runs it
|
|
152
|
+
// again. So the todo carries the delivery's id in `externalRef`, which is unique per organization, and
|
|
153
|
+
// the second attempt's create collides instead of adding a second todo. `externalRef` is the only
|
|
154
|
+
// unique field on a todo, so a CONFLICT here can only mean this delivery already created it.
|
|
155
|
+
try {
|
|
156
|
+
await ctx.resources.create(TasksManager_ResourceType.TODOS, {
|
|
157
|
+
todoListId: payload.todoListId,
|
|
158
|
+
title: payload.title,
|
|
159
|
+
externalRef: `inbound:${ctx.delivery.id}`,
|
|
160
|
+
// The schema-family discriminator: a `.default()` alone does not select a union branch.
|
|
161
|
+
recurringType: Todos_RecurrenceType.ONE_TIME,
|
|
162
|
+
...(payload.description !== undefined ? { description: payload.description } : {}),
|
|
163
|
+
});
|
|
164
|
+
} catch (error) {
|
|
165
|
+
if (isWildoBackendError(error) && error.type === ErrorType.CONFLICT) return;
|
|
166
|
+
throw error;
|
|
167
|
+
}
|
|
168
|
+
},
|
|
169
|
+
});
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
It is registered on the module with `inboundHandlers: [todoIntakeInboundHandler]` and mounted at
|
|
173
|
+
`POST /webhooks/app/todo-intake`.
|
|
174
|
+
|
|
175
|
+
An EMAIL channel handler for a firm whose clients send documents to its matters: it acts only on a
|
|
176
|
+
DMARC-aligned sender, recognises the firm's own clients as known contacts, links a new thread to a review
|
|
177
|
+
task it creates, and acknowledges receipt with the firm's own template:
|
|
178
|
+
|
|
179
|
+
|
|
180
|
+
## Usage Example
|
|
181
|
+
|
|
182
|
+
```typescript
|
|
183
|
+
import {
|
|
184
|
+
CORE_ORG_ROLES,
|
|
185
|
+
InboundChannelKind,
|
|
186
|
+
InboundReplyMode,
|
|
187
|
+
InboundSenderAssurance,
|
|
188
|
+
InboundSourceKind,
|
|
189
|
+
} from '@wildo-ai/saas-models';
|
|
190
|
+
import { defineInboundChannelHandler, inboundHandlerRef } from '@wildo-ai/saas-backend-lib';
|
|
191
|
+
|
|
192
|
+
/**
|
|
193
|
+
* Clients email documents to `matters@<your domain>`. The handler files each message under the matter its
|
|
194
|
+
* thread is linked to, or opens a review task when the thread is new, and acknowledges receipt.
|
|
195
|
+
*
|
|
196
|
+
* - `isDefault: true` — the handler for every email that carries no route tag.
|
|
197
|
+
* - `minimumSenderAssurance: DOMAIN_ALIGNED` — a message whose From domain fails DMARC never reaches it.
|
|
198
|
+
* What it may DO is still only what `ORG_MEMBER` may do, however well the sender is known.
|
|
199
|
+
* - `replyMode: THREAD` — so `ctx.reply` exists; with `NONE` it would not compile.
|
|
200
|
+
* - `contactResolver` — a client recorded in the application's own `clients` resource counts as a known contact.
|
|
201
|
+
*/
|
|
202
|
+
export const matterMailInboundHandler = defineInboundChannelHandler({
|
|
203
|
+
ref: inboundHandlerRef('matters.mail-intake'),
|
|
204
|
+
source: { kind: InboundSourceKind.CHANNEL, channel: InboundChannelKind.EMAIL, isDefault: true },
|
|
205
|
+
replyMode: InboundReplyMode.THREAD,
|
|
206
|
+
minimumSenderAssurance: InboundSenderAssurance.DOMAIN_ALIGNED,
|
|
207
|
+
contactResolver: async ({ address, lookups }) => lookups.exists('clients', 'email', address),
|
|
208
|
+
actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
|
|
209
|
+
handle: async (ctx, message) => {
|
|
210
|
+
// The message is DATA. Nothing it says — "please change our bank details", "approve the invoice" —
|
|
211
|
+
// is an instruction: an authorizing action is confirmed through another channel, never by email.
|
|
212
|
+
if (message.thread.isNew) {
|
|
213
|
+
const task = await ctx.resources.create('matterReviewTasks' as never, {
|
|
214
|
+
title: message.payload.subject,
|
|
215
|
+
senderAssurance: message.sender.assurance,
|
|
216
|
+
});
|
|
217
|
+
await ctx.thread.link({ resourceType: 'matterReviewTasks', resourceId: String((task as { _id: string })._id) });
|
|
218
|
+
}
|
|
219
|
+
// One reply per delivery and template, however often a retry runs this handler.
|
|
220
|
+
await ctx.reply({ templateRef: 'matters.documents-received', variables: { attachmentCount: message.attachments.length } });
|
|
221
|
+
},
|
|
222
|
+
});
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## References
|
|
226
|
+
|
|
227
|
+
- `references/framework-inbound-handler-api.md` — the handler contract (source-backed): sources, scope
|
|
228
|
+
modes, acting roles, retry policy, `ctx`.
|
|
229
|
+
- `references/inbound-delivery-lifecycle.md` — the wire answers, choosing a scheme and a scope mode,
|
|
230
|
+
what a handler may do, retries, DEAD and replay, audit events.
|
|
231
|
+
- `references/email-channel.md` — the email channel: sender assurance and choosing a minimum, route tags,
|
|
232
|
+
replying, threads and the linked record, why a message never authorizes a payment or an approval.
|
|
233
|
+
- `references/framework-inbound-channel-api.md` — the channel handler and conversation contracts
|
|
234
|
+
(source-backed).
|
|
235
|
+
- `references/receiving-email.md` — receiving: the four route kinds and which address reaches which
|
|
236
|
+
organization, configuring the provider and the shared domain, an organization's own domain (claim → TXT →
|
|
237
|
+
verify), client mailboxes on a firm's domain, the answer's From, what a stored message carries.
|
|
238
|
+
- `references/framework-inbound-email-api.md` — the receiving-email vocabularies, the domain verbs and the
|
|
239
|
+
`email.inbound` configuration (source-backed).
|
|
240
|
+
|
|
241
|
+
## Verification
|
|
242
|
+
|
|
243
|
+
- [ ] Every handler has a unique `ref` and its module lists it in `inboundHandlers`.
|
|
244
|
+
- [ ] A handler on `HMAC_SHA256_HEADER` declares `dedupKey`.
|
|
245
|
+
- [ ] `actingRoles` names only roles the handler's writes need, and never the super-administrator role.
|
|
246
|
+
- [ ] The backend starts (a misdeclared handler refuses startup and names the rule).
|
|
247
|
+
- [ ] `POST /webhooks/app/<endpointKey>` answers `401` to an unsigned body — not `404` (secret missing)
|
|
248
|
+
and not `200`.
|
|
249
|
+
- [ ] Each email channel has exactly one `isDefault: true` handler, and every handler declares `replyMode`
|
|
250
|
+
and a `minimumSenderAssurance` from the email ladder.
|
|
251
|
+
- [ ] No channel handler writes payment details, approvals or recipients from a message's content.
|
|
252
|
+
- [ ] With `EMAIL_INBOUND` enabled, `POST /api/v1/webhooks/<provider>/<endpoint>` answers `401` to an unsigned
|
|
253
|
+
body, and `email.inbound.sharedDomain` is set wherever organizations should receive mail with no setup.
|
|
254
|
+
|
|
255
|
+
### Grep invariants
|
|
256
|
+
|
|
257
|
+
- `rg "inboundHandlers:" backend-api/src/modules` — every handler file is registered somewhere.
|
|
258
|
+
- `rg "APP_ADMIN_SUPER_ADMIN" backend-api/src/modules/*/inbound` — must return nothing.
|
|
259
|
+
- `rg "HMAC_SHA256_HEADER" -l backend-api/src/modules/*/inbound | xargs rg -L "dedupKey"` — must return nothing.
|
|
260
|
+
- `rg -c "isDefault: true" backend-api/src/modules/*/inbound` — sums to one per channel.
|
|
261
|
+
- `rg -l "defineInboundChannelHandler" backend-api/src/modules | xargs rg -L "minimumSenderAssurance"` — must return nothing.
|
|
262
|
+
- `rg -n "message\.(text|strippedReply)" backend-api/src/modules/*/inbound` — every read of the body; none may
|
|
263
|
+
choose an organization, a record to write into, or a recipient.
|
|
264
|
+
|
|
265
|
+
## Common Rationalizations
|
|
266
|
+
|
|
267
|
+
| Rationalization | Reality |
|
|
268
|
+
|---|---|
|
|
269
|
+
| "I'll verify the signature myself in a controller." | A hand-written verifier is where an empty secret, an unsigned timestamp or a re-serialized body verifies a forgery. Declare a scheme; the engine owns verification. |
|
|
270
|
+
| "The provider retries, so I don't need dedup." | Retries are exactly why you need it: without the ledger each retry runs the handler again. Declare `dedupKey` when the scheme signs no id. |
|
|
271
|
+
| "I'll give the handler an admin role so it never gets refused." | The roles are its whole authority, in one organization. A broader role turns a forged-but-verified message into broad access. Declare what it writes. |
|
|
272
|
+
| "The payload says which organization it is for." | A signature proves who SENT it, not whose tenant it is: one secret serves the whole application. Resolve the organization from your own data bound to something the delivery names. |
|
|
273
|
+
| "The handler won't run twice, the delivery is deduplicated." | The delivery is STORED once; the handler runs at least once (a crash after your writes is retried). Make it idempotent per `ctx.delivery.id`. |
|
|
274
|
+
| "If the organization isn't found I'll put it in the application scope." | There is no fallback on purpose: the handler was written for a tenant. The delivery is `UNROUTABLE`, audited, and visible to the operator. |
|
|
275
|
+
| "The email came from the client's address, so it is the client." | The From line is typed by the sender. `DOMAIN_ALIGNED` proves the domain, not the person; even `THREAD_TOKEN_BOUND` proves only that someone holds the reply address. Set the minimum for what the handler does, and never let a message authorize a payment or an approval. |
|
|
276
|
+
| "A known contact can be trusted with more, so I'll widen the roles for them." | Assurance decides whether the handler runs, never what it may do: its roles are the same for every sender. A handler that needs more for some senders is two handlers with two minimums. |
|
|
277
|
+
| "I'll call the agent directly from the handler." | `ctx` has no actor call. Hand the delivery to a declared autonomous agent with `ctx.agents.startAutonomousTurn` — it runs under the principal the organization bound to that agent, is idempotent per delivery, and is offered only read or reviewer-gated tools (`flows-actors-autonomous-agents`). |
|
|
278
|
+
|
|
279
|
+
## Red Flags
|
|
280
|
+
|
|
281
|
+
- A handler file not listed in any module's `inboundHandlers` — catch with the first grep above.
|
|
282
|
+
- `APP_ADMIN_SUPER_ADMIN` in an inbound handler — catch with the second grep (startup refuses it too).
|
|
283
|
+
- An `HMAC_SHA256_HEADER` handler without `dedupKey` — catch with the third grep (startup refuses it too).
|
|
284
|
+
- `/webhooks/app/<key>` answering `404` in an environment that should receive it — the secret is unset;
|
|
285
|
+
the startup log names the variable.
|
|
286
|
+
|
|
287
|
+
- A channel handler at `UNVERIFIED` that writes records a client relies on — catch with the second
|
|
288
|
+
Verification item; raise the minimum or route the message to a review handler.
|
|
289
|
+
- Two `isDefault: true` handlers on one channel — catch with the fourth grep (startup refuses it too).
|
|
290
|
+
- A handler that reads the organization or the list from the message BODY — routing already chose the
|
|
291
|
+
organization from the envelope; read the route tag (`message.payload.routeTag`) and your own data. Catch
|
|
292
|
+
with the body-reads grep above.
|
|
293
|
+
|
|
294
|
+
## Related Skills
|
|
295
|
+
|
|
296
|
+
- `backend-addon-wiring` — the module registration the handler plugs into.
|
|
297
|
+
- `backend-custom-operation` — when the write a handler makes needs custom server-side logic.
|
|
298
|
+
- `settings-placement-authoring` — placing the Inbound deliveries settings destination.
|
|
299
|
+
- `flows-actors-a2a-exposure` — external AI agents, not webhooks.
|
|
300
|
+
- `email-add-template` — the templates a channel handler answers with.
|
|
301
|
+
- `flows-actors-autonomous-agents` — handing a message to an agent whose tool calls a person reviews.
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# The email channel — handlers for messages people send
|
|
2
|
+
|
|
3
|
+
Read this when work arrives by EMAIL: clients sending documents to a matter, customers writing to a
|
|
4
|
+
support address, a supplier answering a request your application sent. The endpoint handlers in
|
|
5
|
+
`inbound-delivery-lifecycle.md` are for signed messages from other SYSTEMS; an email channel handler is
|
|
6
|
+
for mail from PEOPLE, whose identity no signature proves.
|
|
7
|
+
|
|
8
|
+
## What the engine does, and what you decide
|
|
9
|
+
|
|
10
|
+
| The engine owns | You decide |
|
|
11
|
+
|---|---|
|
|
12
|
+
| Receiving the mail through the application's `EMAIL_INBOUND` provider, storing it once, retrying, replay | What a message CAUSES — the handler |
|
|
13
|
+
| Deriving how well the sender is known (`InboundSenderAssurance`) | The least assurance each handler acts on |
|
|
14
|
+
| Correlating a message into its conversation thread | Which record the thread is about (`ctx.thread.link`) |
|
|
15
|
+
| Reply addresses (secret, per recipient, revocable) and the threading headers | Whether a handler answers, and with which template |
|
|
16
|
+
| Scanning attachments and withholding infected ones | What to do with the files that were made available |
|
|
17
|
+
|
|
18
|
+
**Assurance never grants authority.** A handler runs with its declared `actingRoles` whatever the sender's
|
|
19
|
+
assurance. Assurance decides only whether the handler RUNS.
|
|
20
|
+
|
|
21
|
+
## Sender assurance, lowest to highest
|
|
22
|
+
|
|
23
|
+
| Level | What it means | What it does NOT mean |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| `UNVERIFIED` | Nothing about the sender is proven — the From domain failed or skipped DMARC. | Anything at all. The From line is what the sender typed. |
|
|
26
|
+
| `DOMAIN_ALIGNED` | DMARC passed with alignment: the From domain is authenticated. | That this PERSON sent it. Anyone with a mailbox on that domain could. |
|
|
27
|
+
| `KNOWN_CONTACT` | Aligned, and the address is an active member of the organization, or one your `contactResolver` recognises. | That the mailbox has not been taken over. |
|
|
28
|
+
| `THREAD_TOKEN_BOUND` | Aligned, sent to a live reply address, by the recipient that address was issued to. | That the reply address never leaked — it is a bearer secret. |
|
|
29
|
+
|
|
30
|
+
The levels are compared only within the email channel. A webhook's `SOURCE_SIGNED` is on another ladder
|
|
31
|
+
and is neither above nor below any of them.
|
|
32
|
+
|
|
33
|
+
A reply address used by a DIFFERENT sender than the one it was issued to does not bind: the message falls
|
|
34
|
+
back to its DMARC-derived level and the mismatch is audited (`INBOUND_REPLY_TOKEN_DOWNGRADED`).
|
|
35
|
+
|
|
36
|
+
## Choosing the minimum
|
|
37
|
+
|
|
38
|
+
- **`DOMAIN_ALIGNED` is the usual floor.** Below it the From line proves nothing, so a handler that files
|
|
39
|
+
under a client's matter would file whatever a stranger typed.
|
|
40
|
+
- **`KNOWN_CONTACT`** when the handler should act only for people the organization already deals with.
|
|
41
|
+
Give the handler a `contactResolver` that looks the address up in your own contacts resource; without one,
|
|
42
|
+
only organization members reach this level.
|
|
43
|
+
- **`THREAD_TOKEN_BOUND`** when a message must continue an exchange your application started — an answer to
|
|
44
|
+
a request you sent — and nothing else should reach the handler.
|
|
45
|
+
- **`UNVERIFIED`** only for a handler that treats everything as untrusted input: a triage inbox a person
|
|
46
|
+
reviews before anything happens.
|
|
47
|
+
|
|
48
|
+
A message below the minimum goes to the handler's `belowMinimumHandlerRef` when it declares one (a review
|
|
49
|
+
queue, typically), or is stored, audited `INBOUND_DELIVERY_BELOW_ASSURANCE` and dispatched to nobody.
|
|
50
|
+
Who sees it then is your application's decision.
|
|
51
|
+
|
|
52
|
+
## Choosing the handler: route tags
|
|
53
|
+
|
|
54
|
+
An address like `matters+billing@your-domain` carries the route tag `billing`. Each channel has exactly
|
|
55
|
+
one handler with `isDefault: true`, for messages with no tag or an unknown one; other handlers claim one
|
|
56
|
+
tag each. Two defaults, or two handlers on one tag, stop the backend at startup.
|
|
57
|
+
|
|
58
|
+
## Answering: reply mode
|
|
59
|
+
|
|
60
|
+
`replyMode` is required. `NONE` means the handler never answers, and `ctx.reply` does not exist on its
|
|
61
|
+
context. `THREAD` gives it `ctx.reply({ templateRef, variables })`:
|
|
62
|
+
|
|
63
|
+
- the reply goes out through your transactional email provider, on the thread the message arrived on,
|
|
64
|
+
with `Message-ID`, `In-Reply-To` and `References` set so the client's mail program files it in the same
|
|
65
|
+
conversation — no other header can be set;
|
|
66
|
+
- the template is yours: register it like any other email template (`email-add-template`);
|
|
67
|
+
- a handler that runs twice for one message (a retry) queues ONE reply per template.
|
|
68
|
+
|
|
69
|
+
## Threads and the linked record
|
|
70
|
+
|
|
71
|
+
Every message joins a conversation thread (`conversationThreads`, with its `conversationMessages`), one
|
|
72
|
+
per counterpart per exchange. A message joins an existing OPEN thread when it arrived on that thread's live
|
|
73
|
+
reply address, or names one of its messages in `In-Reply-To` / `References` — and then only when it comes
|
|
74
|
+
from the thread's counterpart, or from a colleague on the counterpart's domain who is a KNOWN_CONTACT (who
|
|
75
|
+
then takes the thread over). Anyone else, and any message below its handler's minimum, opens a new thread:
|
|
76
|
+
knowing a Message-ID and sharing a mail provider is not enough to write into a case. One residue to know: a
|
|
77
|
+
KNOWN_CONTACT counts as known to the ORGANIZATION, not to one case, so on a shared provider domain a contact
|
|
78
|
+
from one matter who knows a Message-ID of another client's thread could take it over. If your contacts span
|
|
79
|
+
clients on public mail domains, give the handler a `contactResolver` that answers only for contacts you are
|
|
80
|
+
willing to let continue any thread. `message.thread.isNew` tells the handler the message opened it. Call
|
|
81
|
+
`ctx.thread.link({ resourceType, resourceId })` to tie the thread to the record it is about; the handler
|
|
82
|
+
must be able to READ that record with its own roles, or the link is refused.
|
|
83
|
+
|
|
84
|
+
To show a record's conversations on its page, place `EmbedLinkedConversations` (from
|
|
85
|
+
`@wildo-ai/saas-frontend-lib`) in that resource's READ template or record composite view
|
|
86
|
+
(`views-add-custom-view`). It lists the threads linked to the record, newest first; each opens to its
|
|
87
|
+
messages, received and answered, and members of the organization can read it.
|
|
88
|
+
|
|
89
|
+
An organization administrator CLOSES a thread when the matter is finished. Closing revokes its reply
|
|
90
|
+
addresses; the thread is deleted after the application's `RESOURCE_DATA` retention period. Messages are
|
|
91
|
+
business correspondence and are kept for the `BUSINESS_RECORDS` period from the end of their calendar year,
|
|
92
|
+
whatever happens to the thread.
|
|
93
|
+
|
|
94
|
+
## Authorizing actions never come from a message
|
|
95
|
+
|
|
96
|
+
The mechanism above tells you how well the SENDER is known. It cannot tell you whether the sender's
|
|
97
|
+
mailbox belongs to the person you think, or whether they meant what the message says. So a handler never
|
|
98
|
+
performs an authorizing action on the strength of an email:
|
|
99
|
+
|
|
100
|
+
- **payment details** — a new bank account, a change of IBAN, "please pay this invoice to";
|
|
101
|
+
- **approvals and sign-offs** — accepting a quote, approving a document, releasing a hold;
|
|
102
|
+
- **new recipients** — adding a person who will receive documents or funds;
|
|
103
|
+
- **credentials and personal data** — resetting access, sending identity documents.
|
|
104
|
+
|
|
105
|
+
Record the request, and have a person confirm it through a channel your organization already trusts —
|
|
106
|
+
a call to a number you already hold, a signed-in session in your application. This is the standard
|
|
107
|
+
advice for business email compromise:
|
|
108
|
+
|
|
109
|
+
- the FBI's Internet Crime Complaint Center advises using secondary channels to verify requests to change
|
|
110
|
+
account information;
|
|
111
|
+
spec-cite: FBI IC3 Public Service Announcement I-091124-PSA (PSA240911), "Business Email Compromise: The
|
|
112
|
+
$55 Billion Scam", 11 September 2024 — the recommendations list.
|
|
113
|
+
- the Solicitors Regulation Authority reports email modification fraud as the most common cyber incident
|
|
114
|
+
reported to it (68 percent of reports) and describes firm policy requiring verbal confirmation of any
|
|
115
|
+
change of bank details given by email.
|
|
116
|
+
spec-cite: SRA, "How to reduce the risk of being affected by cybercrime" (cybersecurity advice), section
|
|
117
|
+
"Email modification fraud", including its case study.
|
|
118
|
+
|
|
119
|
+
If the handler hands the message to an autonomous agent (`ctx.agents.startAutonomousTurn`), the message
|
|
120
|
+
text is DATA for the agent, never instructions, and any side-effecting tool the agent proposes waits for
|
|
121
|
+
a reviewer (`flows-actors-autonomous-agents`).
|
|
122
|
+
|
|
123
|
+
## Audit events
|
|
124
|
+
|
|
125
|
+
| Event | When |
|
|
126
|
+
|---|---|
|
|
127
|
+
| `INBOUND_DELIVERY_ACCEPTED` | A message was admitted; carries the channel and the sender assurance. |
|
|
128
|
+
| `INBOUND_DELIVERY_BELOW_ASSURANCE` | A message was below its handler's minimum; says where it went. |
|
|
129
|
+
| `INBOUND_REPLY_SENT` / `INBOUND_REPLY_FAILED` | A reply was accepted by the provider, or finally failed. |
|
|
130
|
+
| `INBOUND_REPLY_TOKEN_REVOKED` | Reply addresses stopped binding (closed, counterpart changed, member removed, rotated). |
|
|
131
|
+
| `INBOUND_REPLY_TOKEN_DOWNGRADED` | A reply address was used by another sender than its recipient. |
|
|
132
|
+
|
|
133
|
+
None of them carries an address, a subject or a body.
|