@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +321 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5957 -1729
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -0,0 +1,297 @@
|
|
|
1
|
+
# Receiving email — addresses, domains and what arrives
|
|
2
|
+
|
|
3
|
+
Read this when an application must RECEIVE email: configuring the receiving provider, deciding which
|
|
4
|
+
addresses reach which organization, letting an organization use its own domain, or reading what a stored
|
|
5
|
+
message carries. `email-channel.md` is about what a handler does with a message; this is about how the
|
|
6
|
+
message gets to it.
|
|
7
|
+
|
|
8
|
+
## What the engine does before your handler runs
|
|
9
|
+
|
|
10
|
+
| Step | What happens | Fails closed how |
|
|
11
|
+
|---|---|---|
|
|
12
|
+
| Notification | The provider POSTs a small signed notification to `/api/v1/webhooks/<provider>/<endpoint>`; the engine verifies it and stores it once | Unsigned or forged → `401`, nothing stored |
|
|
13
|
+
| Fetch | The engine fetches the message, its attachments and its raw bytes from the provider | Only from the provider's declared hosts, never following a redirect |
|
|
14
|
+
| Route | Each recipient address is routed to ONE organization (below) | An address no rule reaches is `UNROUTABLE` and audited, never guessed |
|
|
15
|
+
| Store | One `inboundEmails` row per organization the message reached | A message over the size limit is kept as its envelope only (`REJECTED_LIMIT`) |
|
|
16
|
+
| Scan | Every attachment, and the raw bytes, are scanned before anything may serve them | Infected, or unscannable (no scanner configured) → withheld, with the reason |
|
|
17
|
+
| Admit | The message joins its thread and reaches the handler if the sender meets its minimum | Below the minimum → stored and audited (`email-channel.md`) |
|
|
18
|
+
|
|
19
|
+
## Which address reaches which organization
|
|
20
|
+
|
|
21
|
+
Routing reads the ENVELOPE recipients, never what the sender wrote in the body, and tries four rules in
|
|
22
|
+
order. The first that matches decides; nothing falls through to a guess.
|
|
23
|
+
|
|
24
|
+
| Route kind | Address | Reaches |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| `REPLY_TOKEN` | `{local}+r-{token}@{domain}` — the Reply-To of an answer your application sent | The thread the token was issued for. The rest of the address must route to the SAME organization the token belongs to, or the message is unroutable. |
|
|
27
|
+
| `CLIENT_MAILBOX` | an exact address a firm keeps on its own domain for a client it serves | The CLIENT organization, only while its service-provider relationship with the firm is ACTIVE, re-checked on every message |
|
|
28
|
+
| `ORGANIZATION_DOMAIN` | any address on an organization's VERIFIED receiving domain | That organization; `local+tag` carries `tag` as the route tag |
|
|
29
|
+
| `SHARED_DOMAIN` | `{slug}[+tag]@{sharedDomain}` | The organization with that slug — the address every organization has with no setup |
|
|
30
|
+
|
|
31
|
+
A slug once held by a DELETED organization is tombstoned: `{slug}@{sharedDomain}` never reaches a later
|
|
32
|
+
organization that reuses it, which answers at `{slug}.{shortOrgId}` instead (the last eight characters of its
|
|
33
|
+
id). So mail written to the old organization can never land in the new one.
|
|
34
|
+
|
|
35
|
+
## Configuring receiving
|
|
36
|
+
|
|
37
|
+
Three declarations, all required:
|
|
38
|
+
|
|
39
|
+
1. **The capability and the provider** in `wildo.saas.config.ts`: enable `EngineCapability.EMAIL_INBOUND`,
|
|
40
|
+
declare it on the provider's BACKEND scope with both receiving protocols, and select it. The provider's
|
|
41
|
+
sending protocol can stay beside it:
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
## Usage Example
|
|
45
|
+
|
|
46
|
+
```typescript
|
|
47
|
+
// Resend both sends and RECEIVES (#1600). Receiving needs two protocols: EMAIL_INBOUND_PROVIDER, how the
|
|
48
|
+
// engine fetches a message, its attachments and its raw bytes and manages an organization's domains; and
|
|
49
|
+
// WEBHOOK_ORIGINATOR, which mounts `POST /api/v1/webhooks/resend/inbound-email` — Resend's
|
|
50
|
+
// `email.received` notification, Svix-signed with `RESEND_WEBHOOK_SECRET`.
|
|
51
|
+
resend: {
|
|
52
|
+
engineCapabilities: [EngineCapability.EMAIL_TRANSACTIONAL, EngineCapability.EMAIL_INBOUND],
|
|
53
|
+
providerCapabilities: ['EMAIL_TRANSACTIONAL', 'EMAIL_INBOUND'],
|
|
54
|
+
protocols: ['EMAIL_PROVIDER', 'EMAIL_INBOUND_PROVIDER', 'WEBHOOK_ORIGINATOR'],
|
|
55
|
+
},
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
2. **The shared domain** in `backend-api/src/saas-config.backend.ts` (`email.inbound`). Its MX record points at
|
|
59
|
+
the receiving provider. Leave it out and only organization domains and client mailboxes receive mail:
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
## Usage Example
|
|
63
|
+
|
|
64
|
+
```typescript
|
|
65
|
+
// Receiving email (#1600). Every organization is reachable at `{slug}@{sharedDomain}` with no setup; an
|
|
66
|
+
// organization may add its own domain (Settings → Email domains) and client mailboxes on it. The shared
|
|
67
|
+
// domain's MX points at the receiving provider (`EMAIL_INBOUND` is selected in `wildo.saas.config.ts`).
|
|
68
|
+
// `.test` locally: the fake-provider lane stands in for the provider, so nothing here is a real address.
|
|
69
|
+
inbound: {
|
|
70
|
+
sharedDomain: 'inbox.your-app.test',
|
|
71
|
+
},
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
3. **The secrets** in each environment: the provider's API key and its webhook signing secret
|
|
75
|
+
(`wildo secrets list` names them; for Resend, `RESEND_API_KEY` and `RESEND_WEBHOOK_SECRET`). Then register
|
|
76
|
+
the notification URL with the provider for the `email.received` event.
|
|
77
|
+
|
|
78
|
+
`email.inbound` also takes `rawMimeRetention` (`KEEP` by default: only the original bytes can be re-verified),
|
|
79
|
+
`organizationSendingDomainUse` (below) and `maxMessageSizeBytes` (25 MB by default).
|
|
80
|
+
|
|
81
|
+
## An organization's own domain
|
|
82
|
+
|
|
83
|
+
An organization administrator adds `inbox.firm.example` in four steps, each an operation on
|
|
84
|
+
`organizationEmailDomains`:
|
|
85
|
+
|
|
86
|
+
1. **`claim`** returns the DNS TXT record to publish at `_wildo-verification.{domain}`. Nothing is created
|
|
87
|
+
at the provider yet. A pending claim is inert: it routes nothing and blocks nobody, and several
|
|
88
|
+
organizations may claim the same name. The application's own domains cannot be claimed (the shared
|
|
89
|
+
domain, and the domain of `email.from`).
|
|
90
|
+
2. **`verify_ownership`** — the engine reads the TXT record from public DNS. The FIRST organization to prove
|
|
91
|
+
ownership wins; only then is the domain created at the provider, and every other claim is refused from then
|
|
92
|
+
on. The row now lists the provider's DNS records (MX, DKIM, …) to publish.
|
|
93
|
+
3. **`verify`** — asks the provider to check those records. The provider answers asynchronously, so this may
|
|
94
|
+
stay `PROVIDER_PENDING` for a while; a scheduled re-check settles it.
|
|
95
|
+
4. **`VERIFIED`** — the domain receives, and (when claimed for sending) sends the organization's thread replies.
|
|
96
|
+
|
|
97
|
+
If the ownership record or the provider's records disappear, the re-check (or the next `verify`) SUSPENDS the
|
|
98
|
+
domain: mail stops routing and sending stops at once. **`remove`** deletes the domain at the provider and then
|
|
99
|
+
the row; deleting the organization does the same for every domain it held.
|
|
100
|
+
|
|
101
|
+
## Client mailboxes on a firm's domain
|
|
102
|
+
|
|
103
|
+
A firm that serves clients (a service-provider relationship, `service-provider-relationships`) can give each
|
|
104
|
+
client an address on the FIRM's domain. The firm's administrator creates a `clientMailboxes` row
|
|
105
|
+
(`acme@inbox.firm.example`) that names its own verified receiving domain and the relationship. The row belongs
|
|
106
|
+
to the firm, because the domain owner decides what each of its addresses does, and a client can create none.
|
|
107
|
+
Mail to the address reaches the client's organization, never the firm's. It stops the moment the client suspends
|
|
108
|
+
or ends the relationship. Creating and removing a mailbox is recorded in both organizations' audit trails.
|
|
109
|
+
|
|
110
|
+
## The answer's From
|
|
111
|
+
|
|
112
|
+
A handler's answer (`ctx.reply`) leaves the way the thread arrived, so the sender's mail program keeps it in
|
|
113
|
+
the conversation:
|
|
114
|
+
|
|
115
|
+
| The thread arrived by | The answer is from | Its Reply-To (with the token) |
|
|
116
|
+
|---|---|---|
|
|
117
|
+
| the shared domain | `{slug}@{sharedDomain}` | `{slug}+r-{token}@{sharedDomain}` |
|
|
118
|
+
| an organization domain | the same local part on the organization's VERIFIED sending domain (the arrival domain when it sends) | on the arrival domain |
|
|
119
|
+
| a client mailbox | the mailbox, while its relationship is still ACTIVE | on the mailbox's address |
|
|
120
|
+
|
|
121
|
+
When none applies — the domain stopped routing, the relationship ended — the answer falls back to the shared
|
|
122
|
+
address, or to the application's configured sender when there is no shared domain.
|
|
123
|
+
|
|
124
|
+
`organizationSendingDomainUse: ALL_ORGANIZATION_MAIL` extends an organization's verified sending domain to all
|
|
125
|
+
of its mail, not only thread replies. A domain claimed but not verified is never used as a sender.
|
|
126
|
+
|
|
127
|
+
If DNS cannot be asked (a timeout or an unreachable resolver), nothing changes: `verify_ownership` and `verify`
|
|
128
|
+
answer 502, and the re-check tries again on its next run. Only an answer that the record does not exist suspends
|
|
129
|
+
a domain.
|
|
130
|
+
|
|
131
|
+
## What a stored message carries
|
|
132
|
+
|
|
133
|
+
`inboundEmails` holds the addressing, the subject, the text and the HTML, the kept headers, the authentication
|
|
134
|
+
verdicts and the sender assurance, the route kind and tag, the attachments with what the sender declared, the ones
|
|
135
|
+
withheld with their reason, and the raw MIME's SHA-256. The HTML is rendered with `StringDisplayMode.UNTRUSTED_HTML`:
|
|
136
|
+
in a sandboxed frame that runs nothing and loads nothing remote. The CLEAN files are LINKED to the message
|
|
137
|
+
(`attachmentFiles`, `rawMimeFile`). That keeps them for the message's retention, serves them to whoever may read the
|
|
138
|
+
message through the ordinary file routes, and erases them when the message is impersonalized. A withheld file is
|
|
139
|
+
never linked, and never served.
|
|
140
|
+
Members of the organization can read it; nobody can edit it. It is business correspondence, kept for the
|
|
141
|
+
`BUSINESS_RECORDS` period from the end of its calendar year, and its personal content is impersonalized — not
|
|
142
|
+
deleted — when its subject is erased.
|
|
143
|
+
|
|
144
|
+
## Worked example
|
|
145
|
+
|
|
146
|
+
A task application turns an email into a todo. The default address creates it in the list the tag names and answers
|
|
147
|
+
on the thread; `+screened` hands a sender whose domain failed DMARC to a handler that files it as an
|
|
148
|
+
unconfirmed todo and never answers; a follow-up on a linked thread becomes a checklist line on the SAME todo:
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
## Usage Example
|
|
152
|
+
|
|
153
|
+
```typescript
|
|
154
|
+
/** The template the answer is rendered from — `emails/resources/todos/email-intake.received/`. */
|
|
155
|
+
export const TODO_EMAIL_RECEIVED_TEMPLATE_REF = 'email.todos.email-intake.received';
|
|
156
|
+
|
|
157
|
+
/** The route tag of the screened address, `acme+screened@…`. */
|
|
158
|
+
export const TODO_EMAIL_SCREENED_ROUTE_TAG = 'screened';
|
|
159
|
+
|
|
160
|
+
const EMAIL_INTAKE_REF = inboundHandlerRef('todos.email-intake');
|
|
161
|
+
const EMAIL_SCREENED_REF = inboundHandlerRef('todos.email-screened');
|
|
162
|
+
const EMAIL_SCREENING_REF = inboundHandlerRef('todos.email-screening');
|
|
163
|
+
|
|
164
|
+
/** The most a todo title may hold (`Todos.title` is 1–200 characters). */
|
|
165
|
+
const TITLE_MAX = 200;
|
|
166
|
+
/** The most a todo description may hold. */
|
|
167
|
+
const DESCRIPTION_MAX = 1000;
|
|
168
|
+
/** The most a checklist line may hold. */
|
|
169
|
+
const CHECKLIST_LABEL_MAX = 200;
|
|
170
|
+
|
|
171
|
+
/** Where the todo goes: the list the tag names, else one of the organization's active lists. */
|
|
172
|
+
async function resolveTargetList(ctx: InboundChannelHandlerContextBase, routeTag: string | undefined): Promise<TodoLists> {
|
|
173
|
+
if (routeTag && routeTag !== TODO_EMAIL_SCREENED_ROUTE_TAG) {
|
|
174
|
+
const named = await ctx.resources.read<TodoLists>(TasksManager_ResourceType.TODO_LISTS, routeTag);
|
|
175
|
+
if (named?.status !== TodoLists_Status.ACTIVE) {
|
|
176
|
+
throw Object.assign(new Error('The address names no active todo list of this organization'), { name: 'TodoListNotAcceptingTodos' });
|
|
177
|
+
}
|
|
178
|
+
return named;
|
|
179
|
+
}
|
|
180
|
+
const page = await ctx.resources.list<TodoLists>(TasksManager_ResourceType.TODO_LISTS, { status: TodoLists_Status.ACTIVE }, { page: 1, limit: 1 });
|
|
181
|
+
const first = (Array.isArray(page) ? page : page.data)[0];
|
|
182
|
+
if (!first) throw Object.assign(new Error('The organization has no active todo list'), { name: 'TodoListNotAcceptingTodos' });
|
|
183
|
+
return first;
|
|
184
|
+
}
|
|
185
|
+
|
|
186
|
+
/** The message's own words, and what it carried: kept on the todo so whoever opens it sees the request. */
|
|
187
|
+
function describeMessage(message: InboundMessage<InboundChannelKind.EMAIL>, unconfirmedSender: boolean): string {
|
|
188
|
+
const lines = [
|
|
189
|
+
unconfirmedSender ? `From ${message.sender.address} (sender NOT confirmed — its domain did not pass DMARC)` : `From ${message.sender.address}`,
|
|
190
|
+
'',
|
|
191
|
+
(message.strippedReply ?? message.text).trim(),
|
|
192
|
+
];
|
|
193
|
+
if (message.attachments.length > 0) lines.push('', `Attachments: ${message.attachments.map((attachment) => attachment.filename).join(', ')}`);
|
|
194
|
+
if (message.withheldAttachments.length > 0) {
|
|
195
|
+
lines.push('', `Withheld: ${message.withheldAttachments.map((withheld) => `${withheld.filename} (${withheld.reason})`).join(', ')}`);
|
|
196
|
+
}
|
|
197
|
+
return lines.join('\n').slice(0, DESCRIPTION_MAX);
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** Create the todo for one delivery, once. Returns its id, whether this run created it or an earlier one did. */
|
|
201
|
+
async function createTodoOnce(ctx: InboundChannelHandlerContextBase, list: TodoLists, message: InboundMessage<InboundChannelKind.EMAIL>, unconfirmedSender: boolean): Promise<string> {
|
|
202
|
+
const externalRef = `email:${ctx.delivery.id}`;
|
|
203
|
+
try {
|
|
204
|
+
const created = await ctx.resources.create<Todos>(TasksManager_ResourceType.TODOS, {
|
|
205
|
+
todoListId: list._id,
|
|
206
|
+
title: (message.payload.subject.trim() || '(no subject)').slice(0, TITLE_MAX),
|
|
207
|
+
description: describeMessage(message, unconfirmedSender),
|
|
208
|
+
externalRef,
|
|
209
|
+
// The schema-family discriminator: a `.default()` alone does not select a union branch.
|
|
210
|
+
recurringType: Todos_RecurrenceType.ONE_TIME,
|
|
211
|
+
...(unconfirmedSender ? { tags: ['unconfirmed-sender'] } : {}),
|
|
212
|
+
});
|
|
213
|
+
return created._id;
|
|
214
|
+
} catch (error) {
|
|
215
|
+
// `externalRef` is the only unique field on a todo, so a CONFLICT means this delivery already created it.
|
|
216
|
+
if (!(isWildoBackendError(error) && error.type === ErrorType.CONFLICT)) throw error;
|
|
217
|
+
const page = await ctx.resources.list<Todos>(TasksManager_ResourceType.TODOS, { externalRef }, { page: 1, limit: 1 });
|
|
218
|
+
const existing = (Array.isArray(page) ? page : page.data)[0];
|
|
219
|
+
if (!existing) throw error;
|
|
220
|
+
return existing._id;
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/** A follow-up on a linked thread becomes one checklist line on its todo, once per delivery. */
|
|
225
|
+
async function addFollowUpOnce(ctx: InboundChannelHandlerContextBase, todoId: string, message: InboundMessage<InboundChannelKind.EMAIL>): Promise<void> {
|
|
226
|
+
const todo = await ctx.resources.read<Todos>(TasksManager_ResourceType.TODOS, todoId);
|
|
227
|
+
if (!todo) throw Object.assign(new Error('The todo this thread is about no longer exists'), { name: 'TodoNotFound' });
|
|
228
|
+
const marker = `[${ctx.delivery.id}]`;
|
|
229
|
+
const checklist = todo.checklist ?? [];
|
|
230
|
+
if (checklist.some((item) => item.label.endsWith(marker))) return;
|
|
231
|
+
const words = (message.strippedReply ?? message.text).trim().replace(/\s+/g, ' ');
|
|
232
|
+
const label = `${message.sender.address}: ${words}`.slice(0, CHECKLIST_LABEL_MAX - marker.length - 1);
|
|
233
|
+
await ctx.resources.update(TasksManager_ResourceType.TODOS, todoId, { checklist: [...checklist, { label: `${label} ${marker}`, done: false }] });
|
|
234
|
+
}
|
|
235
|
+
|
|
236
|
+
/**
|
|
237
|
+
* What both answering handlers do: a message on a thread already linked to a todo is a follow-up; any other
|
|
238
|
+
* becomes a new todo, the thread is linked to it, and the sender is answered.
|
|
239
|
+
*/
|
|
240
|
+
async function intake(
|
|
241
|
+
ctx: InboundChannelHandlerContext<InboundReplyMode.THREAD>,
|
|
242
|
+
message: InboundMessage<InboundChannelKind.EMAIL>,
|
|
243
|
+
): Promise<void> {
|
|
244
|
+
const linked = message.thread.linkedResource;
|
|
245
|
+
if (linked?.resourceType === TasksManager_ResourceType.TODOS) {
|
|
246
|
+
await addFollowUpOnce(ctx, linked.resourceId, message);
|
|
247
|
+
return;
|
|
248
|
+
}
|
|
249
|
+
const list = await resolveTargetList(ctx, message.payload.routeTag);
|
|
250
|
+
const todoId = await createTodoOnce(ctx, list, message, false);
|
|
251
|
+
await ctx.thread.link({ resourceType: TasksManager_ResourceType.TODOS, resourceId: todoId });
|
|
252
|
+
await ctx.reply({
|
|
253
|
+
templateRef: TODO_EMAIL_RECEIVED_TEMPLATE_REF,
|
|
254
|
+
variables: { todoTitle: message.payload.subject, todoListName: list.name, attachmentCount: message.attachments.length },
|
|
255
|
+
});
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/** The organization's address: every message no tag claims. */
|
|
259
|
+
export const todoEmailIntakeHandler = defineInboundChannelHandler({
|
|
260
|
+
ref: EMAIL_INTAKE_REF,
|
|
261
|
+
source: { kind: InboundSourceKind.CHANNEL, channel: InboundChannelKind.EMAIL, isDefault: true },
|
|
262
|
+
replyMode: InboundReplyMode.THREAD,
|
|
263
|
+
// Only a sender whose domain passes DMARC creates work here. Below that the message is stored and audited
|
|
264
|
+
// and dispatched to nobody: this address has no below-minimum handler.
|
|
265
|
+
minimumSenderAssurance: InboundSenderAssurance.DOMAIN_ALIGNED,
|
|
266
|
+
// The whole authority of the handler, whoever the sender is: what a member creating a todo has.
|
|
267
|
+
actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
|
|
268
|
+
handle: (ctx, message) => intake(ctx, message),
|
|
269
|
+
});
|
|
270
|
+
|
|
271
|
+
/** `+screened`: the same intake, with a place for what it turns away. */
|
|
272
|
+
export const todoEmailScreenedHandler = defineInboundChannelHandler({
|
|
273
|
+
ref: EMAIL_SCREENED_REF,
|
|
274
|
+
source: { kind: InboundSourceKind.CHANNEL, channel: InboundChannelKind.EMAIL, routeTag: TODO_EMAIL_SCREENED_ROUTE_TAG },
|
|
275
|
+
replyMode: InboundReplyMode.THREAD,
|
|
276
|
+
minimumSenderAssurance: InboundSenderAssurance.DOMAIN_ALIGNED,
|
|
277
|
+
belowMinimumHandlerRef: EMAIL_SCREENING_REF,
|
|
278
|
+
actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
|
|
279
|
+
handle: (ctx, message) => intake(ctx, message),
|
|
280
|
+
});
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* What `+screened` turns away: filed as a todo tagged `unconfirmed-sender`, and never answered. It has neither
|
|
284
|
+
* a tag nor the default, so no address reaches it directly.
|
|
285
|
+
*/
|
|
286
|
+
export const todoEmailScreeningHandler = defineInboundChannelHandler({
|
|
287
|
+
ref: EMAIL_SCREENING_REF,
|
|
288
|
+
source: { kind: InboundSourceKind.CHANNEL, channel: InboundChannelKind.EMAIL },
|
|
289
|
+
replyMode: InboundReplyMode.NONE,
|
|
290
|
+
minimumSenderAssurance: InboundSenderAssurance.UNVERIFIED,
|
|
291
|
+
actingRoles: { organization: [CORE_ORG_ROLES.ORG_MEMBER] },
|
|
292
|
+
handle: async (ctx, message) => {
|
|
293
|
+
const list = await resolveTargetList(ctx, undefined);
|
|
294
|
+
await createTodoOnce(ctx, list, message, true);
|
|
295
|
+
},
|
|
296
|
+
});
|
|
297
|
+
```
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: infra-environment-config
|
|
3
3
|
description: Edit infrastructure environment configuration for local and deployed targets — the typed `defineInfraEnvConfig({...})` files declaring `environment`, `runtime`, `publicDomain` (required external hostname), `serviceAuth`, `backingServices` (the `BackingServiceKind` map, each with `BackingServiceSource.SELF | MANAGED` plus an orthogonal `provider: '<brand>'`, e.g. `provider: 'atlas'` for MongoDB Atlas), `logging`, `devCompanion`, `kubernetes` (namespace, optional ingressClass and per-service replica settings), and (for remote) `remoteProvider` + `deployment`. Use when the user says "wire up a new external service endpoint", "rotate the staging mongodb to Atlas", "fix the local docker-compose port collision", "add a new environment", "the dev stack can't reach Redis", "where do audit logs get stored", "config sync warns my env has no audit store", or any change that adjusts environment-specific infrastructure wiring.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Infra Environment Config
|
|
@@ -111,8 +112,9 @@ export. The typed shape carries:
|
|
|
111
112
|
kind list and per-kind entry shape** — it is extracted from the
|
|
112
113
|
schema, so unlike a prose list it cannot drift as kinds are added.
|
|
113
114
|
Each entry carries `source: BackingServiceSource.SELF | MANAGED`
|
|
114
|
-
plus an optional `provider: '<brand>'` (e.g. `'atlas'`, `'
|
|
115
|
-
|
|
115
|
+
plus an optional `provider: '<brand>'` (e.g. `'atlas'`, `'minio'`)
|
|
116
|
+
and per-source connection params — but only the combinations listed in
|
|
117
|
+
"What each kind can be declared as today" below are accepted. The legacy
|
|
116
118
|
`BackingServiceSource.ATLAS` value no longer exists — it was
|
|
117
119
|
replaced by the two-axis `(source, provider?)` shape, so Atlas is
|
|
118
120
|
now `source: MANAGED, provider: 'atlas'`
|
|
@@ -275,18 +277,20 @@ export default defineInfraEnvConfig({
|
|
|
275
277
|
|
|
276
278
|
/**
|
|
277
279
|
* The PLATFORM's own store (apps-manager + module-registry: users, organizations, applications,
|
|
278
|
-
* sessions, API keys). Declared rather than inferred
|
|
279
|
-
* `postgresql
|
|
280
|
+
* sessions, API keys). Declared rather than inferred: it is the selection, and
|
|
281
|
+
* `backingServices.postgresql` below is the substrate.
|
|
280
282
|
*
|
|
281
|
-
*
|
|
282
|
-
*
|
|
283
|
-
* `MONGO_CONNECT_URL` became engine-conditional
|
|
284
|
-
* `env-vars-builder` refuses this block without it any more.
|
|
283
|
+
* The platform has not REQUIRED a MongoDB since 2026-08-28: the six `persistenceAdapter: MONGODB`
|
|
284
|
+
* bootstrap pins retired, crontabs-batches-manager was ported, and apps-manager's
|
|
285
|
+
* `MONGO_CONNECT_URL` became engine-conditional.
|
|
285
286
|
*
|
|
286
|
-
*
|
|
287
|
-
*
|
|
288
|
-
*
|
|
289
|
-
*
|
|
287
|
+
* `backingServices.mongodb` was REMOVED 2026-09-24, by decision: this environment hosts no Mongo-backed application (Wonder
|
|
288
|
+
* Todos, Wonder CRM and every scratch application declare `applicationDatabase: POSTGRESQL`; RAG
|
|
289
|
+
* lives in pgvector). The block used to be kept "for any Mongo-backed application hosted here",
|
|
290
|
+
* and that hosting cost the whole platform on the day its mongod's WiredTiger journal corrupted:
|
|
291
|
+
* apps-manager, module-registry and the companion all died on `ECONNRESET` while every platform
|
|
292
|
+
* row sat in PostgreSQL. A future Mongo-backed application re-declares `backingServices.mongodb`
|
|
293
|
+
* (which also brings mongot back).
|
|
290
294
|
*/
|
|
291
295
|
database: { engine: DatabaseEngine.POSTGRESQL, source: BackingServiceSource.SELF },
|
|
292
296
|
|
|
@@ -304,12 +308,6 @@ export default defineInfraEnvConfig({
|
|
|
304
308
|
applicationDatabase: { engine: DatabaseEngine.POSTGRESQL },
|
|
305
309
|
|
|
306
310
|
backingServices: {
|
|
307
|
-
mongodb: {
|
|
308
|
-
source: BackingServiceSource.SELF,
|
|
309
|
-
database: 'your-app-db',
|
|
310
|
-
host: 'localhost',
|
|
311
|
-
port: 27017,
|
|
312
|
-
},
|
|
313
311
|
redis: {
|
|
314
312
|
source: BackingServiceSource.SELF,
|
|
315
313
|
host: 'localhost',
|
|
@@ -323,25 +321,13 @@ export default defineInfraEnvConfig({
|
|
|
323
321
|
vhost: 'your-app',
|
|
324
322
|
},
|
|
325
323
|
/**
|
|
326
|
-
* Self-hosted PostgreSQL
|
|
324
|
+
* Self-hosted PostgreSQL: the only data store this environment runs, for the platform and for
|
|
325
|
+
* every hosted application alike.
|
|
327
326
|
*
|
|
328
327
|
* This names the APPLICATION's own database, and is distinct from the PLATFORM's engine
|
|
329
328
|
* declared by `database` above. The two are separate axes: `database.engine` decides where the
|
|
330
329
|
* platform's own tables live, while an application's resources move only when that
|
|
331
330
|
* application's backend selects `DATABASE_DEFAULT_ADAPTER`.
|
|
332
|
-
*
|
|
333
|
-
* ⚠️ CORRECTED 2026-08-19. This comment used to warn that flipping `database.engine` to
|
|
334
|
-
* PostgreSQL "would delete MongoDB from the rendered compose file and take the whole platform
|
|
335
|
-
* down with it", and instructed authors to declare PostgreSQL only here. That exclusivity was
|
|
336
|
-
* real when written — `needsLocalMongoDB` was `engine === MONGODB && source === SELF` — and it
|
|
337
|
-
* is now gone: `database.engine` IS PostgreSQL on line 36, and `defineInfraEnvConfig`'s
|
|
338
|
-
* superRefine used to REQUIRE `backingServices.mongodb: SELF` whenever the engine is PostgreSQL.
|
|
339
|
-
* It no longer does (2026-08-28): the six bootstrap resources that were pinned to MongoDB
|
|
340
|
-
* (`wildoApplication`, `wildoApplicationConfig`, `wildoApplicationSecrets`,
|
|
341
|
-
* `platformApplications`, `platformApplicationsConfig`, `platformApplicationsSecrets`) had their
|
|
342
|
-
* pins retired on 2026-08-22 and now follow the platform's configured engine like every other
|
|
343
|
-
* platform resource. Both stores are still declared above and both are still rendered — by
|
|
344
|
-
* choice now, not by obligation.
|
|
345
331
|
*/
|
|
346
332
|
postgresql: {
|
|
347
333
|
source: BackingServiceSource.SELF,
|
|
@@ -622,14 +608,12 @@ What earns its place:
|
|
|
622
608
|
app's enabled engine capabilities depend on (see "Capability-driven
|
|
623
609
|
backing services" below). Each entry carries `source: BackingServiceSource.SELF`
|
|
624
610
|
(locally hosted by docker-compose) plus per-source connection
|
|
625
|
-
params (host, port, vhost, bucket, endpoint).
|
|
626
|
-
to `source: BackingServiceSource.MANAGED`
|
|
627
|
-
|
|
628
|
-
|
|
629
|
-
`
|
|
630
|
-
|
|
631
|
-
enum value was removed on 2026-05-07 — Atlas is a brand under the
|
|
632
|
-
managed source, not its own source axis.
|
|
611
|
+
params (host, port, vhost, bucket, endpoint). A remote config may
|
|
612
|
+
swap to `source: BackingServiceSource.MANAGED` only where the platform
|
|
613
|
+
serves it — today that is MongoDB Atlas alone (`provider: 'atlas'`);
|
|
614
|
+
see "What each kind can be declared as today". The pre-Slice-4.B.0
|
|
615
|
+
`BackingServiceSource.ATLAS` enum value was removed on 2026-05-07 —
|
|
616
|
+
Atlas is a brand under the managed source, not its own source axis.
|
|
633
617
|
- `logging: { level: 'debug', formattedConsoleErrors: true }` —
|
|
634
618
|
per-environment log posture. Wired end-to-end by Slice 3.5:
|
|
635
619
|
persisted into `PlatformEnvConfigJson.logging`, projected by
|
|
@@ -660,10 +644,85 @@ The sibling staging config
|
|
|
660
644
|
the same shape with `WildoEnvironment.STAGING` +
|
|
661
645
|
`WildoLocationType.REMOTE` + `remoteProvider` (registry endpoint,
|
|
662
646
|
region) + `deployment` (branch, runtime). Backing-service `source`
|
|
663
|
-
swaps to `MANAGED`
|
|
664
|
-
|
|
665
|
-
|
|
666
|
-
|
|
647
|
+
swaps to `MANAGED` only where the platform serves it (MongoDB Atlas,
|
|
648
|
+
`provider: 'atlas'`).
|
|
649
|
+
|
|
650
|
+
## What each kind can be declared as today
|
|
651
|
+
|
|
652
|
+
A declaration is accepted only when the platform can SERVE it: it must
|
|
653
|
+
resolve to an infrastructure provider, and that provider must have a
|
|
654
|
+
provider module able to deliver the application's connection. Anything
|
|
655
|
+
else is refused — by `wildo config validate`, `wildo config sync` and
|
|
656
|
+
`wildo lock check` alike — with a message naming the environment, the
|
|
657
|
+
kind, what you declared, and what that kind CAN be declared as.
|
|
658
|
+
|
|
659
|
+
| Kind | Accepted declarations |
|
|
660
|
+
|---|---|
|
|
661
|
+
| `mongodb` | `{ source: SELF }` · `{ source: MANAGED, provider: 'atlas' }` |
|
|
662
|
+
| `postgresql` | `{ source: SELF }` |
|
|
663
|
+
| `redis` | `{ source: SELF }` |
|
|
664
|
+
| `rabbitmq` | `{ source: SELF }` |
|
|
665
|
+
| `s3` | `{ source: SELF }` (MinIO; `provider: 'minio'` is accepted and redundant) |
|
|
666
|
+
| `clamav` | `{ source: SELF }` |
|
|
667
|
+
| `immudb` | `{ source: SELF }` |
|
|
668
|
+
|
|
669
|
+
What this refuses, and why it is not a formality:
|
|
670
|
+
|
|
671
|
+
- **A managed cache, broker, scanner or audit store** — `redis: { source:
|
|
672
|
+
MANAGED }` and the like — names no provider at all.
|
|
673
|
+
- **Managed PostgreSQL** (`'aws-rds'`, `'gcp-cloud-sql'`, `'azure-database'`,
|
|
674
|
+
`'supabase'`, `'neon'`, `'render'`, or unbranded) and **managed S3** (AWS)
|
|
675
|
+
name catalogue entries the platform cannot serve yet.
|
|
676
|
+
- Before this was refused, such a declaration passed in silence: the stack
|
|
677
|
+
was generated WITHOUT the self-hosted service, and the platform still
|
|
678
|
+
minted the application's credential on its OWN server — a credential for a
|
|
679
|
+
server the application never connects to.
|
|
680
|
+
|
|
681
|
+
There is no opt-out flag. A kind becomes declarable as `MANAGED` in the same
|
|
682
|
+
framework release that adds the provider module serving it. `backup` is not
|
|
683
|
+
a kind: it was withdrawn because nothing read it, and a `backup:` key now
|
|
684
|
+
fails to parse.
|
|
685
|
+
|
|
686
|
+
The authoritative resolution table, with the "Servable today" column, is in
|
|
687
|
+
`references/framework-backing-services-api.md`.
|
|
688
|
+
|
|
689
|
+
### Your declaration decides where credentials are minted
|
|
690
|
+
|
|
691
|
+
Every registration (`wildo local init`, every `wildo local dev` start) sends
|
|
692
|
+
apps-manager the `(source, provider)` pair of each kind the environment
|
|
693
|
+
declares. apps-manager mints the application's cache, broker and database
|
|
694
|
+
credentials on exactly that provider, through the same provider catalogue —
|
|
695
|
+
never on another one because it happens to hold a client for it. A kind the
|
|
696
|
+
environment does not declare keeps the platform's own choice: its self-hosted
|
|
697
|
+
server, or for MongoDB, Atlas whenever the platform holds an Atlas API key.
|
|
698
|
+
|
|
699
|
+
So moving `mongodb` from `{ source: SELF }` to
|
|
700
|
+
`{ source: MANAGED, provider: 'atlas' }` and registering again changes where
|
|
701
|
+
the database user is minted, with no apps-manager edit — provided the
|
|
702
|
+
platform already serves Atlas. A declaration change reaches apps-manager at
|
|
703
|
+
the next registration, not at `wildo config sync` or
|
|
704
|
+
`wildo config reapply-declaration`.
|
|
705
|
+
|
|
706
|
+
Which providers a platform can serve is PLATFORM configuration: an Atlas
|
|
707
|
+
declaration needs apps-manager to hold an Atlas API key, a self-hosted
|
|
708
|
+
PostgreSQL declaration needs a platform PostgreSQL. apps-manager refuses a
|
|
709
|
+
registration whose declared provider it cannot serve, before provisioning
|
|
710
|
+
anything, naming the kind, what you declared and what the platform serves
|
|
711
|
+
instead. Only the kinds the application actually stores in are checked
|
|
712
|
+
against the platform's credentials: a declared MongoDB that a PostgreSQL
|
|
713
|
+
application never uses does not need an Atlas key.
|
|
714
|
+
|
|
715
|
+
Minion confinement holds on MongoDB Atlas exactly as on a self-hosted MongoDB.
|
|
716
|
+
Each minion of an application whose database store is declared on Atlas gets its
|
|
717
|
+
OWN Atlas database user, never the application's: that user holds one custom
|
|
718
|
+
role granting only the collections the minion's `resourceAccess` declares plus
|
|
719
|
+
the execution-history records every minion needs, and it can reach only the
|
|
720
|
+
application's cluster. Removing the minion deletes its user and role and leaves
|
|
721
|
+
the application's user untouched. Each minion takes one database user and one
|
|
722
|
+
custom role from the Atlas project's limits (100 of each by default). When
|
|
723
|
+
apps-manager can read those limits, a minion that would exceed one is refused
|
|
724
|
+
before anything is created, naming the limit; otherwise Atlas's own refusal
|
|
725
|
+
of the create is what stops it.
|
|
667
726
|
|
|
668
727
|
## Capability-driven backing services
|
|
669
728
|
|
|
@@ -707,6 +766,47 @@ there is no secret for you to create. If a backend log says
|
|
|
707
766
|
answer is a `wildo config sync` (which provisions and re-renders), never a
|
|
708
767
|
hand-written key.
|
|
709
768
|
|
|
769
|
+
**Nor do you author the audit store's credentials.** A self-hosted store's
|
|
770
|
+
credentials are MINTED, never authored. Each application gets its OWN immudb
|
|
771
|
+
database and its OWN user, which can write that database and nothing else;
|
|
772
|
+
the platform creates both when the application registers and delivers them to
|
|
773
|
+
the application with its other platform secrets. The server's administrator
|
|
774
|
+
password is a platform secret that only the platform's own apps-manager
|
|
775
|
+
receives. No application receives it.
|
|
776
|
+
|
|
777
|
+
- `IMMUDB_USER`, `IMMUDB_PASSWORD` and `IMMUDB_DATABASE` in your provider
|
|
778
|
+
secrets decide nothing on a self-hosted store. The minted values win.
|
|
779
|
+
Where they differ, the backend logs a warning naming each variable (never
|
|
780
|
+
its value). Remove them with `wildo secrets unset <NAME>`. They matter
|
|
781
|
+
only for a MANAGED immudb.
|
|
782
|
+
- Withdrawing the application (`wildo local deregister`) deactivates its
|
|
783
|
+
audit user and revokes its permission. The database and its events are
|
|
784
|
+
kept, because an audit history must outlive the credential that wrote it.
|
|
785
|
+
`wildo local restore` re-activates the same user.
|
|
786
|
+
- The first boot on the new per-application database records a DELIBERATE
|
|
787
|
+
trust-anchor reset in the backend log, instead of a tamper alarm. The
|
|
788
|
+
verified history now starts there, and the previous database's anchor
|
|
789
|
+
file is kept.
|
|
790
|
+
- An immudb data directory initialised before this change keeps its old
|
|
791
|
+
administrator password. When that password is immudb's packaged default
|
|
792
|
+
(the usual case: nothing set it), apps-manager changes it to
|
|
793
|
+
`immudb.adminPassword` at its first administrator login, logs a warning
|
|
794
|
+
and records `immudb_admin_credential_adopted` on the registration's
|
|
795
|
+
audit event. Nothing is asked of you, with one consequence: another
|
|
796
|
+
application on the same platform that was registered before this change
|
|
797
|
+
still logs in as that administrator, so from then on its audit writes
|
|
798
|
+
are refused (its backend logs a warning). Re-register it
|
|
799
|
+
(`wildo local init`) and it gets its own database and user.
|
|
800
|
+
- When the old password is a real secret (an `IMMUDB_PASSWORD` you authored
|
|
801
|
+
before this change), the platform cannot log in and registration fails;
|
|
802
|
+
apps-manager's log names the cause. Set the server's administrator
|
|
803
|
+
password, once, to the value of `immudb.adminPassword` in the
|
|
804
|
+
environment's `secrets.json`
|
|
805
|
+
(`docker exec -it wildo-immudb immuadmin user changepassword immudb`
|
|
806
|
+
locally), or start from a fresh data directory. This alters a credential
|
|
807
|
+
the platform does not hold, so it is the operator's step. The same holds
|
|
808
|
+
after rotating `immudb.adminPassword`.
|
|
809
|
+
|
|
710
810
|
## Choosing the application's store — and what it obliges
|
|
711
811
|
|
|
712
812
|
`applicationDatabase` selects where THIS application's resources persist, and it
|
|
@@ -769,6 +869,7 @@ Read `references/framework-infrastructure-host-api.md` for the source-backed con
|
|
|
769
869
|
- [ ] Infra file is a single `defineInfraEnvConfig({...})` default export
|
|
770
870
|
- [ ] Environment uses a common named ID or a valid custom slug; runtime and backing-service source use their typed enums
|
|
771
871
|
- [ ] Every backing service the app uses is declared with a valid `source`
|
|
872
|
+
- [ ] Every declaration is one the platform can serve (see "What each kind can be declared as today") — `wildo config validate --domain config` reports no `names no infrastructure provider` / `which no provider module can serve yet` finding
|
|
772
873
|
- [ ] Every capability-required backing service is declared in **every** environment (see "Capability-driven backing services") — `wildo config sync` emits no missing-backing-store warning
|
|
773
874
|
- [ ] No secret values in the file (passwords, keys, tokens — all referenced via the secrets store)
|
|
774
875
|
- [ ] Every vendor identifier issued per deployment (OAuth client ID, frontend SDK DSN or site key) is authored in THIS file's `providerConfigurations`, and none is authored in `wildo.saas.config.ts`
|
|
@@ -787,6 +888,7 @@ Run from the app root, substituting `<env>`:
|
|
|
787
888
|
| Environment identifier matches its directory and passes `WildoEnvironmentIdSchema` | Inspect `environment` in the authored file; custom remote slugs are supported. |
|
|
788
889
|
| Typed `WildoDeploymentRuntime` enum used | `rg -n "runtime:\s*WildoDeploymentRuntime\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
789
890
|
| Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
891
|
+
| Every `MANAGED` declaration is MongoDB Atlas (anything else is refused) | `rg -n "BackingServiceSource\.MANAGED" infrastructure/*/wildo.infra.*.config.ts` — every hit must be `mongodb` with `provider: 'atlas'` |
|
|
790
892
|
| Audit capability has an audit store in EVERY env (both sides must match) | `rg -n "COMPLIANCE_AUDIT_TRAIL" wildo.saas.config.ts` then `rg -ln "immudb:" infrastructure/*/wildo.infra.*.config.ts` |
|
|
791
893
|
| **No secrets** in infra file (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
792
894
|
| Custom environment uses the remote filename | Inspect `infrastructure/<env>/wildo.infra.remote.config.ts` for every non-local ID. |
|
|
@@ -804,6 +906,7 @@ runtime/source enums. Keep secret values outside authored infrastructure.
|
|
|
804
906
|
| "Drop the password into the config for now, I'll move it later" | Secrets in git are an outage waiting to happen. Use the secrets store from the first commit; "later" never arrives. |
|
|
805
907
|
| "Every environment ID must be a `WildoEnvironment` member" | The enum supplies common names; custom validated slugs are supported. Only `local` selects local behavior, so ensure a custom name is intentional. |
|
|
806
908
|
| "Skip declaring `clamav` — we don't use virus scanning yet" | If the app's bootstrap initializes the service, the infra config must declare it. Missing entries fail bootstrap with cryptic `undefined` errors. |
|
|
909
|
+
| "Declare the managed Postgres / Redis we plan to use now, and wire it up later" | A declaration the platform cannot serve is refused outright, and before that refusal existed it silently produced a credential for the wrong server. Declare `SELF` until the framework release that serves the managed option; there is no flag that accepts it early. |
|
|
807
910
|
| "Copy production URL into the example config to keep them in sync" | Production URLs in non-production configs are catastrophic when accidentally promoted. Keep production values exclusively in production config + secrets. |
|
|
808
911
|
|
|
809
912
|
## Red Flags
|
|
@@ -816,6 +919,9 @@ runtime/source enums. Keep secret values outside authored infrastructure.
|
|
|
816
919
|
environment stored under the local filename
|
|
817
920
|
- Backing service used by the app but not declared in the infra
|
|
818
921
|
config (bootstrap fails with `undefined` connection params)
|
|
922
|
+
- `source: BackingServiceSource.MANAGED` on anything but `mongodb`
|
|
923
|
+
with `provider: 'atlas'` (catch with the **Every `MANAGED`
|
|
924
|
+
declaration is MongoDB Atlas** grep above)
|
|
819
925
|
- `devCompanion` declared in a remote config (the field is local-only;
|
|
820
926
|
the typed factory may accept it but the companion won't bind correctly)
|
|
821
927
|
- `remoteProvider` or `deployment` declared in a local config (same
|