@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,85 @@
|
|
|
1
|
+
# Remote references — a related record lands as a real local foreign key
|
|
2
|
+
|
|
3
|
+
Read this when:
|
|
4
|
+
|
|
5
|
+
- a remote entity carries a reference to another record — an Odoo many2one (`parent_id`,
|
|
6
|
+
`partner_id`, `company_id`), an OData navigation key (`ParentAccountID`) — and the local copy must
|
|
7
|
+
LINK to the local copy of that record instead of holding the remote id;
|
|
8
|
+
- a run report shows `pendingReferences` above zero and you want to know what it is waiting for;
|
|
9
|
+
- startup refused a `REMOTE_REFERENCE` mapping entry.
|
|
10
|
+
|
|
11
|
+
## What to declare
|
|
12
|
+
|
|
13
|
+
A mapping entry of kind `REMOTE_REFERENCE` on the pipeline, plus the relationship it writes:
|
|
14
|
+
|
|
15
|
+
- `remoteField` — the remote reference field (`parent_id`);
|
|
16
|
+
- `localField` — the local foreign key. It must be the `foreignKeyField` of a declared relationship
|
|
17
|
+
between this resource and the target (a SELF-reference, such as an Odoo contact's parent company,
|
|
18
|
+
is a relationship whose two ends are this resource). Declare the field as an optional string
|
|
19
|
+
foreign key, `.excludeFromCreate().excludeFromUpdate()` like every pipeline-written field;
|
|
20
|
+
- `targetResourceType` — the LOCAL resource the reference resolves to. It must be either a pipeline
|
|
21
|
+
destination reading the SAME system of record (this resource itself, for a self-reference) or a
|
|
22
|
+
virtual read-through resource bound to it, keyed by ONE key field;
|
|
23
|
+
- `valueShape` — optional. An Odoo source defaults to the many2one pair (`[id, display_name]`, or
|
|
24
|
+
`false` when empty); any other source defaults to a plain scalar key;
|
|
25
|
+
- `unresolved` — optional, see below.
|
|
26
|
+
|
|
27
|
+
The target key is built with the TARGET binding's key codec, so the reference resolves to exactly
|
|
28
|
+
the row the target's own pipeline (or virtual binding) identifies by that key.
|
|
29
|
+
|
|
30
|
+
## When the foreign key is written — and why ordering never matters
|
|
31
|
+
|
|
32
|
+
Not during the row transform: AFTER the load, in its own phase, on every run. So:
|
|
33
|
+
|
|
34
|
+
- a child extracted BEFORE its parent in the same pass still links — both rows exist by then;
|
|
35
|
+
- a self-reference and a cycle between two pipelines need no ordering;
|
|
36
|
+
- the load never touches the foreign key, and the resolution only writes it when its value changes.
|
|
37
|
+
|
|
38
|
+
For a VIRTUAL target the foreign key is the synthesized key itself (a virtual row's id IS that key),
|
|
39
|
+
so nothing is looked up. For a pipeline target it is the local id of the row holding that key.
|
|
40
|
+
|
|
41
|
+
On MongoDB a foreign key to a virtual resource is stored as that string key — the framework decides it
|
|
42
|
+
from your relationship when it builds the model — while every foreign key to a local resource stays an
|
|
43
|
+
ObjectId. Read it back as the string it is; nothing about the local foreign keys changes.
|
|
44
|
+
|
|
45
|
+
## When the target has no local row yet
|
|
46
|
+
|
|
47
|
+
`unresolved: LEAVE_PENDING` (the default): the row loads with the foreign key EMPTY and the reference
|
|
48
|
+
is kept PENDING. Every later run of the pipeline — full, partial or incremental — retries every
|
|
49
|
+
pending reference at its end, so the first run after the target's row arrives writes the foreign key
|
|
50
|
+
even if the referencing row never changes again (an incremental pass would never re-read it).
|
|
51
|
+
Each run reports `pendingReferences` (what is still waiting) and `resolvedReferences` (foreign keys
|
|
52
|
+
it wrote) on its report and on the stored last-run summary (`GET …/pipelines`).
|
|
53
|
+
|
|
54
|
+
Typical causes of a reference that stays pending: the target record is outside the pipeline's
|
|
55
|
+
`sourceFilter`, in a partition nobody assigned, or not loaded yet by the target's own pipeline.
|
|
56
|
+
|
|
57
|
+
`unresolved: REJECT_ROW`: a row whose target is neither already loaded nor among the rows of the same
|
|
58
|
+
PAGE is REJECTED (counted in `rejectedRows`, its previous local version kept). A run loads page by page,
|
|
59
|
+
so a target on a later page of the same run is not loaded yet: a self-referencing entity whose source
|
|
60
|
+
does not order parents before children rejects those children until the next pass — declare
|
|
61
|
+
`LEAVE_PENDING` for it, which links them at the end of the same run. A rejected row is retried only
|
|
62
|
+
when the row is read again — every full pass, or an incremental pass after it changes. A virtual
|
|
63
|
+
target never rejects. The check runs before the load: a target the same full pass then deletes as an
|
|
64
|
+
orphan leaves the row loaded, with its foreign key empty and pending.
|
|
65
|
+
|
|
66
|
+
Removing a `REMOTE_REFERENCE` entry cleans its pending references but leaves the foreign keys it
|
|
67
|
+
already wrote: nothing owns that field any more, so clear it yourself if it should be empty.
|
|
68
|
+
|
|
69
|
+
An empty remote reference (`false`, `null`, `''`) empties the foreign key. A reference whose target
|
|
70
|
+
record was erased (an erasure suppression) resolves to NO link and is never kept pending.
|
|
71
|
+
|
|
72
|
+
## The one startup refusal worth knowing: an orphan cascade
|
|
73
|
+
|
|
74
|
+
If the target's pipeline deletes rows whose records vanish (`orphanPolicy: DELETE` on a CLOSED
|
|
75
|
+
population) AND your relationship tears children down with their parent (`onParentDelete` enabled,
|
|
76
|
+
delete or scrub), then a record disappearing from the TARGET's source deletes rows of THIS resource
|
|
77
|
+
too. Startup refuses that combination until you say you mean it with
|
|
78
|
+
`orphanCascadeAcknowledged: true` on the mapping entry — or change one of the two policies.
|
|
79
|
+
`REFUSE_WHILE_CHILDREN_EXIST` needs no acknowledgement: it deletes nothing.
|
|
80
|
+
|
|
81
|
+
## Not supported yet
|
|
82
|
+
|
|
83
|
+
- a target keyed by more than one key field (a reference carries one value);
|
|
84
|
+
- a target on another system of record — a remote id only names a record of the deployment it was
|
|
85
|
+
read from.
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# A REST source in a pipeline — the statement keyset
|
|
2
|
+
|
|
3
|
+
Read this when a pipeline's source is a REST_JSON system of record — `salesforce`, `netsuite`, or any
|
|
4
|
+
REST API read through a query statement.
|
|
5
|
+
|
|
6
|
+
- why a REST source needs a keyset at all, and why offset paging is refused;
|
|
7
|
+
- what you declare, and what the engine writes into the statement for you;
|
|
8
|
+
- what is refused at startup, and what is refused at run time.
|
|
9
|
+
|
|
10
|
+
## Why a keyset, and never offsets
|
|
11
|
+
|
|
12
|
+
A pipeline pass can span many runs. Paging by OFFSET reads "rows 200–299 of the current result", and
|
|
13
|
+
the current result moves whenever a row is inserted or deleted before that position: an insert makes
|
|
14
|
+
the next page repeat a row it already read, a delete makes it skip one. A skipped row is then absent
|
|
15
|
+
from the pass, and an `orphanPolicy: 'delete'` deletes its local copy.
|
|
16
|
+
|
|
17
|
+
A KEYSET page reads "the next N rows after the last key I saw, in key order". A row inserted or deleted
|
|
18
|
+
anywhere does not move the rows after the cursor, so nothing is read twice or skipped: a row inserted
|
|
19
|
+
with a higher key is read later in the same pass, and one with a lower key by the next pass. This is
|
|
20
|
+
how Odoo sources are already walked (by `id`).
|
|
21
|
+
|
|
22
|
+
So a REST source feeds a pipeline only when its binding declares a keyset. An API that can only page by
|
|
23
|
+
offset, with no key a query can filter and order on, cannot feed a pipeline; read it through a virtual
|
|
24
|
+
resource instead.
|
|
25
|
+
|
|
26
|
+
## What you declare
|
|
27
|
+
|
|
28
|
+
On the binding's `list` member, which already reads through a `statement` (SOQL, SuiteQL):
|
|
29
|
+
|
|
30
|
+
```ts
|
|
31
|
+
list: {
|
|
32
|
+
method: 'POST',
|
|
33
|
+
pathTemplate: '/services/rest/query/v1/suiteql',
|
|
34
|
+
resultPath: 'items',
|
|
35
|
+
// NetSuite pages in the URL while the statement is in the body.
|
|
36
|
+
pagingParams: { limitParam: 'limit', offsetParam: 'offset', placement: HttpApiRestParameterPlacement.QUERY_STRING },
|
|
37
|
+
staticHeaders: { Prefer: 'transient' },
|
|
38
|
+
statement: {
|
|
39
|
+
language: HttpApiQueryStatementLanguage.SUITEQL,
|
|
40
|
+
parameterName: 'q',
|
|
41
|
+
keyset: { keyRemoteField: 'id' },
|
|
42
|
+
},
|
|
43
|
+
},
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
For Salesforce the same `keyset: { keyRemoteField: 'Id' }`, on a GET `list` that declares
|
|
47
|
+
`cursorPath: 'nextRecordsUrl'`.
|
|
48
|
+
|
|
49
|
+
You write no statement text, no `:cursor` placeholder and no `ORDER BY`. The engine builds each page:
|
|
50
|
+
|
|
51
|
+
| language | one page |
|
|
52
|
+
|---|---|
|
|
53
|
+
| SOQL | `SELECT Id, <mapped> FROM Account WHERE <sourceFilter> AND Id > '<last Id>' ORDER BY Id ASC LIMIT <n>` |
|
|
54
|
+
| SuiteQL | `SELECT id, <mapped> FROM customer WHERE <sourceFilter> AND id > <last id> ORDER BY id ASC`, with `limit=<n>&offset=0` |
|
|
55
|
+
|
|
56
|
+
The cursor the pipeline stores between runs is the last KEY of the page. It is never the vendor's
|
|
57
|
+
continuation link: Salesforce may answer one `LIMIT` query in several batches with a `nextRecordsUrl`,
|
|
58
|
+
and the engine follows those batches to the end of the page, then drops the link. How long such a
|
|
59
|
+
locator lives is not documented, so nothing depends on one surviving until the next run.
|
|
60
|
+
|
|
61
|
+
## Refused at startup
|
|
62
|
+
|
|
63
|
+
- **No keyset** on a REST pipeline source — offset paging is refused, whatever the vendor offers.
|
|
64
|
+
- **The keyset is not the binding's single key field** — it must name the key field, which is unique
|
|
65
|
+
and immutable. A composite key is refused (one component is not unique), and so is a GUID or datetime
|
|
66
|
+
key (the engine must be able to check the key's order; see below).
|
|
67
|
+
- **A SOQL keyset without `cursorPath`**, or **a SuiteQL keyset without `pagingParams`** — the page
|
|
68
|
+
must be bounded, and read to its end.
|
|
69
|
+
- **A keyset on any member but `list`** — it is how a pipeline walks a collection.
|
|
70
|
+
- **A SuiteQL POST whose `pagingParams` has no `placement: 'query-string'`** — NetSuite reads the paging
|
|
71
|
+
from the URL; placed by method, the limit lands in the body and bounds nothing. This applies to every
|
|
72
|
+
SuiteQL member, read-through included.
|
|
73
|
+
|
|
74
|
+
`incremental` is not available on a REST source: it runs FULL passes, each walked by its keyset.
|
|
75
|
+
|
|
76
|
+
## Refused at run time
|
|
77
|
+
|
|
78
|
+
The engine checks every page before trusting its last key: each key must be greater than the one
|
|
79
|
+
before it, and than the cursor — an INTEGER key as a number, a STRING key by character code, so
|
|
80
|
+
`'B…'` sorts before `'a…'` (Salesforce's own Id order). A page that breaks this is refused rather than
|
|
81
|
+
used, because a cursor taken from an out-of-order page skips rows. A vendor that orders the key by a
|
|
82
|
+
locale collation cannot be walked by keyset.
|
|
83
|
+
|
|
84
|
+
A page with more rows than asked is refused too: the vendor ignored the bound. The usual cause is
|
|
85
|
+
paging parameters placed where the vendor does not read them — see `placement` above.
|
|
@@ -0,0 +1,442 @@
|
|
|
1
|
+
# Running an action on a system of record
|
|
2
|
+
|
|
3
|
+
Read this when the application must make the ERP DO something that is not a row write: post a draft
|
|
4
|
+
invoice (Odoo `account.move` `action_post`), confirm a sales order, call an OData bound or unbound
|
|
5
|
+
action. A row write — create, update, delete one row — is `writableVerbs` instead
|
|
6
|
+
(`references/read-through-writes.md`).
|
|
7
|
+
|
|
8
|
+
## One lane, and why it is not a provider operation
|
|
9
|
+
|
|
10
|
+
The system of record is read and acted on with the DEPLOYMENT's own service identity, and nothing
|
|
11
|
+
else can spend it. An action therefore runs only through the system-of-record action executor:
|
|
12
|
+
|
|
13
|
+
- **never** as a provider operation — `POST /provider-operations/...` serves connectors a person or an
|
|
14
|
+
organization connected, and it cannot name a system-of-record instance or one of its actions;
|
|
15
|
+
- **never** by reaching the credential yourself — the systems-of-record registry is not exported and
|
|
16
|
+
not resolvable from application code.
|
|
17
|
+
|
|
18
|
+
If the same vendor is ALSO a connector the application offers its customers (their own account), that
|
|
19
|
+
is a separate declaration under `providers`, with its own connections. The two share a vendor name for
|
|
20
|
+
display, never a credential.
|
|
21
|
+
|
|
22
|
+
## Declare the action on a binding
|
|
23
|
+
|
|
24
|
+
Actions live on a read-through resource's `httpApiBinding.actions`, keyed by YOUR name for the action
|
|
25
|
+
(lowerCamelCase — `postInvoice`), which is what code, roles and audit rows use. The vendor's method is
|
|
26
|
+
in `call`:
|
|
27
|
+
|
|
28
|
+
| you want | `target` | `call` |
|
|
29
|
+
|---|---|---|
|
|
30
|
+
| an Odoo recordset method (`action_post`, `action_confirm`) | `record` | `{ shape: 'odoo-execute-kw', method, inputPlacement }` |
|
|
31
|
+
| an Odoo model method (`create`) | `none` | `{ shape: 'odoo-execute-kw', method, model?, inputPlacement }` |
|
|
32
|
+
| an OData bound action | `record` | `{ shape: 'odata-bound-action', qualifiedName: 'Namespace.Action' }` |
|
|
33
|
+
| an OData unbound action import | `none` | `{ shape: 'odata-unbound-action', actionImport }` |
|
|
34
|
+
|
|
35
|
+
Declare a RECORD action on the binding of the entity it acts on: that binding's key decodes the
|
|
36
|
+
target id, and its read gates decide which records a caller can reach. A record-free action goes on
|
|
37
|
+
the binding of the model it is called on.
|
|
38
|
+
|
|
39
|
+
Each declaration also carries:
|
|
40
|
+
|
|
41
|
+
- `input` — a Zod OBJECT schema. It is parsed STRICTLY: a key it does not name is refused, never
|
|
42
|
+
forwarded to the vendor. For Odoo, `inputPlacement` says where it goes — `keyword-arguments` (the
|
|
43
|
+
default), `positional` (`create(vals)`), or `none` (the method takes only its records; the input must
|
|
44
|
+
then be `z.object({})`).
|
|
45
|
+
- `output` (optional) — a Zod schema the vendor's answer is parsed through before you receive it.
|
|
46
|
+
- `writes` — whether it changes remote state. A writing action REQUIRES an Idempotency-Key from every
|
|
47
|
+
caller, and an interrupted attempt is an unknown outcome rather than a failure.
|
|
48
|
+
- `retrySafe` — `false` unless the VENDOR makes a repeated call harmless. Odoo offers no such
|
|
49
|
+
mechanism, so an Odoo action is never retry-safe.
|
|
50
|
+
- `roles` — the role keys admitted, held in the owner organization.
|
|
51
|
+
- `admitsSystemInitiation` — whether a context with no user (a batch, a cron, a webhook, an autonomous
|
|
52
|
+
agent) may run it. Off by default; when on, it acts organization-wide for the owner.
|
|
53
|
+
- `partitionStance` — for a RECORD-FREE action on a PARTITIONED instance, required: either
|
|
54
|
+
`{ kind: 'partition-neutral', reason }` (why it reaches no company's data), or
|
|
55
|
+
`{ kind: 'member-unit-partition', parameter: 'company_id' }` (the engine writes the caller's unit's
|
|
56
|
+
partition into that parameter, exactly as a read-through create is placed; the input may not declare
|
|
57
|
+
it).
|
|
58
|
+
|
|
59
|
+
Refused at authoring: an action on a REST_JSON binding, a call shape of another dialect, an Odoo READ
|
|
60
|
+
method (`search_read` and friends — reads go through the resource, where they are confined), `write`
|
|
61
|
+
or `unlink` as a record action (open them through `writableVerbs`), a record action naming another
|
|
62
|
+
model. Refused at startup: a call shape the vendor facet does not list, a record-free action on a
|
|
63
|
+
partitioned instance with no stance, two actions of the same name on one instance.
|
|
64
|
+
|
|
65
|
+
## Import Origins
|
|
66
|
+
|
|
67
|
+
- `@wildo-ai/saas-models`
|
|
68
|
+
|
|
69
|
+
## Source Excerpts
|
|
70
|
+
|
|
71
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
72
|
+
|
|
73
|
+
```typescript
|
|
74
|
+
/**
|
|
75
|
+
* The wire SHAPE of a vendor action — how the engine calls it. Declared by the VENDOR FACET (which shapes its product
|
|
76
|
+
* supports, `actionCallShapes`) and chosen per action by its declaration.
|
|
77
|
+
*
|
|
78
|
+
* REST_JSON has no member: an arbitrary REST surface has no action convention to compile against, and a declared method
|
|
79
|
+
* plus path template is a design of its own. A REST_JSON binding declaring an action is refused by name. (REST_JSON
|
|
80
|
+
* ROW writes are declared per verb since #1728 — `operations.create` / `update` / `delete` — because a row write has a
|
|
81
|
+
* fixed meaning a method and a path can carry; an action's meaning is the vendor's, and has no such shape.)
|
|
82
|
+
*/
|
|
83
|
+
export enum SystemOfRecordActionCallShape {
|
|
84
|
+
/**
|
|
85
|
+
* Odoo's `object.execute_kw(db, uid, key, model, method, positional, keyword)` — any public model method, the
|
|
86
|
+
* credential inside the RPC arguments. A record-targeted call passes the record ids as its first positional
|
|
87
|
+
* argument, which is how Odoo addresses a recordset method such as `action_post`.
|
|
88
|
+
*
|
|
89
|
+
* spec-cite: Odoo 18.0 developer documentation, External API — "Calling methods" (the execute_kw argument layout).
|
|
90
|
+
*/
|
|
91
|
+
ODOO_EXECUTE_KW = 'odoo-execute-kw',
|
|
92
|
+
/**
|
|
93
|
+
* An OData v4 BOUND action: `POST <EntitySet>(<key>)/<Namespace>.<Action>`, parameters in the JSON body.
|
|
94
|
+
*
|
|
95
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §11.5.5 (Actions) and §11.5.5.1 (Invoking an Action).
|
|
96
|
+
*/
|
|
97
|
+
ODATA_BOUND_ACTION = 'odata-bound-action',
|
|
98
|
+
/**
|
|
99
|
+
* An OData v4 UNBOUND action reached through its action import: `POST /<ActionImport>`, parameters in the JSON body.
|
|
100
|
+
*
|
|
101
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §11.5.5.1 (Invoking an Action).
|
|
102
|
+
*/
|
|
103
|
+
ODATA_UNBOUND_ACTION = 'odata-unbound-action',
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* The dialect each call shape is spoken over. Total over {@link SystemOfRecordActionCallShape}, so a new shape is a
|
|
108
|
+
* compile error here until somebody says which dialect it belongs to.
|
|
109
|
+
*/
|
|
110
|
+
export const SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT: Readonly<Record<SystemOfRecordActionCallShape, HttpApiTransportDialect>> = Object.freeze({
|
|
111
|
+
[SystemOfRecordActionCallShape.ODOO_EXECUTE_KW]: HttpApiTransportDialect.ODOO_JSONRPC,
|
|
112
|
+
[SystemOfRecordActionCallShape.ODATA_BOUND_ACTION]: HttpApiTransportDialect.ODATA,
|
|
113
|
+
[SystemOfRecordActionCallShape.ODATA_UNBOUND_ACTION]: HttpApiTransportDialect.ODATA,
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
/** What an action acts ON. */
|
|
117
|
+
export enum SystemOfRecordActionTarget {
|
|
118
|
+
/**
|
|
119
|
+
* ONE record of the binding's entity, addressed by its synthesized id. The record is READ FIRST through the binding's
|
|
120
|
+
* read gates (owner organization, partition), so a caller can act only on a record it could see — and a record
|
|
121
|
+
* outside its partition answers as absent, exactly as a read answers.
|
|
122
|
+
*/
|
|
123
|
+
RECORD = 'record',
|
|
124
|
+
/** No record: a model-level Odoo method (`create`) or an OData unbound action. */
|
|
125
|
+
NONE = 'none',
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/** Where an Odoo action's validated input goes in the `execute_kw` call. */
|
|
129
|
+
export enum SystemOfRecordOdooActionInputPlacement {
|
|
130
|
+
/** The input object is the keyword-argument dict. The default: most recordset methods take options by keyword. */
|
|
131
|
+
KEYWORD_ARGUMENTS = 'keyword-arguments',
|
|
132
|
+
/**
|
|
133
|
+
* The input object is the (next) POSITIONAL argument — after the id list on a record-targeted action, first on a
|
|
134
|
+
* record-free one. `create(vals)` is the canonical case.
|
|
135
|
+
*/
|
|
136
|
+
POSITIONAL = 'positional',
|
|
137
|
+
/** The method takes nothing beyond its records (`action_post`). The declared input must then be empty. */
|
|
138
|
+
NONE = 'none',
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* How a RECORD-FREE action relates to the instance's partitions (#1058), required at boot when the instance is
|
|
143
|
+
* partitioned. A record-targeted action needs none: the record it reads first carries its partition.
|
|
144
|
+
*/
|
|
145
|
+
export enum SystemOfRecordActionPartitionStanceKind {
|
|
146
|
+
/**
|
|
147
|
+
* The action touches no partitioned data — a lookup of a vendor setting, an action whose effect no partition owns.
|
|
148
|
+
* The declaration must say WHY in `reason`, because a claim nothing checks has to be one a reviewer can read.
|
|
149
|
+
*/
|
|
150
|
+
PARTITION_NEUTRAL = 'partition-neutral',
|
|
151
|
+
/**
|
|
152
|
+
* The action CARRIES the partition as one of its inputs, and the engine derives it from the caller's organization
|
|
153
|
+
* unit exactly as a read-through create is placed (#1679): a member of one unit lands in its partition, a member of
|
|
154
|
+
* several names the unit, and a caller may never supply the partition value itself.
|
|
155
|
+
*/
|
|
156
|
+
MEMBER_UNIT_PARTITION = 'member-unit-partition',
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
export const SystemOfRecordActionPartitionStanceSchema = z.discriminatedUnion('kind', [
|
|
160
|
+
z.strictObject({
|
|
161
|
+
kind: z.literal(SystemOfRecordActionPartitionStanceKind.PARTITION_NEUTRAL),
|
|
162
|
+
/** Why no partition is reached. Read by a reviewer; nothing can verify it, which is why it is required. */
|
|
163
|
+
reason: z.string().trim().min(20, 'Say why this action reaches no partitioned data — a reviewer reads this.'),
|
|
164
|
+
}),
|
|
165
|
+
z.strictObject({
|
|
166
|
+
kind: z.literal(SystemOfRecordActionPartitionStanceKind.MEMBER_UNIT_PARTITION),
|
|
167
|
+
/**
|
|
168
|
+
* The REMOTE parameter the placed partition value is written into (`company_id`): a key of the Odoo keyword
|
|
169
|
+
* arguments or of the positional input object, or a member of the OData body. The caller's input may not carry it.
|
|
170
|
+
*/
|
|
171
|
+
parameter: z.string().min(1).max(120),
|
|
172
|
+
}),
|
|
173
|
+
]);
|
|
174
|
+
export type SystemOfRecordActionPartitionStance = z.infer<typeof SystemOfRecordActionPartitionStanceSchema>;
|
|
175
|
+
|
|
176
|
+
export const SystemOfRecordActionCallSchema = z.discriminatedUnion('shape', [
|
|
177
|
+
z.strictObject({
|
|
178
|
+
shape: z.literal(SystemOfRecordActionCallShape.ODOO_EXECUTE_KW),
|
|
179
|
+
/** The model method, in Odoo's own spelling (`action_post`, `create`). */
|
|
180
|
+
method: z.string().regex(/^[a-z_][a-z0-9_]*$/, 'An Odoo method name is snake_case.').max(120),
|
|
181
|
+
/**
|
|
182
|
+
* The model the call is made on, for a RECORD-FREE action only. A record-targeted action acts on the binding's own
|
|
183
|
+
* model — the one its key codec and read gates describe — so naming another would decode the id against the wrong
|
|
184
|
+
* entity. Absent means the binding's `entityRef`.
|
|
185
|
+
*/
|
|
186
|
+
model: z.string().regex(/^[a-z_][a-z0-9_.]*$/, 'An Odoo model name is dotted snake_case.').max(120).optional(),
|
|
187
|
+
inputPlacement: z.enum(SystemOfRecordOdooActionInputPlacement).default(SystemOfRecordOdooActionInputPlacement.KEYWORD_ARGUMENTS),
|
|
188
|
+
}),
|
|
189
|
+
z.strictObject({
|
|
190
|
+
shape: z.literal(SystemOfRecordActionCallShape.ODATA_BOUND_ACTION),
|
|
191
|
+
/** The namespace-qualified action name (`Microsoft.Dynamics.CRM.WinOpportunity`). */
|
|
192
|
+
qualifiedName: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)+$/, 'A bound action is named Namespace.Action.').max(200),
|
|
193
|
+
}),
|
|
194
|
+
z.strictObject({
|
|
195
|
+
shape: z.literal(SystemOfRecordActionCallShape.ODATA_UNBOUND_ACTION),
|
|
196
|
+
/** The action import's name, as the service root exposes it. */
|
|
197
|
+
actionImport: z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/, 'An action import is a simple identifier.').max(200),
|
|
198
|
+
}),
|
|
199
|
+
]);
|
|
200
|
+
export type SystemOfRecordActionCall = z.infer<typeof SystemOfRecordActionCallSchema>;
|
|
201
|
+
|
|
202
|
+
/**
|
|
203
|
+
* The application's NAME for an action — lowerCamelCase, and distinct from the vendor's method name on purpose: the
|
|
204
|
+
* name is what code, roles and audit rows speak (`postInvoice`), the call is what the vendor understands
|
|
205
|
+
* (`account.move` `action_post`). Unique per INSTANCE across every binding, checked at boot, because callers address an
|
|
206
|
+
* action by `(system, action)`.
|
|
207
|
+
*/
|
|
208
|
+
export const SYSTEM_OF_RECORD_ACTION_NAME_PATTERN = /^[a-z][a-zA-Z0-9]*$/;
|
|
209
|
+
export const SystemOfRecordActionNameSchema = z.string().regex(SYSTEM_OF_RECORD_ACTION_NAME_PATTERN, 'An action name is lowerCamelCase.').max(64);
|
|
210
|
+
|
|
211
|
+
/** A Zod OBJECT schema carried as a value — an action's input contract. */
|
|
212
|
+
const zodObjectSchemaValue = z.custom<z.ZodObject<z.ZodRawShape>>(
|
|
213
|
+
(value) => value !== null && typeof value === 'object' && isZodObject(value as z.ZodTypeAny),
|
|
214
|
+
{ message: 'An action input is a Zod object schema (z.object({...})).' },
|
|
215
|
+
);
|
|
216
|
+
/** Any Zod schema carried as a value — an action's output contract. */
|
|
217
|
+
const zodSchemaValue = z.custom<z.ZodTypeAny>(
|
|
218
|
+
(value) => value !== null && typeof value === 'object' && typeof (value as { safeParse?: unknown }).safeParse === 'function',
|
|
219
|
+
{ message: 'An action output is a Zod schema.' },
|
|
220
|
+
);
|
|
221
|
+
|
|
222
|
+
/** ONE declared action. */
|
|
223
|
+
export const SystemOfRecordActionDeclarationSchema = z.strictObject({
|
|
224
|
+
target: z.enum(SystemOfRecordActionTarget),
|
|
225
|
+
call: SystemOfRecordActionCallSchema,
|
|
226
|
+
/**
|
|
227
|
+
* The input contract, validated BEFORE anything is sent. Strict parsing is the caller's contract: a key the schema
|
|
228
|
+
* does not declare is refused rather than forwarded, so nothing reaches the vendor that the author did not name.
|
|
229
|
+
*/
|
|
230
|
+
input: zodObjectSchemaValue,
|
|
231
|
+
/**
|
|
232
|
+
* The result contract. When declared, the vendor's answer is parsed through it and only the parsed value is returned;
|
|
233
|
+
* an answer it rejects after the vendor APPLIED the action is reported as an unknown outcome, never as "not done".
|
|
234
|
+
* Absent means the result is returned as the vendor sent it.
|
|
235
|
+
*/
|
|
236
|
+
output: zodSchemaValue.optional(),
|
|
237
|
+
/**
|
|
238
|
+
* Whether the action CHANGES remote state. A writing action must carry an Idempotency-Key from EVERY caller, because a
|
|
239
|
+
* remote change cannot be rolled back, and its interrupted attempts are reported as an unknown outcome rather than as
|
|
240
|
+
* a failure. A non-writing action (a vendor computation that changes nothing) needs neither.
|
|
241
|
+
*/
|
|
242
|
+
writes: z.boolean(),
|
|
243
|
+
/**
|
|
244
|
+
* Whether the VENDOR makes a repeated call harmless, so the transport may re-send it after a timeout or a 5xx. False
|
|
245
|
+
* unless the vendor offers an idempotency mechanism for this call; Odoo offers none, so no Odoo action is retry-safe.
|
|
246
|
+
* A writing action is never re-sent without an Idempotency-Key, whatever this says.
|
|
247
|
+
*/
|
|
248
|
+
retrySafe: z.boolean().default(false),
|
|
249
|
+
/**
|
|
250
|
+
* The role keys admitted to run it, held in the OWNER organization (an organization role) or at application scope. A
|
|
251
|
+
* role held only inside an organization UNIT admits the action on that unit's partition alone.
|
|
252
|
+
*/
|
|
253
|
+
roles: z.array(z.string().min(1)).min(1),
|
|
254
|
+
/**
|
|
255
|
+
* Whether a context with NO user and no machine principal — the engine's own batch, cron and queue work, a webhook, an
|
|
256
|
+
* autonomous agent with nobody behind it — may run it. Such a context then acts ORGANIZATION-WIDE on the owner
|
|
257
|
+
* organization's behalf, which is exactly why it is off unless declared.
|
|
258
|
+
*/
|
|
259
|
+
admitsSystemInitiation: z.boolean().default(false),
|
|
260
|
+
/** A record-free action's relation to the instance's partitions; see {@link SystemOfRecordActionPartitionStanceKind}. */
|
|
261
|
+
partitionStance: SystemOfRecordActionPartitionStanceSchema.optional(),
|
|
262
|
+
/**
|
|
263
|
+
* The resource operation that is this action's HTTP door, when it has one: a custom operation of the SAME resource
|
|
264
|
+
* whose implementation hands the request to the system-of-record action executor. Absent means the action is reached
|
|
265
|
+
* from code only.
|
|
266
|
+
*
|
|
267
|
+
* Naming the door HERE is what lets the resource factory tell an action from a row write. Without it, the only thing the
|
|
268
|
+
* factory can see is the verb the operation borrows, and both available borrows were wrong (#1678 review, F1):
|
|
269
|
+
*
|
|
270
|
+
* - borrowing READ made a state-changing route a GET, and its required Idempotency-Key was refused at boot, because a
|
|
271
|
+
* read-shaped operation claims its repeat changes nothing — Your Application' backend could not start;
|
|
272
|
+
* - borrowing UPDATE read as a ROW write, so the factory demanded `writableVerbs: [update]` — a door onto the bound
|
|
273
|
+
* entity's rows that nobody asked for.
|
|
274
|
+
*
|
|
275
|
+
* A named door is exempt from the row-write rules and held to the action's own instead: a WRITING action's door borrows
|
|
276
|
+
* a single-row mutation verb (so its route is not a GET and a retry is keyed), requires the key on every variant, and
|
|
277
|
+
* runs INLINE. See `assertHttpApiWriteDeclarationCoherence`.
|
|
278
|
+
*/
|
|
279
|
+
operation: z.string().min(1).optional(),
|
|
280
|
+
});
|
|
281
|
+
export type SystemOfRecordActionDeclaration = z.infer<typeof SystemOfRecordActionDeclarationSchema>;
|
|
282
|
+
/** What an author writes — defaulted fields optional. */
|
|
283
|
+
export type SystemOfRecordActionDeclarationAuthored = z.input<typeof SystemOfRecordActionDeclarationSchema>;
|
|
284
|
+
|
|
285
|
+
/** Every action a binding declares, keyed by the application's action name. */
|
|
286
|
+
export const SystemOfRecordActionDeclarationsSchema = z.record(SystemOfRecordActionNameSchema, SystemOfRecordActionDeclarationSchema);
|
|
287
|
+
export type SystemOfRecordActionDeclarations = z.infer<typeof SystemOfRecordActionDeclarationsSchema>;
|
|
288
|
+
```
|
|
289
|
+
|
|
290
|
+
## Expose it over HTTP: one custom operation, NAMED as the action's door
|
|
291
|
+
|
|
292
|
+
An action has no route of its own. Its HTTP door is a custom operation on the read-through resource
|
|
293
|
+
that calls the executor, and the action NAMES it: `actions.<name>.operation: '<operationKey>'`. The
|
|
294
|
+
name is what tells the framework this operation runs an ACTION rather than writing a ROW, so it is
|
|
295
|
+
held to the action's rules and exempt from the row-write rules (`writableVerbs` does not have to
|
|
296
|
+
open anything):
|
|
297
|
+
|
|
298
|
+
- for a WRITING action, the door borrows a single-row MUTATION verb — `resourceOperationLike:
|
|
299
|
+
UPDATE` (a keyed `PUT` on the record) — never READ: a read-shaped operation claims a repeat changes
|
|
300
|
+
nothing, and the startup check refuses an `Idempotency-Key` on one; never a bulk verb;
|
|
301
|
+
- `idempotencyKey: REQUIRED` on every variant, and no `serviceRuntimeMode` (it runs INLINE);
|
|
302
|
+
- `requestDto: z.object({})` unless the action takes input — borrowing UPDATE would otherwise
|
|
303
|
+
inherit the resource's whole update contract;
|
|
304
|
+
- `customServiceImplementationModes: [OVERRIDE_ALL]`, and an implementation that only calls
|
|
305
|
+
`utils.systemOfRecordActions.run({ system, action, targetResourceId: id, input, idempotencyKey:
|
|
306
|
+
utils.requestIdempotencyKey, serviceOptions: utils.serviceOptions }, executionContext)` and reads the
|
|
307
|
+
record back.
|
|
308
|
+
|
|
309
|
+
Refused at authoring: a door naming an operation the resource does not declare, and two actions
|
|
310
|
+
naming one door. An action with no `operation` is reachable from code only.
|
|
311
|
+
|
|
312
|
+
A door may carry an `enabledCondition` that reads the record (`post_invoice` is enabled on a DRAFT
|
|
313
|
+
invoice). It is judged on the record as it stands, with one exception: a retry of an APPLIED action
|
|
314
|
+
under the SAME key, by the same caller, on the same record reaches the executor and is answered
|
|
315
|
+
`replayed`, although the first attempt already moved the record out of the state the condition
|
|
316
|
+
admits. A new key on the posted invoice is still refused as disabled, and a caller the door's roles
|
|
317
|
+
refuse never gets that far.
|
|
318
|
+
|
|
319
|
+
Backend services, agent tools and flows call the same `run(...)` through
|
|
320
|
+
`SAAS_SERVICE_TYPES.SystemOfRecordActionExecutorService`, with the execution context they act in.
|
|
321
|
+
|
|
322
|
+
## Import Origins
|
|
323
|
+
|
|
324
|
+
- `@wildo-ai/saas-backend-lib`
|
|
325
|
+
|
|
326
|
+
## Source Excerpts
|
|
327
|
+
|
|
328
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
329
|
+
|
|
330
|
+
```typescript
|
|
331
|
+
*/
|
|
332
|
+
import type { ServiceOptions } from '~wildo-backend-lib/base-classes/models/repositories.backend.schemas';
|
|
333
|
+
import type { ExecutionContext } from '~wildo-backend-lib/runtime/models/execution-context.backend.schemas';
|
|
334
|
+
|
|
335
|
+
/** What a caller asks for. */
|
|
336
|
+
export interface SystemOfRecordActionRequest {
|
|
337
|
+
/** The system-of-record instance, by the name `wildo.saas.config.ts` declares it under (`systemsOfRecord.<name>`). */
|
|
338
|
+
readonly system: string;
|
|
339
|
+
/** The action, by the name a binding of that instance declares it under (`httpApiBinding.actions.<name>`). */
|
|
340
|
+
readonly action: string;
|
|
341
|
+
/** The action's input, validated STRICTLY against its declared schema before anything is sent. */
|
|
342
|
+
readonly input?: Record<string, unknown>;
|
|
343
|
+
/** The record's id, for a RECORD-targeted action — the same synthesized id the read-through resource serves. */
|
|
344
|
+
readonly targetResourceId?: string;
|
|
345
|
+
/**
|
|
346
|
+
* The caller's key for THIS request. REQUIRED for a writing action: a retry under the same key replays the first
|
|
347
|
+
* outcome instead of acting twice, and an unknown outcome is answered again rather than re-sent. A custom operation
|
|
348
|
+
* passes `utils.requestIdempotencyKey`, which its variant receives by declaring `idempotencyKey: REQUIRED`.
|
|
349
|
+
*/
|
|
350
|
+
readonly idempotencyKey?: string;
|
|
351
|
+
/**
|
|
352
|
+
* The unit a record-free action that CARRIES the partition should land in, when the caller belongs to several units
|
|
353
|
+
* owning partitions of the instance. Absent otherwise: a member of one unit lands in its partition.
|
|
354
|
+
*/
|
|
355
|
+
readonly organizationUnitId?: string;
|
|
356
|
+
/**
|
|
357
|
+
* The caller's own service options — passed so the executor can refuse to act inside the caller's database transaction:
|
|
358
|
+
* a remote action cannot roll back with it, and a retried transaction callback would act twice.
|
|
359
|
+
*/
|
|
360
|
+
readonly serviceOptions?: ServiceOptions;
|
|
361
|
+
}
|
|
362
|
+
|
|
363
|
+
/** What became of a request that was NOT refused. A refusal is thrown as a Wildo error carrying a `SystemOfRecordErrorCode`. */
|
|
364
|
+
export enum SystemOfRecordActionRunOutcome {
|
|
365
|
+
/** The system of record performed the action; `result` is its answer (parsed through the declared output schema). */
|
|
366
|
+
APPLIED = 'applied',
|
|
367
|
+
/**
|
|
368
|
+
* A retry under an Idempotency-Key whose first attempt was applied. Nothing was sent, and `result` is absent: the
|
|
369
|
+
* ledger keeps whether it happened, never what the vendor answered.
|
|
370
|
+
*/
|
|
371
|
+
REPLAYED = 'replayed',
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
export interface SystemOfRecordActionRunResult<TResult = unknown> {
|
|
375
|
+
readonly outcome: SystemOfRecordActionRunOutcome;
|
|
376
|
+
readonly result?: TResult;
|
|
377
|
+
/** The record acted on, for a record-targeted action. */
|
|
378
|
+
readonly targetResourceId?: string;
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
/**
|
|
382
|
+
* Runs declared system-of-record actions — resolve it as `SAAS_SERVICE_TYPES.SystemOfRecordActionExecutorService`, or
|
|
383
|
+
* use `utils.systemOfRecordActions` in a custom operation implementation.
|
|
384
|
+
*
|
|
385
|
+
* Every call is authorized (owner organization, the action's roles, the kind of context), confined (the record is read
|
|
386
|
+
* first through the read-through resource's gates; a record-free action obeys its partition stance), sent under the
|
|
387
|
+
* instance's service identity outside any database transaction, and audited on every outcome.
|
|
388
|
+
*/
|
|
389
|
+
export interface SystemOfRecordActionRunner {
|
|
390
|
+
run<TResult = unknown>(request: SystemOfRecordActionRequest, executionContext: ExecutionContext<any>): Promise<SystemOfRecordActionRunResult<TResult>>;
|
|
391
|
+
}
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
## What the executor enforces, in order
|
|
395
|
+
|
|
396
|
+
1. Not inside a database transaction — call it after your transaction has committed.
|
|
397
|
+
2. The action is declared.
|
|
398
|
+
3. The kind of context may start it: a person, an organization machine or an inbound handler (judged
|
|
399
|
+
by roles); a system context only if `admitsSystemInitiation`; never an anonymous, public or
|
|
400
|
+
application-machine one.
|
|
401
|
+
4. It is initiated for the organization that owns the application.
|
|
402
|
+
5. The caller holds one of the action's roles there. A role held only inside some units confines the
|
|
403
|
+
action to those units' partitions, and does not admit it where nothing can confine it.
|
|
404
|
+
6. The input parses; the target is present exactly when the action is record-targeted.
|
|
405
|
+
7. The Idempotency-Key is spent (required for a writing action).
|
|
406
|
+
8. A record action READS the record first through the resource's gates — a record outside the
|
|
407
|
+
caller's partition answers `404`, as a read would. A member-unit action is placed in the caller's
|
|
408
|
+
unit's partition.
|
|
409
|
+
9. The call is sent once, under the instance's identity.
|
|
410
|
+
|
|
411
|
+
An agent or a flow acting for a user is judged exactly as that user, and is recorded as the agent that
|
|
412
|
+
did it; one acting for nobody runs as a system context.
|
|
413
|
+
|
|
414
|
+
## What a caller gets back, and the codes to branch on
|
|
415
|
+
|
|
416
|
+
`run` answers `{ outcome: 'applied', result }`, or `{ outcome: 'replayed' }` for a retry of an applied
|
|
417
|
+
key (nothing is sent again, and the vendor's first answer is not kept). A refusal throws with
|
|
418
|
+
`context.code`:
|
|
419
|
+
|
|
420
|
+
| code | meaning |
|
|
421
|
+
|---|---|
|
|
422
|
+
| `SYSTEM_OF_RECORD_ACTION_ORGANIZATION_NOT_OWNER` | initiated for a tenant that does not own the application |
|
|
423
|
+
| `SYSTEM_OF_RECORD_ACTION_ROLE_NOT_HELD` | none of the action's roles held in the owner organization |
|
|
424
|
+
| `SYSTEM_OF_RECORD_ACTION_INITIATION_NOT_ADMITTED` | this kind of context may not start it |
|
|
425
|
+
| `SYSTEM_OF_RECORD_ACTION_TARGET_NOT_REACHABLE` (`404`) | no record this caller may act on |
|
|
426
|
+
| `SYSTEM_OF_RECORD_ACTION_INPUT_INVALID` | the input does not satisfy the declared schema |
|
|
427
|
+
| `SYSTEM_OF_RECORD_ACTION_IDEMPOTENCY_KEY_REQUIRED` | a writing action without a key |
|
|
428
|
+
| `SYSTEM_OF_RECORD_ACTION_PARTITION_UNIT_REQUIRED` | a member of several units must name one (`organizationUnitId`) |
|
|
429
|
+
| `SYSTEM_OF_RECORD_ACTION_PARTITION_REFUSED` | the unit's partition may not be acted in |
|
|
430
|
+
| `SYSTEM_OF_RECORD_ACTION_REMOTE_REFUSED` | the vendor refused it; nothing happened |
|
|
431
|
+
| `SYSTEM_OF_RECORD_ACTION_NOT_SENT` | it could not be sent (access, handshake, connection, rate budget, the read-first); nothing happened, retry is safe |
|
|
432
|
+
| `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` | sent, and whether it happened is unknown — read the record before acting again; the same key answers this again and never sends twice |
|
|
433
|
+
| `SYSTEM_OF_RECORD_WRITE_IN_PROGRESS` (`409`) | the key is in flight — retry the same request with the same key |
|
|
434
|
+
| `SYSTEM_OF_RECORD_WRITE_IDEMPOTENCY_KEY_REUSED` (`422`) | the key was spent on a different request — never retry it as it is; use a new key. Over HTTP the `422` carries no code: branch on `customMessageReference: 'idempotency_key_reused'` |
|
|
435
|
+
|
|
436
|
+
## What is recorded
|
|
437
|
+
|
|
438
|
+
Every attempt leaves one audit row: `system_of_record_action_executed` (applied, refused by the
|
|
439
|
+
remote, unknown, replayed) or `system_of_record_action_refused` (refused before anything was sent,
|
|
440
|
+
with its code). Both name the instance, the action and the caller; neither carries an input VALUE or
|
|
441
|
+
the vendor's answer — only the input's field names. They map to OCSF API activity `Other` and reach
|
|
442
|
+
the SIEM with a failure outcome for everything that did not happen.
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: resource-mcp-tool-exposure
|
|
3
3
|
description: Expose your app's resource operations (create / read / list / search / update / delete) as MCP (Model Context Protocol) tools that EXTERNAL AI agents can discover and call. Use when the user says "expose my resource as an MCP tool", "let an AI agent create/read/update my <resource>", "add MCP tools", "model context protocol server", "make my resources callable by an agent as tools", "machine / client-credentials access to resource CRUD", "how do agents authenticate to my MCP endpoint", or "agent-callable tools" — i.e. the intent is exposing RESOURCE OPERATIONS as callable tools, NOT conversing with an agentic actor system (that is A2A).
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Expose Resource Operations as MCP Tools — Workflow
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: resource-rag-source-fields
|
|
3
3
|
description: Declare which resource fields feed the application's retrieval corpus with the `.ragSource()` decorator, choose their chunking, wire the embeddings capability, and query that corpus from a flow, actor or agent tool. Use when the user says "make this searchable by AI", "add RAG over our documents", "let the assistant answer from the knowledge base", "index the article body for retrieval", "make uploaded PDFs searchable", "make scanned documents searchable", "add OCR", "read text out of scans", "set up embeddings", "retrieve context for the prompt", "query the knowledge base from my agent", or asks which fields an assistant should be able to quote.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# RAG Source Fields — Workflow
|
|
@@ -75,6 +75,18 @@ export enum EngineCapability {
|
|
|
75
75
|
|
|
76
76
|
EMAIL_TRANSACTIONAL = 'EMAIL_TRANSACTIONAL',
|
|
77
77
|
EMAIL_MARKETING = 'EMAIL_MARKETING',
|
|
78
|
+
/**
|
|
79
|
+
* The application RECEIVES email: work arrives as messages to an address the application routes to
|
|
80
|
+
* an organization, and a channel handler decides what each message causes (#1630). The selected
|
|
81
|
+
* provider hosts the receiving domain, signs a notification per message and serves the message on
|
|
82
|
+
* request; the engine owns verification, deduplication, sender assurance, threads and replies.
|
|
83
|
+
*
|
|
84
|
+
* What it does NOT mean: a verified sender is identification, never authentication. A message's
|
|
85
|
+
* sender assurance gates what a handler accepts and grants no authority — the handler acts with
|
|
86
|
+
* the roles it declares, whoever wrote. Replies go out through `EMAIL_TRANSACTIONAL`, so the two
|
|
87
|
+
* slots may be served by different vendors.
|
|
88
|
+
*/
|
|
89
|
+
EMAIL_INBOUND = 'EMAIL_INBOUND',
|
|
78
90
|
SMS = 'SMS',
|
|
79
91
|
|
|
80
92
|
AI_LLM = 'AI_LLM',
|