@wildo-ai/framework-knowledge 1.1.5 → 1.1.6
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 +320 -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.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -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 +250 -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 +1238 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3191 -1126
- 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 +276 -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 +176 -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 +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -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 +29 -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 +5887 -1695
- 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,222 @@
|
|
|
1
|
+
# Framework receiving-email API (source-backed)
|
|
2
|
+
|
|
3
|
+
The contracts behind RECEIVING email: where a message lands, which address reaches which organization, and
|
|
4
|
+
how an organization adds its own domain. Read when you configure receiving, add the domain setup to an
|
|
5
|
+
application, or read a stored message.
|
|
6
|
+
|
|
7
|
+
- The message statuses, the four route kinds, the domain statuses, the sending-domain policy, raw-MIME
|
|
8
|
+
retention, the limits and why an attachment was withheld:
|
|
9
|
+
|
|
10
|
+
## Import Origins
|
|
11
|
+
|
|
12
|
+
- `@wildo-ai/saas-models`
|
|
13
|
+
|
|
14
|
+
## Source Excerpts
|
|
15
|
+
|
|
16
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
17
|
+
|
|
18
|
+
```typescript
|
|
19
|
+
/**
|
|
20
|
+
* What became of a received message. The message's disposition only; the handler's run is the delivery's.
|
|
21
|
+
*/
|
|
22
|
+
export enum InboundEmailStatus {
|
|
23
|
+
/** Stored; at least one attachment has no scan verdict yet. Nothing reaches a handler before every one has one. */
|
|
24
|
+
AWAITING_ATTACHMENT_SCAN = 'awaiting_attachment_scan',
|
|
25
|
+
/** Handed to its channel handler through a stored delivery. */
|
|
26
|
+
DISPATCHED = 'dispatched',
|
|
27
|
+
/**
|
|
28
|
+
* The sender is below the selected handler's minimum assurance and no below-minimum handler is declared.
|
|
29
|
+
* Kept — it is correspondence — audited, and dispatched to nobody. Who sees it is the application's choice.
|
|
30
|
+
*/
|
|
31
|
+
STORED_BELOW_MINIMUM = 'stored_below_minimum',
|
|
32
|
+
/** Over a limit (see {@link InboundEmailLimit}). Only the envelope is kept: no bodies, no attachments. */
|
|
33
|
+
REJECTED_LIMIT = 'rejected_limit',
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** How an address reached its organization, in the order routing tries them. */
|
|
37
|
+
export enum InboundRouteKind {
|
|
38
|
+
/** `{local}+r-{token}@{domain}` — a reply to a thread. The token's organization must be the routed one. */
|
|
39
|
+
REPLY_TOKEN = 'reply_token',
|
|
40
|
+
/** An exact client mailbox on a firm's verified domain, under an ACTIVE service-provider relationship. */
|
|
41
|
+
CLIENT_MAILBOX = 'client_mailbox',
|
|
42
|
+
/** Any address on a VERIFIED receiving domain of the organization; `local+tag` passes `tag`. */
|
|
43
|
+
ORGANIZATION_DOMAIN = 'organization_domain',
|
|
44
|
+
/** `{slug}[+tag]@{sharedDomain}` — the zero-configuration default every organization has. */
|
|
45
|
+
SHARED_DOMAIN = 'shared_domain',
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/** Where an organization's claimed domain stands. Only VERIFIED routes and sends. */
|
|
49
|
+
export enum OrganizationEmailDomainStatus {
|
|
50
|
+
/** Claimed; the DNS TXT ownership challenge is not answered yet. Blocks nobody — several organizations may be here at once. */
|
|
51
|
+
OWNERSHIP_PENDING = 'ownership_pending',
|
|
52
|
+
/** Ownership proven, the domain exists at the provider, and its DNS records are not verified there yet. */
|
|
53
|
+
PROVIDER_PENDING = 'provider_pending',
|
|
54
|
+
/** Ownership proven and the provider verified its records: the domain routes (receiving) and sends (sending). */
|
|
55
|
+
VERIFIED = 'verified',
|
|
56
|
+
/** The provider could not verify the records. Fix the DNS and verify again. */
|
|
57
|
+
FAILED = 'failed',
|
|
58
|
+
/** Was verified; the ownership record or the provider's records disappeared. Routing and sending stop. */
|
|
59
|
+
SUSPENDED = 'suspended',
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Whether an organization's verified SENDING domain is used beyond thread replies. Applies application-wide.
|
|
64
|
+
* The default keeps the application's own sender on every message the application did not route through a thread.
|
|
65
|
+
*/
|
|
66
|
+
export enum OrganizationSendingDomainUse {
|
|
67
|
+
/** Only replies on a thread go out from the organization's domain. */
|
|
68
|
+
THREAD_REPLIES = 'thread_replies',
|
|
69
|
+
/** Every email sent on behalf of the organization goes out from its verified sending domain. */
|
|
70
|
+
ALL_ORGANIZATION_MAIL = 'all_organization_mail',
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* Whether the original bytes of a received message are kept. Default `KEEP`: DKIM verifies over the original
|
|
75
|
+
* bytes only (RFC 6376 §3.7), so parsed text can never be re-verified, and commercial law asks for received
|
|
76
|
+
* letters to be reproducible as received.
|
|
77
|
+
*
|
|
78
|
+
* spec-cite: RFC 6376 §3.7 (the body hash and signature are computed over the canonicalized ORIGINAL message).
|
|
79
|
+
*/
|
|
80
|
+
export enum InboundEmailRawRetention {
|
|
81
|
+
KEEP = 'keep',
|
|
82
|
+
DISCARD = 'discard',
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** Which limit a `REJECTED_LIMIT` message exceeded. */
|
|
86
|
+
export enum InboundEmailLimit {
|
|
87
|
+
/** The whole message is larger than the application's configured maximum. */
|
|
88
|
+
MESSAGE_SIZE = 'message_size',
|
|
89
|
+
/** More attachments than {@link INBOUND_EMAIL_MAX_ATTACHMENTS}. */
|
|
90
|
+
ATTACHMENT_COUNT = 'attachment_count',
|
|
91
|
+
/** One attachment is larger than the application's maximum file size. */
|
|
92
|
+
ATTACHMENT_SIZE = 'attachment_size',
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
/** Why an attachment was not made available to the handler. The message itself still reaches it. */
|
|
96
|
+
export enum InboundEmailWithheldReason {
|
|
97
|
+
/** The scanner found malware. The file is quarantined and never served. */
|
|
98
|
+
INFECTED = 'infected',
|
|
99
|
+
/** The scan could not run or did not conclude. Not proven clean, so not exposed. */
|
|
100
|
+
SCAN_FAILED = 'scan_failed',
|
|
101
|
+
}
|
|
102
|
+
|
|
103
|
+
/** Why a verified domain stopped routing and sending. */
|
|
104
|
+
export enum OrganizationEmailDomainSuspensionReason {
|
|
105
|
+
/** The organization's ownership TXT record is no longer published. */
|
|
106
|
+
OWNERSHIP_RECORD_MISSING = 'ownership_record_missing',
|
|
107
|
+
/** The provider no longer finds the domain's records (or the domain itself). */
|
|
108
|
+
PROVIDER_RECORDS_MISSING = 'provider_records_missing',
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** What removed a domain — both delete the provider's domain (E9). */
|
|
112
|
+
export enum OrganizationEmailDomainRemovalTrigger {
|
|
113
|
+
/** An organization administrator removed it. */
|
|
114
|
+
REMOVE = 'remove',
|
|
115
|
+
/** The organization was deleted. */
|
|
116
|
+
ORGANIZATION_DELETED = 'organization_deleted',
|
|
117
|
+
}
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
- The organization email domain verbs (`claim`, `verify_ownership`, `verify`, `remove`) with their request and
|
|
121
|
+
response shapes, the ownership TXT record, the client mailbox request, and the application's `email.inbound`
|
|
122
|
+
configuration:
|
|
123
|
+
|
|
124
|
+
## Import Origins
|
|
125
|
+
|
|
126
|
+
- `@wildo-ai/saas-models`
|
|
127
|
+
|
|
128
|
+
## Source Excerpts
|
|
129
|
+
|
|
130
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
131
|
+
|
|
132
|
+
```typescript
|
|
133
|
+
/** The verbs of `organizationEmailDomains`, each audited. */
|
|
134
|
+
export enum OrganizationEmailDomains_Operations {
|
|
135
|
+
/** Mint the organization's DNS TXT ownership challenge. Creates nothing at the provider. */
|
|
136
|
+
CLAIM = 'claim',
|
|
137
|
+
/** Resolve the TXT record; the first organization to prove ownership wins, and only then is the domain created at the provider. */
|
|
138
|
+
VERIFY_OWNERSHIP = 'verify_ownership',
|
|
139
|
+
/** Ask the provider to verify the domain's records. */
|
|
140
|
+
VERIFY = 'verify',
|
|
141
|
+
/** Delete the domain at the provider, and the row. */
|
|
142
|
+
REMOVE = 'remove',
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/** A claim: the domain and what it will be used for. */
|
|
146
|
+
export const OrganizationEmailDomainClaimRequestSchema = z.object({
|
|
147
|
+
domain: z.string()
|
|
148
|
+
.min(4)
|
|
149
|
+
.max(253)
|
|
150
|
+
.regex(/^(?!-)[A-Za-z0-9-]{1,63}(?<!-)(\.(?!-)[A-Za-z0-9-]{1,63}(?<!-))+$/, 'Provide a DNS hostname with at least two labels, e.g. "inbox.firm.com".')
|
|
151
|
+
.describe('The domain to claim, e.g. `inbox.firm.com`.'),
|
|
152
|
+
capabilities: EmailDomainCapabilitiesSchema.default({ sending: true, receiving: true })
|
|
153
|
+
.describe('Whether the organization will send from it, receive on it, or both.'),
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
export type OrganizationEmailDomainClaimRequest = z.infer<typeof OrganizationEmailDomainClaimRequestSchema>;
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* What `claim` answers: the claim, and the ONE time the ownership record's value is shown. Only its hash is
|
|
160
|
+
* stored, so claiming again is how a lost value is recovered — and it replaces the old one.
|
|
161
|
+
*/
|
|
162
|
+
export const OrganizationEmailDomainClaimResponseSchema = z.object({
|
|
163
|
+
organizationEmailDomainId: z.string().describe('The claim.'),
|
|
164
|
+
domain: z.string().describe('The domain claimed.'),
|
|
165
|
+
status: z.enum(OrganizationEmailDomainStatus).describe('OWNERSHIP_PENDING until the record is found.'),
|
|
166
|
+
txtName: z.string().describe('The DNS name to publish the TXT record on.'),
|
|
167
|
+
// `.isEphemeral()`: the frontend reveals it once, in the dialog that must be acknowledged (the SSO domain claim's contract).
|
|
168
|
+
txtValue: z.string().isEphemeral().describe('The TXT record value to publish. Shown once.'),
|
|
169
|
+
});
|
|
170
|
+
|
|
171
|
+
export type OrganizationEmailDomainClaimResponse = z.infer<typeof OrganizationEmailDomainClaimResponseSchema>;
|
|
172
|
+
|
|
173
|
+
/** What `remove` answers: which domain went, and whether the provider still held it and deleted it. */
|
|
174
|
+
export const OrganizationEmailDomainRemoveResponseSchema = z.object({
|
|
175
|
+
organizationEmailDomainId: z.string().describe('The removed domain.'),
|
|
176
|
+
domain: z.string().describe('The domain name.'),
|
|
177
|
+
providerDomainDeleted: z.boolean().describe('Whether the domain existed at the email provider and was deleted there.'),
|
|
178
|
+
});
|
|
179
|
+
|
|
180
|
+
export type OrganizationEmailDomainRemoveResponse = z.infer<typeof OrganizationEmailDomainRemoveResponseSchema>;
|
|
181
|
+
|
|
182
|
+
/** The prefix of an email domain ownership record's value; the nonce follows it. */
|
|
183
|
+
export const EMAIL_DOMAIN_OWNERSHIP_TXT_PREFIX = 'wildo-email-domain-verification=';
|
|
184
|
+
/** The label the ownership record is published under: `_wildo-verification.{domain}` (the SSO challenge's name). */
|
|
185
|
+
export const EMAIL_DOMAIN_OWNERSHIP_TXT_LABEL = '_wildo-verification';
|
|
186
|
+
|
|
187
|
+
/** A client mailbox, as a firm or a client administrator asks for it. */
|
|
188
|
+
export const ClientMailboxCreateRequestSchema = z.object({
|
|
189
|
+
address: z.string().min(3).max(320).describe('The mailbox address, e.g. `acme@inbox.firm.com`.'),
|
|
190
|
+
emailDomainId: z.string().min(1).describe('This organization\'s verified receiving domain the address is on.'),
|
|
191
|
+
serviceProviderRelationshipId: z.string().min(1).describe('The ACTIVE relationship in which this organization serves the client.'),
|
|
192
|
+
});
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* An application's receiving-email settings (`email.inbound` in the backend configuration). Every field has a
|
|
196
|
+
* safe default, and the section is optional: an application that receives no email declares nothing.
|
|
197
|
+
*/
|
|
198
|
+
export const InboundEmailConfigSchema = z.object({
|
|
199
|
+
/**
|
|
200
|
+
* The application's SHARED receiving domain — every organization's zero-configuration address is
|
|
201
|
+
* `{slug}@{sharedDomain}`. Its MX points at the receiving provider. Absent, the shared address does not exist
|
|
202
|
+
* and only organization domains and client mailboxes route.
|
|
203
|
+
*/
|
|
204
|
+
sharedDomain: z.string()
|
|
205
|
+
.min(4)
|
|
206
|
+
.max(253)
|
|
207
|
+
.regex(/^(?!-)[a-z0-9-]{1,63}(?<!-)(\.(?!-)[a-z0-9-]{1,63}(?<!-))+$/, 'A lower-case DNS hostname, e.g. "in.example.com".')
|
|
208
|
+
.optional()
|
|
209
|
+
.describe('The shared receiving domain: every organization is reachable at {slug}@{sharedDomain}.'),
|
|
210
|
+
/** Keep the original bytes of every received message (default), or discard them. */
|
|
211
|
+
rawMimeRetention: z.enum(InboundEmailRawRetention).default(InboundEmailRawRetention.KEEP)
|
|
212
|
+
.describe('Whether the original message bytes are kept; kept by default, because only they can be re-verified.'),
|
|
213
|
+
/** Whether an organization's verified sending domain is used for all its mail, or for thread replies only (default). */
|
|
214
|
+
organizationSendingDomainUse: z.enum(OrganizationSendingDomainUse).default(OrganizationSendingDomainUse.THREAD_REPLIES)
|
|
215
|
+
.describe('Where an organization\'s verified sending domain is used as the sender.'),
|
|
216
|
+
/** The largest message accepted whole; a larger one is kept as its envelope only (REJECTED_LIMIT). */
|
|
217
|
+
maxMessageSizeBytes: z.number().int().positive().max(100 * 1024 * 1024).default(INBOUND_EMAIL_DEFAULT_MAX_MESSAGE_BYTES)
|
|
218
|
+
.describe('The largest message accepted whole, in bytes.'),
|
|
219
|
+
});
|
|
220
|
+
|
|
221
|
+
export type InboundEmailConfig = z.infer<typeof InboundEmailConfigSchema>;
|
|
222
|
+
```
|
|
@@ -0,0 +1,231 @@
|
|
|
1
|
+
# Inbound handler contract (source-backed)
|
|
2
|
+
|
|
3
|
+
The exact types an application uses to declare an inbound handler: `defineInboundHandler`,
|
|
4
|
+
`inboundHandlerRef`, the two source kinds, the scope modes, `actingRoles`, the retry policy and the
|
|
5
|
+
`ctx` a handler receives. Imported from `@wildo-ai/saas-backend-lib`; the named vocabularies
|
|
6
|
+
(`InboundSourceKind`, `InboundHandlerScopeMode`, `InboundResolvedScopeKind`,
|
|
7
|
+
`InboundVerificationScheme`, `HmacSignatureEncoding`, `InboundRetryBackoffKind`) from
|
|
8
|
+
`@wildo-ai/saas-models`.
|
|
9
|
+
|
|
10
|
+
Read this when:
|
|
11
|
+
|
|
12
|
+
- you are writing a handler and need the exact field names and types;
|
|
13
|
+
- a startup refusal names a rule (`requires resolveScope`, `must declare dedupKey`, `actingRoles…`);
|
|
14
|
+
- you need to know what `ctx.resources` offers (the only way a handler acts).
|
|
15
|
+
|
|
16
|
+
## Import Origins
|
|
17
|
+
|
|
18
|
+
- `@wildo-ai/saas-backend-lib`
|
|
19
|
+
|
|
20
|
+
## Source Excerpts
|
|
21
|
+
|
|
22
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
23
|
+
|
|
24
|
+
```typescript
|
|
25
|
+
declare const inboundHandlerRefBrand: unique symbol;
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* A handler's stable identity. Branded so a declaration and anything that addresses the handler (the
|
|
29
|
+
* stored delivery's `handlerRef`, the audit trail) share ONE typed value rather than two strings that
|
|
30
|
+
* can drift apart. Build it with {@link inboundHandlerRef}.
|
|
31
|
+
*/
|
|
32
|
+
export type InboundHandlerRef = string & { readonly [inboundHandlerRefBrand]: true };
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Mint a handler ref: lower-case, dot-separated segments (`todos.intake`, `crm.contact-sync`).
|
|
37
|
+
* Throws on anything else, at module load, where the author sees it.
|
|
38
|
+
*/
|
|
39
|
+
export function inboundHandlerRef(ref: string): InboundHandlerRef {
|
|
40
|
+
if (!INBOUND_HANDLER_REF_PATTERN.test(ref)) {
|
|
41
|
+
throw new Error(`inboundHandlerRef('${ref}'): a handler ref is lower-case, dot-separated segments of [a-z0-9-], e.g. 'todos.intake'.`);
|
|
42
|
+
}
|
|
43
|
+
return ref as InboundHandlerRef;
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* A provider-declared endpoint (`POST /webhooks/{providerRef}/{endpointKey}`). The provider's own
|
|
48
|
+
* registered adapter verifies it; the handler takes over dispatch from the provider's capability path.
|
|
49
|
+
*/
|
|
50
|
+
export interface InboundProviderEndpointSource {
|
|
51
|
+
readonly kind: InboundSourceKind.PROVIDER_ENDPOINT;
|
|
52
|
+
readonly providerRef: string;
|
|
53
|
+
readonly endpointKey: string;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/**
|
|
57
|
+
* An endpoint the APPLICATION declares, mounted at `POST /webhooks/app/{endpointKey}` and verified by
|
|
58
|
+
* an engine-owned scheme.
|
|
59
|
+
*/
|
|
60
|
+
export interface InboundApplicationEndpointSource {
|
|
61
|
+
readonly kind: InboundSourceKind.APPLICATION_ENDPOINT;
|
|
62
|
+
/** URL segment: lower-case letters, digits and hyphens. */
|
|
63
|
+
readonly endpointKey: string;
|
|
64
|
+
readonly verification: InboundVerificationConfig;
|
|
65
|
+
/**
|
|
66
|
+
* The event types this handler takes, read from the JSON body at {@link eventTypePath}. Several
|
|
67
|
+
* handlers may share one endpoint only by declaring DISJOINT event types; an event no handler
|
|
68
|
+
* declares is acknowledged and not stored.
|
|
69
|
+
*/
|
|
70
|
+
readonly eventTypes?: readonly string[];
|
|
71
|
+
/** Dot-path of the event type in the JSON body. Defaults to `type`. */
|
|
72
|
+
readonly eventTypePath?: string;
|
|
73
|
+
/** Body cap in bytes; defaults to 256 KB. Applies to this endpoint only. */
|
|
74
|
+
readonly maxBodyBytes?: number;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export type InboundSource = InboundProviderEndpointSource | InboundApplicationEndpointSource;
|
|
78
|
+
|
|
79
|
+
/** A delivery after verification, as the engine hands it to a handler's declared functions. */
|
|
80
|
+
export interface VerifiedInboundDelivery {
|
|
81
|
+
readonly sourceKind: InboundSourceKind;
|
|
82
|
+
/** `{providerRef}:{endpointKey}`, with `app` as the provider ref of an application endpoint. */
|
|
83
|
+
readonly sourceKey: string;
|
|
84
|
+
/** The id the sender signed, when its scheme carries one. */
|
|
85
|
+
readonly providerDeliveryId?: string;
|
|
86
|
+
readonly signedAt?: Date;
|
|
87
|
+
readonly receivedAt: Date;
|
|
88
|
+
readonly rawBody: Buffer;
|
|
89
|
+
/** Lower-cased names; only the headers the engine keeps. */
|
|
90
|
+
readonly headers: Readonly<Record<string, string>>;
|
|
91
|
+
readonly eventType?: string;
|
|
92
|
+
/** The parsed JSON body, before the handler's payload schema. */
|
|
93
|
+
readonly json: unknown;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** What a handler's `resolveScope` may answer. There is no default and no fallback. */
|
|
97
|
+
export type InboundResolvedScope =
|
|
98
|
+
| { readonly kind: InboundResolvedScopeKind.ORGANIZATION; readonly organizationId: string }
|
|
99
|
+
| { readonly kind: InboundResolvedScopeKind.APPLICATION }
|
|
100
|
+
/** One person's own data (#1629). Admitted only to a `RESOLVED_PER_DELIVERY` handler that declares `actingRoles.user`. */
|
|
101
|
+
| { readonly kind: InboundResolvedScopeKind.USER; readonly userId: string }
|
|
102
|
+
| { readonly kind: InboundResolvedScopeKind.UNROUTABLE };
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* Read-only lookups a resolver may use to find the organization a message belongs to. They run under
|
|
106
|
+
* the engine's own routing authority, BEFORE any handler authority exists, and answer only an id.
|
|
107
|
+
*/
|
|
108
|
+
export interface InboundScopeLookups {
|
|
109
|
+
/**
|
|
110
|
+
* The `organizationId` of the first row of `resourceType` whose `field` equals `value`, or `null`.
|
|
111
|
+
* `resourceType` must be ORGANIZATIONS-scoped (an application-scoped row names no organization).
|
|
112
|
+
*/
|
|
113
|
+
findOrganizationIdByField(resourceType: ResourceType, field: string, value: string): Promise<string | null>;
|
|
114
|
+
/**
|
|
115
|
+
* The `userId` of the row of `resourceType` whose `field` equals `value`, or `null` (#1629). `resourceType`
|
|
116
|
+
* must be a personal (`USER_SELF`-scoped) resource. A value found on rows of two different people answers
|
|
117
|
+
* `null`: it names no one person.
|
|
118
|
+
*/
|
|
119
|
+
findUserIdByField(resourceType: ResourceType, field: string, value: string): Promise<string | null>;
|
|
120
|
+
}
|
|
121
|
+
|
|
122
|
+
/**
|
|
123
|
+
* The roles a handler acts with, per scope. Role names are resolved against the role table of the
|
|
124
|
+
* scope they sit in, so an organization delivery uses `organization` and an application delivery
|
|
125
|
+
* `application`. An `ORGANIZATION_REQUIRED` or `APPLICATION` handler must declare roles for its scope; a
|
|
126
|
+
* `RESOLVED_PER_DELIVERY` handler is admitted to exactly the scopes it declares roles for. Never the
|
|
127
|
+
* super-administrator role, and never a handler-only role (`INBOUND_HANDLER_ONLY_ROLES`), which the engine
|
|
128
|
+
* reserves for its own handlers.
|
|
129
|
+
*/
|
|
130
|
+
export interface InboundHandlerActingRoles {
|
|
131
|
+
readonly organization?: readonly string[];
|
|
132
|
+
readonly application?: readonly string[];
|
|
133
|
+
/**
|
|
134
|
+
* Roles on a USER-scope delivery — one person's own data (#1629). APPLICATION role names, because personal
|
|
135
|
+
* (`USER_SELF`) resources gate on application roles; the ownership check confines them to that one person.
|
|
136
|
+
* Only a `RESOLVED_PER_DELIVERY` handler may declare them.
|
|
137
|
+
*/
|
|
138
|
+
readonly user?: readonly string[];
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
export interface InboundRetryPolicy {
|
|
142
|
+
/** Attempts in total, including the first. */
|
|
143
|
+
readonly maxAttempts: number;
|
|
144
|
+
/** Past this many seconds after receipt the delivery is `DEAD`, whatever attempts remain. */
|
|
145
|
+
readonly maxWindowSeconds: number;
|
|
146
|
+
readonly backoff: {
|
|
147
|
+
readonly kind: InboundRetryBackoffKind;
|
|
148
|
+
readonly baseSeconds: number;
|
|
149
|
+
/** Cap for `EXPONENTIAL`. */
|
|
150
|
+
readonly maxSeconds?: number;
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/**
|
|
155
|
+
* Resource operations as the HANDLER. Every call is authorized exactly as the same operation reached
|
|
156
|
+
* over HTTP by a principal holding the handler's roles in the delivery's scope: the operation's role
|
|
157
|
+
* ACL, the parent-scope check, organization-unit narrowing, scope-root confinement and the tenant
|
|
158
|
+
* filter all apply. A write outside the delivery's organization is refused.
|
|
159
|
+
*/
|
|
160
|
+
export interface InboundHandlerResources {
|
|
161
|
+
create<T = unknown>(resourceType: ResourceType, data: unknown): Promise<T>;
|
|
162
|
+
read<T = unknown>(resourceType: ResourceType, id: string): Promise<T | null>;
|
|
163
|
+
list<T = unknown>(resourceType: ResourceType, filter?: Record<string, unknown>, pagination?: Partial<Resources_PaginationRequest>): Promise<T[] | Resources_PaginatedResult<T>>;
|
|
164
|
+
update<T = unknown>(resourceType: ResourceType, id: string, data: unknown): Promise<T | null>;
|
|
165
|
+
delete(resourceType: ResourceType, id: string): Promise<string>;
|
|
166
|
+
executeCustomOperation<T = unknown>(resourceType: ResourceType, operation: string, id?: string, data?: unknown): Promise<T>;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/** What `handle()` receives beside the payload. */
|
|
170
|
+
export interface InboundHandlerContext {
|
|
171
|
+
readonly delivery: {
|
|
172
|
+
readonly id: string;
|
|
173
|
+
readonly handlerRef: InboundHandlerRef;
|
|
174
|
+
readonly sourceKey: string;
|
|
175
|
+
readonly receivedAt: Date;
|
|
176
|
+
readonly providerDeliveryId?: string;
|
|
177
|
+
/** 1 on the first attempt of the current retry budget — so 1 again on the first attempt after a replay. */
|
|
178
|
+
readonly attempt: number;
|
|
179
|
+
readonly scope: Exclude<InboundResolvedScope, { readonly kind: InboundResolvedScopeKind.UNROUTABLE }>;
|
|
180
|
+
};
|
|
181
|
+
/**
|
|
182
|
+
* How a handler acts itself: resource operations, authorized exactly as for an HTTP caller holding
|
|
183
|
+
* the handler's roles, and limited to `API_CALL` operations.
|
|
184
|
+
*
|
|
185
|
+
* A handler runs AT LEAST once per stored delivery (a crash between its writes and the settle, or a
|
|
186
|
+
* throw after some writes, is retried), so make it idempotent per `delivery.id`.
|
|
187
|
+
*/
|
|
188
|
+
readonly resources: InboundHandlerResources;
|
|
189
|
+
/**
|
|
190
|
+
* How a handler hands a delivery to an AGENT (#1611): through the autonomous entry point, never an actor
|
|
191
|
+
* call of its own. The turn runs under the machine principal the delivery's organization bound to that
|
|
192
|
+
* agent, is idempotent per delivery, and is offered only reading or reviewer-gated tools. See
|
|
193
|
+
* `InboundHandlerAgents`.
|
|
194
|
+
*/
|
|
195
|
+
readonly agents: InboundHandlerAgents;
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/** One declared inbound handler. Build it with {@link defineInboundHandler} so `P` is inferred. */
|
|
199
|
+
export interface InboundHandlerDefinition<P = unknown> {
|
|
200
|
+
readonly ref: InboundHandlerRef;
|
|
201
|
+
readonly source: InboundSource;
|
|
202
|
+
/**
|
|
203
|
+
* Whether the handler answers (#1630) — required on every handler, with no default. An endpoint
|
|
204
|
+
* handler cannot: a signed delivery from another system has no thread to answer on, so the only value
|
|
205
|
+
* this type admits is `NONE`. A handler that answers is a CHANNEL handler (`defineInboundChannelHandler`).
|
|
206
|
+
*/
|
|
207
|
+
readonly replyMode: InboundReplyMode.NONE;
|
|
208
|
+
/** Applied to the parsed JSON body after verification; a refusal is `INBOUND_DELIVERY_REJECTED` (malformed). */
|
|
209
|
+
readonly payloadSchema: ZodType<P>;
|
|
210
|
+
/**
|
|
211
|
+
* The dedup key when the source's scheme carries no delivery id (`HMAC_SHA256_HEADER`). Startup
|
|
212
|
+
* refuses a handler that has neither. Deliberately no body-hash default: two legitimate identical
|
|
213
|
+
* events would collapse into one.
|
|
214
|
+
*/
|
|
215
|
+
readonly dedupKey?: (delivery: VerifiedInboundDelivery) => string;
|
|
216
|
+
/** Deliveries sharing a non-null key run one at a time, in receive order. */
|
|
217
|
+
readonly orderingKey?: (delivery: VerifiedInboundDelivery, payload: P) => string | null;
|
|
218
|
+
readonly scopeMode: InboundHandlerScopeMode;
|
|
219
|
+
/** Required for `ORGANIZATION_REQUIRED` and `RESOLVED_PER_DELIVERY`; refused for `APPLICATION`. */
|
|
220
|
+
readonly resolveScope?: (delivery: VerifiedInboundDelivery, payload: P, lookups: InboundScopeLookups) => Promise<InboundResolvedScope>;
|
|
221
|
+
/** The handler's whole authority. */
|
|
222
|
+
readonly actingRoles: InboundHandlerActingRoles;
|
|
223
|
+
readonly retry?: InboundRetryPolicy;
|
|
224
|
+
handle(ctx: InboundHandlerContext, payload: P): Promise<void>;
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
/** Identity function that infers `P` from `payloadSchema`. */
|
|
228
|
+
export function defineInboundHandler<P>(definition: InboundHandlerDefinition<P>): InboundHandlerDefinition<P> {
|
|
229
|
+
return definition;
|
|
230
|
+
}
|
|
231
|
+
```
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
# Inbound delivery lifecycle — verification, dedup, scope, retries, replay
|
|
2
|
+
|
|
3
|
+
A decision aid. For the exact types, read `framework-inbound-handler-api.md`.
|
|
4
|
+
|
|
5
|
+
## What the engine does between the wire and `handle()`
|
|
6
|
+
|
|
7
|
+
| step | what happens | answer to the sender |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| media type | only `application/json` | `415` otherwise |
|
|
10
|
+
| size | the ENDPOINT's `maxBodyBytes` (default 256 KB) | `413` over it |
|
|
11
|
+
| secret | `WILDO_INBOUND_<ENDPOINT_KEY>__SECRET`, derived from the endpoint key; unset ⇒ refused (and, at boot, the route is not mounted) | `401` |
|
|
12
|
+
| verify | the declared scheme, over the exact received bytes | `401` (bad signature or stale timestamp) |
|
|
13
|
+
| event type | read at `eventTypePath` (default `type`); no handler declares it ⇒ ignored, not stored | `200` |
|
|
14
|
+
| payload | the handler's `payloadSchema` | `400` if it refuses |
|
|
15
|
+
| dedup | `(sourceKey, dedupKey)`; a second copy runs nothing | `200` |
|
|
16
|
+
| scope | the handler's `scopeMode`; never a fallback | `200` (stored `UNROUTABLE` if nothing admissible) |
|
|
17
|
+
| store + enqueue | a durable row, then a dispatch job | `200` |
|
|
18
|
+
|
|
19
|
+
Every refusal is audited as `INBOUND_DELIVERY_REJECTED` with the reason — aggregated to one row per source
|
|
20
|
+
and reason per minute. Every row carries `refusalCount`, the refusals it records: the first of a minute
|
|
21
|
+
is written at once, the ones folded after it when the minute closes. Sum `refusalCount` to count
|
|
22
|
+
refusals; only the minute open when the backend stops can lose its count. The handler runs later,
|
|
23
|
+
in a worker, never inside the request.
|
|
24
|
+
|
|
25
|
+
## Who the sender is — and who it is not
|
|
26
|
+
|
|
27
|
+
An application endpoint has ONE secret. A valid signature proves the delivery came from whoever holds that
|
|
28
|
+
secret; it says nothing about which of your tenants the delivery is for. So never take the organization
|
|
29
|
+
from a field the sender wrote. Resolve it from YOUR data, bound to something the delivery names: the
|
|
30
|
+
organization that owns the record it refers to (`lookups.findOrganizationIdByField`), or an external id
|
|
31
|
+
registered to exactly one organization. A sender holding the secret can still address any record whose id
|
|
32
|
+
it knows; a sender that must be confined to one tenant needs a per-tenant source.
|
|
33
|
+
|
|
34
|
+
## Choosing the scheme
|
|
35
|
+
|
|
36
|
+
| sender | scheme | dedup key |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| Svix-based senders (Resend, and anything following Standard Webhooks) | `SVIX_V1` | the signed `svix-id` — nothing to declare |
|
|
39
|
+
| A sender that HMAC-signs the body in one header (`x-hub-signature-256`-style) | `HMAC_SHA256_HEADER` with `signatureHeader`, `encoding`, optional `signaturePrefix` | **declare `dedupKey`** — the scheme signs no id; startup refuses without it |
|
|
40
|
+
| A sender that also sends a timestamp | add `timestampHeader` — the signed content becomes `{timestamp}.{body}` | as above |
|
|
41
|
+
|
|
42
|
+
Never hash the body as a dedup key: two legitimate identical events would collapse into one.
|
|
43
|
+
|
|
44
|
+
## Choosing the scope mode
|
|
45
|
+
|
|
46
|
+
| the sender's events belong to… | `scopeMode` | `resolveScope` | `actingRoles` |
|
|
47
|
+
|---|---|---|---|
|
|
48
|
+
| exactly one client organization each | `ORGANIZATION_REQUIRED` | required; answer `{ kind: ORGANIZATION, organizationId }` or `{ kind: UNROUTABLE }` | `organization` |
|
|
49
|
+
| the application as a whole | `APPLICATION` | must NOT be declared | `application` |
|
|
50
|
+
| different scopes, depending on the event | `RESOLVED_PER_DELIVERY` | required | one list per scope the handler may run in |
|
|
51
|
+
|
|
52
|
+
A `RESOLVED_PER_DELIVERY` handler runs in exactly the scopes it declares roles for, and must declare at
|
|
53
|
+
least one. A resolver answer naming a scope the handler holds no roles in makes the delivery `UNROUTABLE`.
|
|
54
|
+
|
|
55
|
+
One scope is reachable only this way: **one person's own data** (`{ kind: USER, userId }`), for a sender
|
|
56
|
+
whose records belong to individual people rather than organizations. Declare `actingRoles.user` with
|
|
57
|
+
APPLICATION role names — personal resources gate on application roles — and the handler is confined to
|
|
58
|
+
that one person's rows. The person is the delivery's scope, not a signed-in user.
|
|
59
|
+
|
|
60
|
+
A resolver may use `lookups.findOrganizationIdByField(resourceType, field, value)` to map a value to the
|
|
61
|
+
organization whose record carries it, or `lookups.findUserIdByField(...)` on a personal resource to map it to
|
|
62
|
+
the person. A value found under more than one owner answers `null`, so the delivery is `UNROUTABLE` rather
|
|
63
|
+
than routed to whichever sorts first. An organization or person that does not exist, or no longer has
|
|
64
|
+
authority (a suspended organization, a person who is not active), makes the delivery `UNROUTABLE`, and one
|
|
65
|
+
that loses it AFTER acceptance stops the delivery (it ends `DEAD`) rather than acting through its retries.
|
|
66
|
+
|
|
67
|
+
## What a handler may do
|
|
68
|
+
|
|
69
|
+
`ctx.resources.*` runs each operation exactly as an HTTP caller holding `actingRoles` in the delivery's
|
|
70
|
+
scope would: the operation's roles, the parent-scope check, unit narrowing, the tenant filter. A write
|
|
71
|
+
into another organization is refused, and so is any operation no HTTP caller can reach (an internal or
|
|
72
|
+
repository-only variant). Never declare `APP_ADMIN_SUPER_ADMIN`, or a role that inherits it — startup
|
|
73
|
+
refuses both, and a role the role table does not know.
|
|
74
|
+
|
|
75
|
+
There is no actor call on `ctx`. To hand a message to an agent, call `ctx.agents.startAutonomousTurn` with
|
|
76
|
+
a declared autonomous agent: the turn runs in the delivery's organization under the OAuth client that
|
|
77
|
+
organization bound to the agent (never the handler's roles), the delivery id is its occurrence so a retry
|
|
78
|
+
starts nothing twice, and it is offered only tools that read or that a reviewer must approve. See
|
|
79
|
+
`flows-actors-autonomous-agents`.
|
|
80
|
+
|
|
81
|
+
**A handler runs at least once.** The delivery is stored once, but a worker that crashes after your writes
|
|
82
|
+
and before the row settles, or a handler that throws after some writes, is retried. Make the handler
|
|
83
|
+
idempotent per `ctx.delivery.id`.
|
|
84
|
+
|
|
85
|
+
The pattern that works for a create: write `ctx.delivery.id` into a field that is UNIQUE on the resource
|
|
86
|
+
(`.isUnique({ scope: 'organization', sparse: true })` — sparse, so rows created any other way carry none), and
|
|
87
|
+
treat a `CONFLICT` from that create as "already done". The worked example does exactly this with the todo's
|
|
88
|
+
`externalRef`. Two things that look like shortcuts and are not:
|
|
89
|
+
|
|
90
|
+
- You cannot choose the created row's `_id`: a primary key is excluded from create.
|
|
91
|
+
- An `Idempotency-Key` does not reach a resource call from a handler: `ctx.resources` makes a sub-call,
|
|
92
|
+
and a sub-call never carries its caller's key.
|
|
93
|
+
|
|
94
|
+
Only treat `CONFLICT` as done when that unique field is the resource's ONLY uniqueness constraint;
|
|
95
|
+
otherwise a different collision would be swallowed. An update that sets fields to values from the
|
|
96
|
+
payload is idempotent by nature and needs nothing.
|
|
97
|
+
|
|
98
|
+
## Failure, retry, DEAD, replay
|
|
99
|
+
|
|
100
|
+
- A thrown error fails the attempt; the row is `RETRY_SCHEDULED` with backoff from `retry` (default: 8
|
|
101
|
+
attempts over at most 3 days, 30 s doubling to 6 h), then `DEAD`. A failure no retry can cure — an
|
|
102
|
+
authorization or validation refusal, a body the schema no longer parses — goes straight to `DEAD`.
|
|
103
|
+
- An administrator replays a `DEAD` delivery from Settings → **Inbound deliveries** with a written
|
|
104
|
+
justification. The replay gets a fresh retry budget, is recorded on the row and on the audit trail
|
|
105
|
+
(`INBOUND_DELIVERY_REPLAYED`), and applies once.
|
|
106
|
+
- `orderingKey` makes deliveries sharing a key run one at a time in receive order; a `DEAD` predecessor
|
|
107
|
+
does not block the ones after it, and a settling one releases the next straight away.
|
|
108
|
+
|
|
109
|
+
## Where the secret comes from
|
|
110
|
+
|
|
111
|
+
Put it in each environment's `secrets.json` under `inboundEndpointEnv`, keyed
|
|
112
|
+
`WILDO_INBOUND_<ENDPOINT_KEY>__SECRET`, and run `wildo config sync`: it reaches the backend only. A CI
|
|
113
|
+
deploy does not yet export these secrets into the generated workflow, so a CI-deployed environment
|
|
114
|
+
withholds the route until that lands; add the variable to the backend's deployment secrets by hand
|
|
115
|
+
meanwhile.
|
|
116
|
+
|
|
117
|
+
## What a stored delivery keeps
|
|
118
|
+
|
|
119
|
+
The raw payload, which can carry personal data. A person's erasure request does not yet reach the
|
|
120
|
+
deliveries whose payload names them; they leave with the retention period below, or with their
|
|
121
|
+
organization.
|
|
122
|
+
|
|
123
|
+
## Audit events
|
|
124
|
+
|
|
125
|
+
`INBOUND_DELIVERY_REJECTED` · `_ACCEPTED` · `_UNROUTABLE` · `_PROCESSED` · `_FAILED` (each retry) ·
|
|
126
|
+
`_DEAD` · `_REPLAYED`. None carries the payload; the stored delivery does.
|
|
127
|
+
|
|
128
|
+
## How long a delivery is kept
|
|
129
|
+
|
|
130
|
+
A stored delivery holds the sender's raw payload, which can carry personal data. It is bound to the
|
|
131
|
+
application's `OPERATIONAL_LOGS` retention class, counted from the moment it reached `PROCESSED`, `DEAD` or
|
|
132
|
+
`UNROUTABLE`, and the retention sweep deletes it when that period ends. A delivery still waiting or retrying
|
|
133
|
+
never expires; a replay restarts its clock when it settles again. Declare `OPERATIONAL_LOGS` in the
|
|
134
|
+
application's `dataRetention` schedule, or deliveries are kept until you do (every sweep says so). An
|
|
135
|
+
organization's deliveries also go with the organization when it is purged.
|