@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
|
@@ -10,9 +10,53 @@
|
|
|
10
10
|
|
|
11
11
|
```typescript
|
|
12
12
|
export enum ExternalDataPipelineDirection {
|
|
13
|
+
/**
|
|
14
|
+
* The system of record is the source: a pass reads its rows and loads them into the destination. The mapped fields
|
|
15
|
+
* are remote-authoritative, so callers may not write them.
|
|
16
|
+
*/
|
|
13
17
|
INBOUND = 'inbound',
|
|
18
|
+
/**
|
|
19
|
+
* The destination is the source (#1690): a row created or changed locally is sent to the system of record on the
|
|
20
|
+
* next pass — created there when it has no remote key yet, updated when it has one. The mapped fields are the
|
|
21
|
+
* application's own, so callers write them; the remote key is written by the engine, once, from the create's answer.
|
|
22
|
+
*
|
|
23
|
+
* Only rows of the organization that owns the application are ever sent (a system of record belongs to it alone),
|
|
24
|
+
* and on a partitioned instance only rows whose organization unit is assigned to a partition. A local DELETE is not
|
|
25
|
+
* sent: a system of record keeps its own records, and removing one is its operator's decision, not a side effect of
|
|
26
|
+
* a local edit.
|
|
27
|
+
*/
|
|
28
|
+
OUTBOUND = 'outbound',
|
|
29
|
+
/**
|
|
30
|
+
* Both sides change the row (#1723): a pass LOADS what the system of record changed and SENDS what the application
|
|
31
|
+
* changed, field by field, as each mapping entry's `owner` declares — REMOTE fields are loaded and read-only locally,
|
|
32
|
+
* LOCAL fields are sent and never loaded, BOTH fields are loaded AND sent. A row whose BOTH fields changed on both
|
|
33
|
+
* sides since they last agreed is a CONFLICT, decided by the declared `conflictPolicy`.
|
|
34
|
+
*
|
|
35
|
+
* "Since they last agreed" is the system of record's own row version (Odoo `write_date`, an OData entity tag), kept
|
|
36
|
+
* per row by the engine — so the direction is legal only on an instance whose vendor declares one. A local DELETE is
|
|
37
|
+
* not sent, as on OUTBOUND.
|
|
38
|
+
*/
|
|
39
|
+
BIDIRECTIONAL = 'bidirectional',
|
|
14
40
|
}
|
|
15
41
|
|
|
42
|
+
/**
|
|
43
|
+
* Which side OWNS a mapped field of a BIDIRECTIONAL pipeline (#1723). Declared on each `REMOTE_FIELD` / `REMOTE_REFERENCE`
|
|
44
|
+
* entry as `owner`, and refused on any other direction (an INBOUND pipeline's fields are all the system of record's, an
|
|
45
|
+
* OUTBOUND pipeline's all the application's).
|
|
46
|
+
*
|
|
47
|
+
* Only BOTH fields can conflict, which keeps the common case — remote master data plus a few locally-owned fields —
|
|
48
|
+
* out of conflict handling entirely.
|
|
49
|
+
*/
|
|
50
|
+
export enum ExternalDataFieldOwner {
|
|
51
|
+
/** The system of record's: loaded, read-only for callers, never sent. The default when `owner` is omitted. */
|
|
52
|
+
REMOTE = 'remote',
|
|
53
|
+
/** The application's: written by callers, sent, never loaded. */
|
|
54
|
+
LOCAL = 'local',
|
|
55
|
+
/** Both sides': written by callers AND loaded, sent AND read back — the only kind of field that can conflict. */
|
|
56
|
+
BOTH = 'both',
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
|
|
16
60
|
/**
|
|
17
61
|
* Who owns the destination's row population (D-P8, v3.1 §1).
|
|
18
62
|
*
|
|
@@ -55,18 +99,164 @@ export enum ExternalDataOrphanPolicy {
|
|
|
55
99
|
REPORT = 'report',
|
|
56
100
|
}
|
|
57
101
|
|
|
58
|
-
/**
|
|
102
|
+
/**
|
|
103
|
+
* The shapes a mapping entry can take — a closed discriminator, never inferred from keys.
|
|
104
|
+
*
|
|
105
|
+
* ## The DECLARED EXPRESSIONS (#1685), and the open function slot they replace
|
|
106
|
+
*
|
|
107
|
+
* `ENUM_MAP`, `CONCATENATION`, `ARITHMETIC` and `CONDITIONAL` derive a local value from remote values. They are
|
|
108
|
+
* the first of the T's recorded widenings (D-P4: computed transforms, then multi-source joins, then transforms
|
|
109
|
+
* authored by the app-creation lane's agents) and they are DATA: every one names the remote fields it reads, the
|
|
110
|
+
* local field it writes, and a closed operation with declared constants. Nothing in them executes code the
|
|
111
|
+
* declaration does not show, so each is checked at startup against the destination schema (target type, enum
|
|
112
|
+
* membership, absence) and requested by the extraction like any mapped field.
|
|
113
|
+
*
|
|
114
|
+
* An open function slot (`transform: (row) => value`) is refused on purpose: it would put arbitrary code inside the
|
|
115
|
+
* load with no declaration anyone can review, validate or fingerprint. A derivation beyond these four stays a
|
|
116
|
+
* pre-load step in the application's own code, run by its own job.
|
|
117
|
+
*/
|
|
59
118
|
export enum ExternalDataMappingEntryKind {
|
|
60
119
|
/** Copy (and coerce) one remote field into one local field. */
|
|
61
120
|
REMOTE_FIELD = 'remote-field',
|
|
62
121
|
/** Fill one local field with a declared constant (destination-required fields with no remote source). */
|
|
63
122
|
CONSTANT = 'constant',
|
|
123
|
+
/**
|
|
124
|
+
* Turn a remote REFERENCE into a real local foreign key (#1684) — an Odoo many2one (`parent_id`,
|
|
125
|
+
* `partner_id`), an OData navigation key. The remote value names a row of ANOTHER remote entity (or of
|
|
126
|
+
* the same one); the pipeline writes the local foreign key to that row's LOCAL copy, never the remote
|
|
127
|
+
* id. See {@link ExternalDataRemoteReferenceMappingEntrySchema}.
|
|
128
|
+
*/
|
|
129
|
+
REMOTE_REFERENCE = 'remote-reference',
|
|
130
|
+
/**
|
|
131
|
+
* Map a remote CODE onto a member of a local enum (#1685) — an Odoo selection (`draft`/`posted`), a vendor status
|
|
132
|
+
* code. Every mapped code is declared; a code the declaration does not name either rejects the row or lands a
|
|
133
|
+
* declared default. See {@link ExternalDataEnumMappingEntrySchema}.
|
|
134
|
+
*/
|
|
135
|
+
ENUM_MAP = 'enum-map',
|
|
136
|
+
/**
|
|
137
|
+
* Join remote fields and literals into one local string (#1685) — a display name from a first and a last name.
|
|
138
|
+
* See {@link ExternalDataConcatenationMappingEntrySchema}.
|
|
139
|
+
*/
|
|
140
|
+
CONCATENATION = 'concatenation',
|
|
141
|
+
/**
|
|
142
|
+
* `remote × factor + offset` on one numeric remote field (#1685) — a unit conversion, or a currency conversion at
|
|
143
|
+
* a DECLARED constant rate. See {@link ExternalDataArithmeticMappingEntrySchema}.
|
|
144
|
+
*/
|
|
145
|
+
ARITHMETIC = 'arithmetic',
|
|
146
|
+
/**
|
|
147
|
+
* Choose the local value by ONE remote field's value (#1685): a list of cases, each an exact value, and an
|
|
148
|
+
* `otherwise`. See {@link ExternalDataConditionalMappingEntrySchema}.
|
|
149
|
+
*/
|
|
150
|
+
CONDITIONAL = 'conditional',
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* The mapping entry kinds an OUTBOUND pipeline may declare (#1690): a local field sent as one remote field, and a local
|
|
155
|
+
* foreign key sent as the target row's REMOTE key. The declared expressions (#1685) derive one local value from remote
|
|
156
|
+
* ones and have no inverse — a concatenation cannot be split back into its parts — and a CONSTANT names no remote field.
|
|
157
|
+
*/
|
|
158
|
+
export const EXTERNAL_DATA_OUTBOUND_MAPPING_ENTRY_KINDS: ReadonlySet<ExternalDataMappingEntryKind> = new Set([
|
|
159
|
+
ExternalDataMappingEntryKind.REMOTE_FIELD,
|
|
160
|
+
ExternalDataMappingEntryKind.REMOTE_REFERENCE,
|
|
161
|
+
]);
|
|
162
|
+
|
|
163
|
+
/**
|
|
164
|
+
* The write verbs an OUTBOUND pipeline may open on its binding (#1690): a create for a row with no remote key yet, and
|
|
165
|
+
* an update for one that has one. DELETE is not among them — see {@link ExternalDataPipelineDirection.OUTBOUND}.
|
|
166
|
+
*/
|
|
167
|
+
export const EXTERNAL_DATA_OUTBOUND_WRITE_VERBS: ReadonlySet<HttpApiWriteVerb> = new Set([HttpApiWriteVerb.CREATE, HttpApiWriteVerb.UPDATE]);
|
|
168
|
+
|
|
169
|
+
/**
|
|
170
|
+
* What an `ENUM_MAP` does with a remote code its declaration does not name (#1685).
|
|
171
|
+
*/
|
|
172
|
+
export enum ExternalDataUnmappedValuePolicy {
|
|
173
|
+
/**
|
|
174
|
+
* The DEFAULT. The row is REJECTED and reported, and its previous local version survives. A vendor that adds a
|
|
175
|
+
* code is then visible on the next run's report instead of being folded silently into some other member.
|
|
176
|
+
*/
|
|
177
|
+
REJECT_ROW = 'reject-row',
|
|
178
|
+
/** The row lands the declared `localValue`. Choose it only where every future code genuinely means the same thing. */
|
|
179
|
+
USE_DEFAULT = 'use-default',
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
/** The two things a `CONCATENATION` part can be (#1685). */
|
|
183
|
+
export enum ExternalDataConcatenationPartKind {
|
|
184
|
+
/** The value of one remote field. An absent or empty value drops the part. */
|
|
185
|
+
REMOTE_FIELD = 'remote-field',
|
|
186
|
+
/** A declared literal, written as-is. */
|
|
187
|
+
LITERAL = 'literal',
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/** The two things a `CONDITIONAL` outcome can be (#1685). */
|
|
191
|
+
export enum ExternalDataConditionalOutcomeKind {
|
|
192
|
+
/** A declared constant, checked against the local field's type at startup. */
|
|
193
|
+
CONSTANT = 'constant',
|
|
194
|
+
/** Another remote field's value, copied as a `REMOTE_FIELD` entry copies it. */
|
|
195
|
+
REMOTE_FIELD = 'remote-field',
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* How a REMOTE_REFERENCE's remote value becomes the target's key (#1684). A closed vocabulary, one
|
|
200
|
+
* member per wire shape, because the shapes differ in kind and guessing between them silently resolves
|
|
201
|
+
* nothing.
|
|
202
|
+
*/
|
|
203
|
+
export enum ExternalDataRemoteReferenceValueShape {
|
|
204
|
+
/**
|
|
205
|
+
* Odoo's many2one: `search_read` answers `[id, display_name]`, or `false` when the reference is empty.
|
|
206
|
+
* The key is the pair's FIRST element; the display name is ignored (it is a label, not an identity).
|
|
207
|
+
* spec-cite: Odoo 18.0 developer reference, External API — "Read records" / "Search and read"
|
|
208
|
+
* (`odoo/documentation/18.0/content/developer/reference/external_api.rst`) — a many2one reads as
|
|
209
|
+
* `[21, 'Belgium']`; `false` for an unset one is the ORM's null spelling (measured shape recorded on the
|
|
210
|
+
* provider simulator, `odoo-jsonrpc-mock.ts`).
|
|
211
|
+
*/
|
|
212
|
+
ODOO_MANY2ONE = 'odoo-many2one',
|
|
213
|
+
/**
|
|
214
|
+
* The remote value IS the target's key component, as a plain scalar — an OData navigation property's
|
|
215
|
+
* foreign-key field (`ParentAccountID`), a REST id column. `null` or an empty string is an empty reference.
|
|
216
|
+
*/
|
|
217
|
+
SCALAR = 'scalar',
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/**
|
|
221
|
+
* What a run does with a reference whose target has no local row yet (#1684).
|
|
222
|
+
*
|
|
223
|
+
* Resolution happens AFTER the load, in its own phase, so a reference to a row loaded by the same run —
|
|
224
|
+
* including a child extracted before its parent, and a self-reference — always resolves. What remains
|
|
225
|
+
* "unresolved" is a target the destination does not hold at all: outside the pipeline's `sourceFilter`,
|
|
226
|
+
* in a partition nobody assigned, not yet loaded by the target's own pipeline.
|
|
227
|
+
*/
|
|
228
|
+
export enum ExternalDataUnresolvedReferencePolicy {
|
|
229
|
+
/**
|
|
230
|
+
* The DEFAULT. The row loads with the foreign key EMPTY, and the reference is kept in the pipeline's
|
|
231
|
+
* pending-resolution set. The set is retried at the end of EVERY later run of the pipeline, incremental
|
|
232
|
+
* ones included — which is the only way such a row is ever resolved under incremental extraction (#1682),
|
|
233
|
+
* because a child that did not change is never re-read. Counted on every run's report and summary.
|
|
234
|
+
*/
|
|
235
|
+
LEAVE_PENDING = 'leave-pending',
|
|
236
|
+
/**
|
|
237
|
+
* The row is REJECTED (reported per row; its previous local version survives) when its target is not
|
|
238
|
+
* already loaded and not among the rows of the same PAGE — a run loads page by page (#1689), so a target
|
|
239
|
+
* on a LATER page of the same run is not loaded yet. It is retried only when the row is extracted again
|
|
240
|
+
* — every full pass, or an incremental pass after it changes — and a pass that reads parents before their
|
|
241
|
+
* children never meets the case. For a self-referencing entity whose source order you do not control,
|
|
242
|
+
* `LEAVE_PENDING` resolves the link at the end of the same run instead. A reference to a VIRTUAL (read-through)
|
|
243
|
+
* target never rejects: its key is its local id, and there is nothing local to be missing.
|
|
244
|
+
*
|
|
245
|
+
* The check runs BEFORE the load, against the target as it stands then. A self-referenced target that the same
|
|
246
|
+
* full pass's orphan walk deletes (`orphanPolicy: DELETE`) saved the row from rejection and is then gone, so that
|
|
247
|
+
* row loads with its foreign key empty and pending — the one case this policy cannot rule out.
|
|
248
|
+
*/
|
|
249
|
+
REJECT_ROW = 'reject-row',
|
|
64
250
|
}
|
|
65
251
|
|
|
66
252
|
/**
|
|
67
253
|
* Built-in, closed coercion vocabulary for REMOTE_FIELD entries (v3.1 §3 / PR-8). Slice 1 ships
|
|
68
|
-
* exactly the coercions the two generic dialects force
|
|
69
|
-
*
|
|
254
|
+
* exactly the coercions the two generic dialects force. A value COMPUTED from remote fields is one of
|
|
255
|
+
* the declared expressions (#1685 — D-P4's first widening: `ENUM_MAP`, `CONCATENATION`, `ARITHMETIC`,
|
|
256
|
+
* `CONDITIONAL`), and transforms authored by the app-creation lane's agents remain a recorded widening
|
|
257
|
+
* (W-AGENT) — never an open function slot here. Foreign-key resolution,
|
|
258
|
+
* once recorded as the W-FK widening beside it, is not a coercion at all: it is its own entry kind,
|
|
259
|
+
* {@link ExternalDataMappingEntryKind.REMOTE_REFERENCE} (#1684).
|
|
70
260
|
*/
|
|
71
261
|
export enum ExternalDataFieldCoercion {
|
|
72
262
|
/** Value lands as extracted (after the destination schema's own Zod parse). */
|
|
@@ -81,9 +271,243 @@ export enum ExternalDataFieldCoercion {
|
|
|
81
271
|
ISO_STRING_TO_DATE = 'iso-string-to-date',
|
|
82
272
|
}
|
|
83
273
|
|
|
84
|
-
/**
|
|
274
|
+
/**
|
|
275
|
+
* What a pipeline does with a remote row its source has ARCHIVED rather than deleted (#1732).
|
|
276
|
+
*
|
|
277
|
+
* ## Why this exists: archived is not deleted, and absence reads as deletion
|
|
278
|
+
*
|
|
279
|
+
* Odoo archives a record by setting its `active` field to `false`, and an archived record is then
|
|
280
|
+
* "invisible in most searches and listing" — a plain `search_read` leaves it out, exactly as if it
|
|
281
|
+
* had been deleted.
|
|
282
|
+
* spec-cite: Odoo 17.0 ORM API reference, "Reserved Field names" → `Model.active`
|
|
283
|
+
* (https://www.odoo.com/documentation/17.0/developer/reference/backend/orm.html).
|
|
284
|
+
*
|
|
285
|
+
* A pipeline's orphan walk reads "absent from a complete pass" as "deleted remotely", so an extraction
|
|
286
|
+
* that inherited Odoo's default visibility turned every archive into a deletion: `REPORT` reported
|
|
287
|
+
* it, `DEPRECATE` deprecated it, and `DELETE` hard-deleted the local row together with its local
|
|
288
|
+
* extension fields, files and RAG chunks. Un-archiving later re-created a bare row.
|
|
289
|
+
*
|
|
290
|
+
* So extraction ALWAYS asks Odoo for archived rows too (the `active_test: false` context), and an
|
|
291
|
+
* archived row is always OBSERVED — present in the source, never an orphan. What remains a choice is
|
|
292
|
+
* only whether it is LOADED, and that is this vocabulary. Every member keeps the row observed; no
|
|
293
|
+
* member can turn an archive into a deletion.
|
|
294
|
+
*
|
|
295
|
+
* Declared on Odoo sources only (`archivedRecords`); an OData source has no protocol-level archive
|
|
296
|
+
* state, and the declaration coherence refuses the field there.
|
|
297
|
+
*/
|
|
298
|
+
export enum ExternalDataArchivedRecordTreatment {
|
|
299
|
+
/**
|
|
300
|
+
* The DEFAULT. An archived row is loaded like any other row. Map the source's archive flag
|
|
301
|
+
* (`active` on most Odoo models) onto a local boolean like any other field, and the destination can
|
|
302
|
+
* show or filter archived rows — and an un-archive changes exactly that one value.
|
|
303
|
+
*/
|
|
304
|
+
LOAD = 'load',
|
|
305
|
+
/**
|
|
306
|
+
* An archived row is NOT loaded, but still counts as observed, so it is never an orphan — the same
|
|
307
|
+
* treatment rows of an unassigned partition get. A local row loaded while the record was live KEEPS
|
|
308
|
+
* its last loaded version (it is neither updated nor deleted) until the record is un-archived.
|
|
309
|
+
* Choose it to keep archived records out of a destination that never held them; choose `LOAD` with
|
|
310
|
+
* the flag mapped when the destination must reflect archival.
|
|
311
|
+
*/
|
|
312
|
+
EXCLUDE_FROM_LOAD = 'exclude-from-load',
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
/**
|
|
316
|
+
* A REMOTE_REFERENCE mapping entry (#1684): a remote reference field written as a real LOCAL foreign key.
|
|
317
|
+
*
|
|
318
|
+
* ## What the local field holds
|
|
319
|
+
*
|
|
320
|
+
* - a target that is another PIPELINE destination on the same system of record (or this one — a
|
|
321
|
+
* self-reference such as Odoo `res.partner.parent_id`): the target's local row id, found by synthesizing
|
|
322
|
+
* the target's key with THE TARGET BINDING's key codec and looking it up on the target's
|
|
323
|
+
* `remoteKeyLocalField`;
|
|
324
|
+
* - a target that is a VIRTUAL (read-through) resource bound to the same system of record: the synthesized
|
|
325
|
+
* key itself — a virtual row's `_id` IS that value, so nothing is looked up.
|
|
326
|
+
*
|
|
327
|
+
* ## When it is written
|
|
328
|
+
*
|
|
329
|
+
* After the load, in its own phase — never inside the row transform. So a child extracted before its
|
|
330
|
+
* parent, a self-reference, and a cycle between two pipelines all resolve without ordering anything. The
|
|
331
|
+
* resolution phase is the ONLY writer of the local field: the load never touches it, which is why the field
|
|
332
|
+
* is left out of the load's managed fields.
|
|
333
|
+
*
|
|
334
|
+
* ## What the declaration owes (checked at authoring and at startup)
|
|
335
|
+
*
|
|
336
|
+
* - `localField` is the foreign key of a declared relationship between this resource and `targetResourceType`,
|
|
337
|
+
* a STRING field that accepts absence (an unresolved reference leaves it empty), and — like every
|
|
338
|
+
* pipeline-written field — `.excludeFromCreate().excludeFromUpdate()`;
|
|
339
|
+
* - the target is a pipeline destination or a virtual resource on THIS pipeline's system of record, keyed by
|
|
340
|
+
* ONE key field (a composite target key is a recorded widening);
|
|
341
|
+
* - when the target's orphan policy DELETES rows and the relationship tears children down with their parent,
|
|
342
|
+
* `orphanCascadeAcknowledged: true` — a row vanishing from the target's source would otherwise take this
|
|
343
|
+
* resource's rows with it through the ordinary `onParentDelete` rules, and nothing about this declaration
|
|
344
|
+
* says so unless the author does.
|
|
345
|
+
*/
|
|
346
|
+
export const ExternalDataRemoteReferenceMappingEntrySchema = z.strictObject({
|
|
347
|
+
kind: z.literal(ExternalDataMappingEntryKind.REMOTE_REFERENCE),
|
|
348
|
+
/** The remote field carrying the reference (`parent_id` on Odoo `res.partner`). */
|
|
349
|
+
remoteField: z.string().trim().min(1),
|
|
350
|
+
/** The local foreign-key field the resolved reference is written to. */
|
|
351
|
+
localField: z.string().trim().min(1),
|
|
352
|
+
/** The LOCAL resource the reference resolves to — a pipeline destination or a virtual resource. */
|
|
353
|
+
targetResourceType: z.string().trim().min(1),
|
|
354
|
+
/**
|
|
355
|
+
* How the remote value becomes the target's key. Absent = resolved at AUTHORING from the source dialect:
|
|
356
|
+
* `ODOO_MANY2ONE` on an Odoo source, `SCALAR` otherwise — the resource factory writes the resolved value
|
|
357
|
+
* into the declaration, exactly as it resolves the Odoo absent-as-false coercion.
|
|
358
|
+
*/
|
|
359
|
+
valueShape: z.enum(ExternalDataRemoteReferenceValueShape).optional(),
|
|
360
|
+
unresolved: z.enum(ExternalDataUnresolvedReferencePolicy).default(ExternalDataUnresolvedReferencePolicy.LEAVE_PENDING),
|
|
361
|
+
/**
|
|
362
|
+
* The author has read that the target's `orphanPolicy: DELETE` will cascade into this resource's rows
|
|
363
|
+
* through the relationship's `onParentDelete` teardown, and wants that. Only meaningful — and only
|
|
364
|
+
* demanded — when both are true; see the schema's header.
|
|
365
|
+
*/
|
|
366
|
+
orphanCascadeAcknowledged: z.boolean().default(false),
|
|
367
|
+
/** Which side owns the reference — BIDIRECTIONAL pipelines only (#1723). Absent = REMOTE. */
|
|
368
|
+
owner: z.enum(ExternalDataFieldOwner).optional(),
|
|
369
|
+
});
|
|
370
|
+
|
|
371
|
+
export type ExternalDataRemoteReferenceMappingEntry = z.infer<typeof ExternalDataRemoteReferenceMappingEntrySchema>;
|
|
372
|
+
|
|
373
|
+
/**
|
|
374
|
+
* A remote SCALAR a declared expression compares against or maps from (#1685) — the value shapes a remote field
|
|
375
|
+
* carries that can be matched exactly. An Odoo selection is a string, a status code may be a number, a flag a
|
|
376
|
+
* boolean. Objects and arrays (an Odoo many2one pair) cannot be matched and are not declarable.
|
|
377
|
+
*/
|
|
378
|
+
const externalDataExpressionScalarSchema = z.union([z.string(), z.number().finite(), z.boolean()]);
|
|
379
|
+
|
|
380
|
+
/**
|
|
381
|
+
* An `ENUM_MAP` entry (#1685): one remote code → one member of the local field's enum.
|
|
382
|
+
*
|
|
383
|
+
* - the local field is an ENUM, and every declared `localValue` (and the default's) is one of its members — checked
|
|
384
|
+
* at startup, so a renamed member fails the boot rather than every row;
|
|
385
|
+
* - an ABSENT remote value (the field unset: `null`, missing, or Odoo's `false` when `false` is not itself a declared
|
|
386
|
+
* code) lands null, or rejects the row when `required`;
|
|
387
|
+
* - a PRESENT code the declaration does not name follows `unmapped`: rejected by default, or the declared member.
|
|
388
|
+
*/
|
|
389
|
+
export const ExternalDataEnumMappingEntrySchema = z.strictObject({
|
|
390
|
+
kind: z.literal(ExternalDataMappingEntryKind.ENUM_MAP),
|
|
391
|
+
/** The remote field carrying the code (`state` on Odoo `account.move`). */
|
|
392
|
+
remoteField: z.string().trim().min(1),
|
|
393
|
+
localField: z.string().trim().min(1),
|
|
394
|
+
/** Every code the declaration maps, each to one member of the local enum. Codes are unique. */
|
|
395
|
+
values: z.array(z.strictObject({
|
|
396
|
+
remoteValue: externalDataExpressionScalarSchema,
|
|
397
|
+
localValue: z.union([z.string().min(1), z.number().finite()]),
|
|
398
|
+
})).min(1),
|
|
399
|
+
/** A PRESENT code no `values` entry names. Absent = reject the row. */
|
|
400
|
+
unmapped: z.discriminatedUnion('policy', [
|
|
401
|
+
z.strictObject({ policy: z.literal(ExternalDataUnmappedValuePolicy.REJECT_ROW) }),
|
|
402
|
+
z.strictObject({ policy: z.literal(ExternalDataUnmappedValuePolicy.USE_DEFAULT), localValue: z.union([z.string().min(1), z.number().finite()]) }),
|
|
403
|
+
]).default({ policy: ExternalDataUnmappedValuePolicy.REJECT_ROW }),
|
|
404
|
+
/** `true`: a row whose remote code is ABSENT is rejected. `false` (default): absence lands null. */
|
|
405
|
+
required: z.boolean().default(false),
|
|
406
|
+
});
|
|
407
|
+
|
|
408
|
+
export type ExternalDataEnumMappingEntry = z.infer<typeof ExternalDataEnumMappingEntrySchema>;
|
|
409
|
+
|
|
410
|
+
/**
|
|
411
|
+
* A `CONCATENATION` entry (#1685): remote fields and literals joined into one local STRING.
|
|
412
|
+
*
|
|
413
|
+
* Every part with a value is written, in order, joined by `separator`; a remote part whose value is absent or empty
|
|
414
|
+
* (`null`, missing, `''`, or Odoo's `false`) is DROPPED with its separator, the way SQL's `concat_ws` ignores a NULL
|
|
415
|
+
* argument — so `first` + `last` joined by a space yields `'Ada'`, never `'Ada '`, when the last name is unset. A
|
|
416
|
+
* number is written as JavaScript's shortest round-trip text (`42`, `12.5`; exponent notation only beyond `1e21` or
|
|
417
|
+
* below `1e-6`); any other value (a boolean off Odoo, a many2one pair) rejects the row.
|
|
418
|
+
*
|
|
419
|
+
* spec-cite: PostgreSQL 17 documentation, §9.4 "String Functions and Operators", `concat_ws` — "NULL arguments are
|
|
420
|
+
* ignored" (https://www.postgresql.org/docs/17/functions-string.html).
|
|
421
|
+
*
|
|
422
|
+
* When NO remote part has a value, the result is ABSENT — literals alone are decoration, not data — and lands null,
|
|
423
|
+
* or rejects the row when `required`.
|
|
424
|
+
*/
|
|
425
|
+
export const ExternalDataConcatenationMappingEntrySchema = z.strictObject({
|
|
426
|
+
kind: z.literal(ExternalDataMappingEntryKind.CONCATENATION),
|
|
427
|
+
localField: z.string().trim().min(1),
|
|
428
|
+
/** At least two parts, at least one of them a remote field. */
|
|
429
|
+
parts: z.array(z.discriminatedUnion('kind', [
|
|
430
|
+
z.strictObject({ kind: z.literal(ExternalDataConcatenationPartKind.REMOTE_FIELD), remoteField: z.string().trim().min(1) }),
|
|
431
|
+
z.strictObject({ kind: z.literal(ExternalDataConcatenationPartKind.LITERAL), literal: z.string().min(1) }),
|
|
432
|
+
])).min(2),
|
|
433
|
+
/** Written between two parts that both have a value. Default: nothing. */
|
|
434
|
+
separator: z.string().default(''),
|
|
435
|
+
required: z.boolean().default(false),
|
|
436
|
+
});
|
|
437
|
+
|
|
438
|
+
export type ExternalDataConcatenationMappingEntry = z.infer<typeof ExternalDataConcatenationMappingEntrySchema>;
|
|
439
|
+
|
|
440
|
+
/**
|
|
441
|
+
* An `ARITHMETIC` entry (#1685): `remote × factor + offset` onto a local NUMBER.
|
|
442
|
+
*
|
|
443
|
+
* A currency conversion is legal only as a DECLARED rate (`factor`): a live exchange rate is a second source, which
|
|
444
|
+
* is a join, and joins are a later widening. The declaration is the rate's record, so changing it changes the
|
|
445
|
+
* pipeline's extraction fingerprint and an incremental pipeline re-reads every row under the new rate.
|
|
446
|
+
*
|
|
447
|
+
* The remote value is a finite number, or a string holding a plain decimal numeral (`'12.50'` — how OData v2 and
|
|
448
|
+
* several REST APIs serialize decimals). Anything else rejects the row. `decimalPlaces` rounds the RESULT half away
|
|
449
|
+
* from zero, in binary floating point: it keeps `0.1 × 3` from landing as `0.30000000000000004`, and it does not make
|
|
450
|
+
* the value exact — an amount that must be exact to the cent belongs in a type this expression does not produce.
|
|
451
|
+
*/
|
|
452
|
+
export const ExternalDataArithmeticMappingEntrySchema = z.strictObject({
|
|
453
|
+
kind: z.literal(ExternalDataMappingEntryKind.ARITHMETIC),
|
|
454
|
+
remoteField: z.string().trim().min(1),
|
|
455
|
+
localField: z.string().trim().min(1),
|
|
456
|
+
/** Multiplier. Never 0 — a constant result is a `CONSTANT` entry. */
|
|
457
|
+
factor: z.number().finite().default(1),
|
|
458
|
+
/** Added after the multiplication. */
|
|
459
|
+
offset: z.number().finite().default(0),
|
|
460
|
+
/** Round the result to this many decimal places. Absent = no rounding. */
|
|
461
|
+
decimalPlaces: z.number().int().min(0).max(12).optional(),
|
|
462
|
+
required: z.boolean().default(false),
|
|
463
|
+
});
|
|
464
|
+
|
|
465
|
+
export type ExternalDataArithmeticMappingEntry = z.infer<typeof ExternalDataArithmeticMappingEntrySchema>;
|
|
466
|
+
|
|
467
|
+
/** What a `CONDITIONAL` case (or its `otherwise`) writes (#1685). */
|
|
468
|
+
const ExternalDataConditionalOutcomeSchema = z.discriminatedUnion('kind', [
|
|
469
|
+
z.strictObject({ kind: z.literal(ExternalDataConditionalOutcomeKind.CONSTANT), constant: externalDataExpressionScalarSchema }),
|
|
470
|
+
z.strictObject({
|
|
471
|
+
kind: z.literal(ExternalDataConditionalOutcomeKind.REMOTE_FIELD),
|
|
472
|
+
remoteField: z.string().trim().min(1),
|
|
473
|
+
/** As on a `REMOTE_FIELD` entry: Odoo's absent-as-false is resolved at authoring from the local field's type. */
|
|
474
|
+
coercion: z.enum(ExternalDataFieldCoercion).default(ExternalDataFieldCoercion.NONE),
|
|
475
|
+
}),
|
|
476
|
+
]);
|
|
477
|
+
|
|
478
|
+
export type ExternalDataConditionalOutcome = z.infer<typeof ExternalDataConditionalOutcomeSchema>;
|
|
479
|
+
|
|
480
|
+
/**
|
|
481
|
+
* A `CONDITIONAL` entry (#1685): the local value chosen by ONE remote field's value.
|
|
482
|
+
*
|
|
483
|
+
* The cases are tried in order and the first whose `equals` is exactly (`===`) the remote value wins; no case
|
|
484
|
+
* matching — an absent value included — takes `otherwise`. On an Odoo source an unset field reads `false`, so a declared
|
|
485
|
+
* `equals: false` case catches it before `otherwise` does. An outcome is a constant (checked against the local
|
|
486
|
+
* field's type, and against its members when it is an enum) or another remote field's value. Conditions over two
|
|
487
|
+
* fields, ranges and patterns are not part of the set: they are exactly what makes an expression language grow into
|
|
488
|
+
* the open function slot this set exists to avoid.
|
|
489
|
+
*/
|
|
490
|
+
export const ExternalDataConditionalMappingEntrySchema = z.strictObject({
|
|
491
|
+
kind: z.literal(ExternalDataMappingEntryKind.CONDITIONAL),
|
|
492
|
+
/** The remote field whose value decides. */
|
|
493
|
+
remoteField: z.string().trim().min(1),
|
|
494
|
+
localField: z.string().trim().min(1),
|
|
495
|
+
cases: z.array(z.strictObject({ equals: externalDataExpressionScalarSchema, then: ExternalDataConditionalOutcomeSchema })).min(1),
|
|
496
|
+
otherwise: ExternalDataConditionalOutcomeSchema,
|
|
497
|
+
});
|
|
498
|
+
|
|
499
|
+
export type ExternalDataConditionalMappingEntry = z.infer<typeof ExternalDataConditionalMappingEntrySchema>;
|
|
500
|
+
|
|
501
|
+
/**
|
|
502
|
+
* One declared T-step: remote field → local field with a built-in coercion, a constant, a resolved reference, or one
|
|
503
|
+
* of the four declared expressions (#1685).
|
|
504
|
+
*
|
|
505
|
+
* Every entry shape is STRICT: an unknown key is refused, not dropped. That is what makes the refusal of an open
|
|
506
|
+
* function slot real — `{ kind: 'remote-field', …, transform: (value) => … }` used to parse with `transform` silently
|
|
507
|
+
* stripped, a declaration that reads as if it ran code and runs none.
|
|
508
|
+
*/
|
|
85
509
|
export const ExternalDataFieldMappingEntrySchema = z.discriminatedUnion('kind', [
|
|
86
|
-
z.
|
|
510
|
+
z.strictObject({
|
|
87
511
|
kind: z.literal(ExternalDataMappingEntryKind.REMOTE_FIELD),
|
|
88
512
|
remoteField: z.string().trim().min(1),
|
|
89
513
|
localField: z.string().trim().min(1),
|
|
@@ -94,19 +518,189 @@ export const ExternalDataFieldMappingEntrySchema = z.discriminatedUnion('kind',
|
|
|
94
518
|
* which the declaration coherence requires the local field to accept.
|
|
95
519
|
*/
|
|
96
520
|
required: z.boolean().default(false),
|
|
521
|
+
/** Which side owns the field — BIDIRECTIONAL pipelines only (#1723). Absent = REMOTE. */
|
|
522
|
+
owner: z.enum(ExternalDataFieldOwner).optional(),
|
|
97
523
|
}),
|
|
98
|
-
z.
|
|
524
|
+
z.strictObject({
|
|
99
525
|
kind: z.literal(ExternalDataMappingEntryKind.CONSTANT),
|
|
100
526
|
localField: z.string().trim().min(1),
|
|
101
527
|
constant: z.union([z.string(), z.number(), z.boolean()]),
|
|
102
528
|
}),
|
|
529
|
+
ExternalDataRemoteReferenceMappingEntrySchema,
|
|
530
|
+
ExternalDataEnumMappingEntrySchema,
|
|
531
|
+
ExternalDataConcatenationMappingEntrySchema,
|
|
532
|
+
ExternalDataArithmeticMappingEntrySchema,
|
|
533
|
+
ExternalDataConditionalMappingEntrySchema,
|
|
534
|
+
]);
|
|
535
|
+
|
|
536
|
+
/**
|
|
537
|
+
* HOW a source says what changed — one member per remote change-tracking mechanism (#1682).
|
|
538
|
+
*
|
|
539
|
+
* A closed vocabulary shared by two parties: a system-of-record VENDOR FACET declares which modes its
|
|
540
|
+
* deployments support (`incrementalExtractionModes`), and a pipeline declaration chooses one. A
|
|
541
|
+
* pipeline asking for a mode its source's facet does not declare is refused at startup, naming both.
|
|
542
|
+
*
|
|
543
|
+
* Three modes: Odoo's `write_date`, and the two OData v4 mechanisms (#1722) — a modified-at filter and
|
|
544
|
+
* the delta-link protocol. The incremental TRACK on the state row is mode-neutral (its watermark and
|
|
545
|
+
* cursor are opaque, mode-owned text), so a new mode needed no reshape of it.
|
|
546
|
+
*/
|
|
547
|
+
export enum ExternalDataIncrementalExtractionMode {
|
|
548
|
+
/**
|
|
549
|
+
* Odoo's `write_date` — the "Last Updated on" column the ORM maintains on every model that logs
|
|
550
|
+
* access. Read in (SECOND, id) order from a watermark, with a declared lookback. See
|
|
551
|
+
* {@link ExternalDataIncrementalExtractionDeclarationSchema}.
|
|
552
|
+
*/
|
|
553
|
+
ODOO_WRITE_DATE = 'odoo-write-date',
|
|
554
|
+
/**
|
|
555
|
+
* OData v4, a MODIFIED-AT property the declaration names (`modifiedAtRemoteField` — per entity, not per
|
|
556
|
+
* vendor: Dataverse's `modifiedon`, Business Central's `lastModifiedDateTime`). Rows with that property at
|
|
557
|
+
* or after the watermark (less the lookback) are read in KEY order, and the watermark moves only when the
|
|
558
|
+
* pass completes. Catches no deletions: full passes find those.
|
|
559
|
+
*/
|
|
560
|
+
ODATA_MODIFIED_AT = 'odata-modified-at',
|
|
561
|
+
/**
|
|
562
|
+
* OData v4 CHANGE TRACKING: the first pass asks for `Prefer: odata.track-changes` and keeps the service's
|
|
563
|
+
* `@odata.deltaLink`; every later pass follows it and receives changed entities AND deleted ones, so an
|
|
564
|
+
* incremental pass applies the orphan policy to each deleted key. The vendor must track changes for the
|
|
565
|
+
* entity set (Dataverse: per table).
|
|
566
|
+
*/
|
|
567
|
+
ODATA_DELTA_LINK = 'odata-delta-link',
|
|
568
|
+
}
|
|
569
|
+
|
|
570
|
+
/**
|
|
571
|
+
* `incremental` — read only what changed between full passes (#1682).
|
|
572
|
+
*
|
|
573
|
+
* ## What an incremental pass does, and what it never does
|
|
574
|
+
*
|
|
575
|
+
* - It reads the rows changed since the pipeline's WATERMARK — the largest remote position a previous
|
|
576
|
+
* incremental pass actually LOADED, never the local clock (a local clock and a remote clock disagree,
|
|
577
|
+
* and the gap is rows nobody reads).
|
|
578
|
+
* - The watermark advances only after the rows that reached it are loaded. A crash re-reads; it never
|
|
579
|
+
* skips.
|
|
580
|
+
* - It NEVER detects deletions. A row deleted remotely does not "change", so no incremental read can
|
|
581
|
+
* see it. Deletions are found by FULL passes only, on `fullPassCron` — which is why that cadence is
|
|
582
|
+
* required rather than optional: an incremental-only pipeline would keep deleted rows forever.
|
|
583
|
+
* - It runs on the pipeline's `scheduleCron`, which is therefore required too.
|
|
584
|
+
*
|
|
585
|
+
* ## The Odoo mode — why (second, id), and why a lookback
|
|
586
|
+
*
|
|
587
|
+
* Odoo STORES `write_date` with microseconds (the writing transaction's `now()`) and SERVES it cut to
|
|
588
|
+
* the second, while a domain compares the stored value. Two obvious designs fail on that gap:
|
|
589
|
+
* `write_date > w` skips the rows that share the last row's second but did not fit on the page, and a
|
|
590
|
+
* keyset on the served `(write_date, id)` re-reads its own last row forever, because a row served as
|
|
591
|
+
* `10:00:00` is stored after `10:00:00`. The extraction therefore walks (SECOND, id): it finishes one
|
|
592
|
+
* second by id (`s <= write_date < s+1s AND id > i`, ordered by id), then finds the next rows from the
|
|
593
|
+
* following second. Every row is read once per pass, however many rows share a second.
|
|
594
|
+
* spec-cite: N/A — Odoo 17.0 SOURCE, not a document: `odoo/models.py`
|
|
595
|
+
* `vals.setdefault('write_date', self.env.cr.now())`, `odoo/sql_db.py` `Cursor.now`
|
|
596
|
+
* (`SELECT (now() AT TIME ZONE 'UTC')`), `odoo/fields.py` `Datetime.to_string` (`strftime`), and no
|
|
597
|
+
* `Datetime.convert_to_column` override (the base field stores the full value).
|
|
598
|
+
*
|
|
599
|
+
* The lookback re-reads the last `lookbackSeconds` of changes at the START of every incremental pass.
|
|
600
|
+
* Odoo stamps `write_date` when the writing transaction runs, not when it commits, so a long
|
|
601
|
+
* transaction can commit a row whose `write_date` is already older than a watermark another pass
|
|
602
|
+
* advanced past in the meantime; without a lookback that row is never read — and a transaction that
|
|
603
|
+
* commits later inside the watermark's own second is caught the same way. Re-reads are free where it
|
|
604
|
+
* matters: the load compares content and writes nothing for an unchanged row. UNVERIFIED against a
|
|
605
|
+
* live Odoo — the default is a margin, not a measurement; raise it for a deployment with long batch
|
|
606
|
+
* jobs. `0` is NOT a harmless setting: without a lookback, a row written later inside a second a pass
|
|
607
|
+
* has already finished is read only when it changes again (or by a full pass).
|
|
608
|
+
*
|
|
609
|
+
* ## Changing the declaration resets the incremental track
|
|
610
|
+
*
|
|
611
|
+
* An incremental pass never re-reads a row that did not change remotely, so a change to what is
|
|
612
|
+
* extracted or how it is loaded — the binding, key fields, mapping, `sourceFilter`, partition fields,
|
|
613
|
+
* archived-record treatment, or the operator's partition ASSIGNMENTS — would otherwise never reach the
|
|
614
|
+
* rows already loaded. The run fingerprints those inputs; a different fingerprint drops the watermark,
|
|
615
|
+
* and the next incremental pass reads the whole source again. The run summary says it did.
|
|
616
|
+
*/
|
|
617
|
+
export const ExternalDataIncrementalExtractionDeclarationSchema = z.discriminatedUnion('mode', [
|
|
618
|
+
z.object({
|
|
619
|
+
mode: z.literal(ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE),
|
|
620
|
+
/**
|
|
621
|
+
* When FULL passes run (cron). The only deletion detector, so required. A full pass that takes
|
|
622
|
+
* several runs continues on `scheduleCron` ticks until it completes, interleaved with incremental
|
|
623
|
+
* passes; neither track waits for the other.
|
|
624
|
+
*/
|
|
625
|
+
fullPassCron: z.string().trim().min(1),
|
|
626
|
+
/** Seconds of changes re-read at the start of every incremental pass (see above). Up to one day. */
|
|
627
|
+
lookbackSeconds: z.number().int().nonnegative().max(86_400).default(300),
|
|
628
|
+
}),
|
|
629
|
+
/*
|
|
630
|
+
* ## The OData modified-at mode (#1722)
|
|
631
|
+
*
|
|
632
|
+
* `$filter=<modifiedAtRemoteField> ge <watermark − lookback>`, ordered by the KEY as a full pass is, paged
|
|
633
|
+
* by the service. Because the pages are in key order and not in modified-at order, a page's largest
|
|
634
|
+
* timestamp says nothing about the rows still to come, so the watermark moves only when the PASS completes
|
|
635
|
+
* (to the largest timestamp the pass read), never per page — a per-page watermark would skip the rows of
|
|
636
|
+
* a later page modified before it. `ge`, not `gt`: two rows sharing the watermark's instant are both read.
|
|
637
|
+
*
|
|
638
|
+
* The property must be an `Edm.DateTimeOffset` the service filters on. The lookback plays the role it
|
|
639
|
+
* plays for Odoo: a row written by a transaction that commits after the pass read past its timestamp is
|
|
640
|
+
* re-read by the next pass. Changing `modifiedAtRemoteField` starts the track over (the stored watermark
|
|
641
|
+
* names the property it was read on).
|
|
642
|
+
*/
|
|
643
|
+
z.object({
|
|
644
|
+
mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT),
|
|
645
|
+
fullPassCron: z.string().trim().min(1),
|
|
646
|
+
/** The entity's modified-at property (`Edm.DateTimeOffset`), by its REMOTE name. */
|
|
647
|
+
modifiedAtRemoteField: z.string().trim().min(1),
|
|
648
|
+
lookbackSeconds: z.number().int().nonnegative().max(86_400).default(300),
|
|
649
|
+
}),
|
|
650
|
+
/*
|
|
651
|
+
* ## The OData delta-link mode (#1722)
|
|
652
|
+
*
|
|
653
|
+
* The first incremental pass reads the whole entity set with `Prefer: odata.track-changes` and keeps the
|
|
654
|
+
* `@odata.deltaLink` the service puts on its last page; each later pass GETs that link and receives what
|
|
655
|
+
* changed and what was DELETED since. A deleted entity carries only its id, so the orphan policy is applied
|
|
656
|
+
* to that key — an incremental pass that finds deletions, which the other modes cannot.
|
|
657
|
+
*
|
|
658
|
+
* Refused at declaration: a `sourceFilter` (Dataverse refuses `$filter`, `$orderby`, `$expand` and `$top`
|
|
659
|
+
* with change tracking) and a composite key (a deleted entity names one id). A delta link the service no
|
|
660
|
+
* longer honours (`410 Gone`) resets the track and the same run falls back to a FULL pass, which is what
|
|
661
|
+
* finds the deletions the expired link would have reported; the run summary says so.
|
|
662
|
+
* spec-cite: Microsoft Learn, "Use change tracking to synchronize data with external systems"
|
|
663
|
+
* (https://learn.microsoft.com/en-us/power-apps/developer/data-platform/use-change-tracking-synchronize-data-external-systems),
|
|
664
|
+
* "Query options not supported in Change Tracking Web API request" — "System query options $filter,
|
|
665
|
+
* $orderby, $expand, and $top aren't supported when you use the Prefer: odata.track-changes header".
|
|
666
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §9.2.4 — "410 Gone indicates that the requested resource is
|
|
667
|
+
* no longer available. This can happen if a client has waited too long to follow a delta link".
|
|
668
|
+
*
|
|
669
|
+
* No lookback: a delta link is the service's own position, not a clock.
|
|
670
|
+
*/
|
|
671
|
+
z.object({
|
|
672
|
+
mode: z.literal(ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK),
|
|
673
|
+
fullPassCron: z.string().trim().min(1),
|
|
674
|
+
}),
|
|
103
675
|
]);
|
|
676
|
+
|
|
677
|
+
export type ExternalDataIncrementalExtractionDeclaration = z.infer<typeof ExternalDataIncrementalExtractionDeclarationSchema>;
|
|
678
|
+
|
|
679
|
+
/**
|
|
680
|
+
* The dialect each incremental mode is spoken over. A `Record` over the enum so a mode added without
|
|
681
|
+
* its dialect is a compile error rather than a declaration the coherence check silently waves through.
|
|
682
|
+
*/
|
|
683
|
+
export const EXTERNAL_DATA_INCREMENTAL_MODE_DIALECT: Readonly<Record<ExternalDataIncrementalExtractionMode, HttpApiTransportDialect>> = {
|
|
684
|
+
[ExternalDataIncrementalExtractionMode.ODOO_WRITE_DATE]: HttpApiTransportDialect.ODOO_JSONRPC,
|
|
685
|
+
[ExternalDataIncrementalExtractionMode.ODATA_MODIFIED_AT]: HttpApiTransportDialect.ODATA,
|
|
686
|
+
[ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK]: HttpApiTransportDialect.ODATA,
|
|
687
|
+
};
|
|
104
688
|
```
|
|
105
689
|
|
|
106
690
|
### Origin Package: `@wildo-ai/saas-models`
|
|
107
691
|
|
|
108
692
|
```typescript
|
|
109
693
|
export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
694
|
+
/**
|
|
695
|
+
* Which way rows travel — see {@link ExternalDataPipelineDirection}. `INBOUND` when omitted.
|
|
696
|
+
*
|
|
697
|
+
* An OUTBOUND pipeline (#1690) reuses this whole declaration with the arrows reversed: the binding opens the writes
|
|
698
|
+
* it sends (`writableVerbs: [CREATE, UPDATE]`, with the same `writeConcurrency` a read-through binding states), each
|
|
699
|
+
* `mapping` entry names the local field SENT and the remote field it lands on, and `remoteKeyLocalField` receives the
|
|
700
|
+
* key the system of record assigns when it creates the row. The fields that only describe reading a source —
|
|
701
|
+
* `sourceFilter`, `incremental`, `archivedRecords`, `partitionKeyLocalField`, `population`, `orphanPolicy` — are
|
|
702
|
+
* refused on it, because nothing would read them.
|
|
703
|
+
*/
|
|
110
704
|
direction: z.enum(ExternalDataPipelineDirection).default(ExternalDataPipelineDirection.INBOUND),
|
|
111
705
|
|
|
112
706
|
/**
|
|
@@ -119,6 +713,14 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
119
713
|
* different thing that no binding names), so a pipeline extracts the operator's rows and the
|
|
120
714
|
* destination's own scope declaration decides who may then read them.
|
|
121
715
|
*
|
|
716
|
+
* How the source is WALKED is the dialect's, and only drift-safe walks are admitted: OData v4 follows
|
|
717
|
+
* the server's `@odata.nextLink`; OData v2 (`ODATA_V2`, #1687) walks the binding's key fields and never
|
|
718
|
+
* follows `__next`, because v2 promises no stability across a partial listing; Odoo walks its id keyset;
|
|
719
|
+
* and a REST_JSON source walks the KEYSET its `list` statement declares
|
|
720
|
+
* (`operations.list.statement.keyset: { keyRemoteField }`, #1686) — the engine builds "the next N rows
|
|
721
|
+
* after the last key, in key order" and stores that key as the cursor.
|
|
722
|
+
* A REST source with no keyset (offset paging only) is refused.
|
|
723
|
+
*
|
|
122
724
|
* ⚠ OPERATIONAL HAZARD (PR-16): changing `keyFields` or a component CODEC after rows exist
|
|
123
725
|
* re-keys EVERY business key — the whole destination population orphans and re-creates on the
|
|
124
726
|
* next full pass, detaching local annotations (extension fields, files, chunks) from the rows
|
|
@@ -134,6 +736,13 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
134
736
|
* plain STRING business key. The factory requires it declared `.isBusinessKey()` +
|
|
135
737
|
* `excludeFromCreate/Update`: SYNC's idempotent upsert keys on it, and no caller may mint or
|
|
136
738
|
* move it.
|
|
739
|
+
*
|
|
740
|
+
* On an OUTBOUND pipeline (#1690) it is empty until the row is first sent: the engine writes the key the system of
|
|
741
|
+
* record answers the create with, exactly once, and then updates the remote row it names. It must therefore accept
|
|
742
|
+
* absence, and it is still excluded from create and update — a caller that could write it could point a local row at
|
|
743
|
+
* any remote record. It must be `.isUnique()` (global, sparse — the default) and `.optional()`, never `.nullable()`:
|
|
744
|
+
* one remote record, one local row, enforced by the store on every path that writes the key, while the rows not yet
|
|
745
|
+
* sent (no key) stay outside the index. No business key is required there: nothing upserts on it.
|
|
137
746
|
*/
|
|
138
747
|
remoteKeyLocalField: z.string().trim().min(1),
|
|
139
748
|
|
|
@@ -183,19 +792,71 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
183
792
|
|
|
184
793
|
population: z.enum(ExternalDataDestinationPopulation).default(ExternalDataDestinationPopulation.CLOSED),
|
|
185
794
|
|
|
795
|
+
/**
|
|
796
|
+
* Odoo sources only: whether ARCHIVED remote rows are loaded (#1732). Absent = `LOAD`. Archived rows
|
|
797
|
+
* are extracted and counted as observed under every treatment, so archiving a record in Odoo never
|
|
798
|
+
* reaches the orphan policy — see {@link ExternalDataArchivedRecordTreatment}.
|
|
799
|
+
*/
|
|
800
|
+
archivedRecords: ExternalDataArchivedRecordsDeclarationSchema.optional(),
|
|
801
|
+
|
|
186
802
|
orphanPolicy: z.enum(ExternalDataOrphanPolicy).default(ExternalDataOrphanPolicy.REPORT),
|
|
187
803
|
|
|
804
|
+
/**
|
|
805
|
+
* What a BIDIRECTIONAL pipeline (#1723) does with a row whose BOTH-owned fields changed on both sides since they last
|
|
806
|
+
* agreed — see {@link ExternalDataConflictPolicy}. Absent = REFUSE_AND_REPORT: nothing is overwritten that nobody
|
|
807
|
+
* decided to overwrite. Refused on any other direction, where no field has two owners.
|
|
808
|
+
*/
|
|
809
|
+
conflictPolicy: z.enum(ExternalDataConflictPolicy).optional(),
|
|
810
|
+
|
|
188
811
|
/**
|
|
189
812
|
* Cron expression for the scheduled refresh (crontabs machinery). Absent = on-demand only —
|
|
190
813
|
* legal, and honest for a manually-driven backfill.
|
|
191
814
|
*/
|
|
192
815
|
scheduleCron: z.string().trim().min(1).optional(),
|
|
193
816
|
|
|
817
|
+
/**
|
|
818
|
+
* Read only what changed between full passes (#1682). Absent = every pass is a FULL pass, the
|
|
819
|
+
* behaviour of every pipeline before this existed. When declared, `scheduleCron` runs incremental
|
|
820
|
+
* passes and `incremental.fullPassCron` runs the full passes that alone detect deletions — see
|
|
821
|
+
* {@link ExternalDataIncrementalExtractionDeclarationSchema}.
|
|
822
|
+
*/
|
|
823
|
+
incremental: ExternalDataIncrementalExtractionDeclarationSchema.optional(),
|
|
824
|
+
|
|
194
825
|
/**
|
|
195
826
|
* Extraction bound per run (v3.1 §2): a big backfill progresses across runs via the ledger's
|
|
196
827
|
* resumable cursor instead of owning one unbounded run. The default matches the rate-budget
|
|
197
828
|
* era's "bounded by construction" posture.
|
|
829
|
+
*
|
|
830
|
+
* A run ends on a PAGE boundary, so it may carry up to one page more than this — never fewer
|
|
831
|
+
* rows than the pass has left, and never a page cut short: the source's continuation follows the
|
|
832
|
+
* whole page, so rows cut from it would be read by no run. An OData v4 source asks for pages of
|
|
833
|
+
* `min(maxRowsPerRun, 1000)` (`Prefer: odata.maxpagesize`), which a service may honour or not
|
|
834
|
+
* (#1991). Whether a pass is COMPLETE is never decided from this number — only from the source
|
|
835
|
+
* answering that nothing is left.
|
|
836
|
+
*
|
|
837
|
+
* It bounds a run's WORK, not its memory: a run loads and checkpoints each page (up to 1 000 rows)
|
|
838
|
+
* before it reads the next (#1689), so it holds one page, and a run that fails part-way keeps the
|
|
839
|
+
* pages it loaded — the next run resumes after them.
|
|
198
840
|
*/
|
|
199
841
|
maxRowsPerRun: z.number().int().positive().default(10_000),
|
|
842
|
+
|
|
843
|
+
/**
|
|
844
|
+
* How long one run may spend before it stops at a page boundary (#1683) — the run's DEADLINE, in
|
|
845
|
+
* milliseconds.
|
|
846
|
+
*
|
|
847
|
+
* A run PACES against its source's rate budget: when the binding's `remoteCallSemantics
|
|
848
|
+
* .maxRequestsPerMinute` is full it waits for room instead of failing, and it waits as long as a
|
|
849
|
+
* throttling source's `Retry-After` asks. This bounds that waiting. No wait that would end past the
|
|
850
|
+
* deadline is taken and no page starts after it; the run then ends as a PARTIAL pass — every page it
|
|
851
|
+
* loaded is kept and its cursor continues the pass on the next run — never as a failure.
|
|
852
|
+
*
|
|
853
|
+
* It bounds extraction and load together: each page is loaded before the next is read (#1689), so a
|
|
854
|
+
* run finishes after the page it was working on, by at most one page's extraction and load.
|
|
855
|
+
*
|
|
856
|
+
* Fifteen minutes by default: well inside an hourly `scheduleCron`, and long enough that a pass of the
|
|
857
|
+
* default `maxRowsPerRun` completes at even a small binding ceiling. Six hours at most — a run that
|
|
858
|
+
* needs longer is a backfill, and resuming across runs is what the cursor is for.
|
|
859
|
+
*/
|
|
860
|
+
maxRunDurationMs: z.number().int().min(1_000).max(21_600_000).default(900_000),
|
|
200
861
|
});
|
|
201
862
|
```
|