@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
|
@@ -40,35 +40,12 @@
|
|
|
40
40
|
// Erasure stance (GDPR Art. 17 on rows we do not own)
|
|
41
41
|
// --------------------------------
|
|
42
42
|
|
|
43
|
-
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
*
|
|
43
|
+
/*
|
|
44
|
+
* `HttpApiErasureStance` lives in `./http-api-erasure-stance.shared` and is published from the package ROOT
|
|
45
|
+
* (#1710): three root-exported contracts name it, and a nominal enum reachable only through this subpath
|
|
46
|
+
* made their inferred types unnameable for a root-only consumer (TS2742). The binding arms below still
|
|
47
|
+
* discriminate on it.
|
|
48
48
|
*/
|
|
49
|
-
export enum HttpApiErasureStance {
|
|
50
|
-
/**
|
|
51
|
-
* (6a) The resource declares it holds NO personal/subject data. Registration verifies the
|
|
52
|
-
* declaration is coherent (e.g. `exportSubject` posture) and erasure is structurally N/A for
|
|
53
|
-
* the remote rows.
|
|
54
|
-
*/
|
|
55
|
-
NO_SUBJECT_DATA = 'no-subject-data',
|
|
56
|
-
|
|
57
|
-
/**
|
|
58
|
-
* (6b) The binding declares HOW erasure reaches the foreign system: one named API operation the
|
|
59
|
-
* engine invokes on a subject-erasure request. This is a single declared write and does NOT
|
|
60
|
-
* require general write support (slice 1 stays read-only otherwise).
|
|
61
|
-
*/
|
|
62
|
-
EXTERNAL_ERASURE_OPERATION = 'external-erasure-operation',
|
|
63
|
-
|
|
64
|
-
/**
|
|
65
|
-
* (6c) Erasure REFUSES by default; an explicit, per-request, audited controller acknowledgement
|
|
66
|
-
* lets it proceed and records the un-erased remote rows at high severity. Mirrors the existing
|
|
67
|
-
* administrative-floor acknowledgement shape (`administrative-continuity-floors.md`): the record
|
|
68
|
-
* is the control. NEVER a standing default — the acknowledgement is per erasure request.
|
|
69
|
-
*/
|
|
70
|
-
CONTROLLER_ACKNOWLEDGED_NON_ERASURE = 'controller-acknowledged-non-erasure',
|
|
71
|
-
}
|
|
72
49
|
|
|
73
50
|
/*
|
|
74
51
|
* ─── `HttpApiTenancyStance` was REMOVED here (#1055), and NOT replaced by a narrower vocabulary ──
|
|
@@ -122,6 +99,575 @@ export enum HttpApiKeyComponentCodec {
|
|
|
122
99
|
*/
|
|
123
100
|
DATETIME_ISO = 'datetime-iso',
|
|
124
101
|
}
|
|
102
|
+
|
|
103
|
+
// --------------------------------
|
|
104
|
+
// Write verbs a binding OPENS (#1679)
|
|
105
|
+
// --------------------------------
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* A row-level write a read-through resource may send to its system of record.
|
|
109
|
+
*
|
|
110
|
+
* Three members and no bulk ones, deliberately. A bulk write against a system the platform does not
|
|
111
|
+
* own has no atomicity to offer — ten rows are ten remote calls, any of which can fail after the ones
|
|
112
|
+
* before it landed — so the engine opens single-row create, update and delete by key, and nothing
|
|
113
|
+
* else. `createMany`, `updateMany`, `deleteMany`, the guarded atomic primitives and the raw-filter
|
|
114
|
+
* doors stay refused by name on the repository.
|
|
115
|
+
*
|
|
116
|
+
* ## Why the binding declares them at all, when the resource already lists its operations
|
|
117
|
+
*
|
|
118
|
+
* Because opening a write door into somebody else's ERP is a decision of its own, taken where the
|
|
119
|
+
* remote contract is written. The resource's operation list says which HTTP routes exist; this says
|
|
120
|
+
* the binding may WRITE through them. The resource factory refuses the two disagreeing in EITHER
|
|
121
|
+
* direction — a write operation whose verb the binding does not open, and an opened verb no operation
|
|
122
|
+
* uses — so the second declaration can never drift from the first into an inert door or an open one.
|
|
123
|
+
*
|
|
124
|
+
* Absent is empty: every binding written before #1679 stays read-only without a change.
|
|
125
|
+
*/
|
|
126
|
+
export enum HttpApiWriteVerb {
|
|
127
|
+
/** A new remote row. The engine derives its partition from the caller's organization unit. */
|
|
128
|
+
CREATE = 'create',
|
|
129
|
+
/** A change to one remote row, addressed by its synthesized id. Read first, then written. */
|
|
130
|
+
UPDATE = 'update',
|
|
131
|
+
/** The removal of one remote row, addressed by its synthesized id. Read first, then deleted. */
|
|
132
|
+
DELETE = 'delete',
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* What protects an UPDATE against overwriting a change made since its author read the row (#1724, #1726, #1728) —
|
|
137
|
+
* declared by every binding that opens UPDATE, whatever its dialect (ODOO_JSONRPC, ODATA, REST_JSON).
|
|
138
|
+
*
|
|
139
|
+
* ## Why a binding must say this at all
|
|
140
|
+
*
|
|
141
|
+
* An update that carries no version is last-writer-wins, whatever the vendor could have offered: Odoo's external API
|
|
142
|
+
* applies `write(ids, vals)` unconditionally, a REST_JSON write is sent with no precondition, and an OData service
|
|
143
|
+
* applies a `PATCH` whose `If-Match` matches — which a caller who never read the row cannot make match anything but
|
|
144
|
+
* `*`. A default nobody chose is a lost update nobody expects, so a binding that opens UPDATE states which of the two it
|
|
145
|
+
* accepts, and the factory refuses the omission.
|
|
146
|
+
*
|
|
147
|
+
* ## What VERSION_CHECKED is, honestly — it depends on the dialect
|
|
148
|
+
*
|
|
149
|
+
* The caller sends the row version it read (the local field named by `versionField`, mapped onto the vendor's
|
|
150
|
+
* `rowVersionField` — Odoo `write_date`, an OData service's `@odata.etag`). The engine reads the row just before
|
|
151
|
+
* writing it — the read it already makes to check the partition — and refuses the update when the versions differ,
|
|
152
|
+
* before anything is sent. Then:
|
|
153
|
+
*
|
|
154
|
+
* - **Odoo: best-effort.** Odoo takes no precondition, so the comparison and the write are two calls. That NARROWS the
|
|
155
|
+
* race to the gap between them; it does NOT close it. A change landing inside that gap is overwritten, and a vendor
|
|
156
|
+
* that serves its version coarsely (Odoo: to the second) cannot tell two changes in the same second apart.
|
|
157
|
+
* - **REST_JSON: best-effort, as on Odoo** — the write is sent as declared, with no precondition. It is available only
|
|
158
|
+
* where the vendor facet declares a `rowVersionField`; neither the Salesforce nor the NetSuite facet does, so a
|
|
159
|
+
* binding against them states LAST_WRITER_WINS (startup refuses VERSION_CHECKED there).
|
|
160
|
+
* - **OData: atomic.** The version is also sent as `If-Match`, so the SERVICE compares it with the row it is about to
|
|
161
|
+
* change and answers `412 Precondition Failed` without applying anything when it moved — the gap is closed by the
|
|
162
|
+
* vendor, not narrowed by the engine.
|
|
163
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §8.2.4 (Header If-Match).
|
|
164
|
+
*/
|
|
165
|
+
export enum HttpApiWriteConcurrencyMode {
|
|
166
|
+
/**
|
|
167
|
+
* Every UPDATE carries the version its author read, and a stale one is refused before sending. Best-effort on Odoo
|
|
168
|
+
* and REST_JSON; atomic on OData, where the version also travels as `If-Match`.
|
|
169
|
+
*/
|
|
170
|
+
VERSION_CHECKED = 'version-checked',
|
|
171
|
+
/**
|
|
172
|
+
* No check against the version the CALLER read: the last update sent wins. Stated, so it is a decision rather than an
|
|
173
|
+
* accident. On OData the engine still sends the entity tag of the row it read first (or `*` when the row carries
|
|
174
|
+
* none), so a row that moved between that read and the write is refused, and a row deleted in between is never
|
|
175
|
+
* re-created by an upsert.
|
|
176
|
+
*/
|
|
177
|
+
LAST_WRITER_WINS = 'last-writer-wins',
|
|
178
|
+
}
|
|
179
|
+
```
|
|
180
|
+
|
|
181
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
182
|
+
|
|
183
|
+
```typescript
|
|
184
|
+
/**
|
|
185
|
+
* What kind of TEMPORAL value a remote field holds, when a query statement compares it (#1972).
|
|
186
|
+
*
|
|
187
|
+
* A statement language spells a date and a date-time differently, and neither accepts a quoted string:
|
|
188
|
+
*
|
|
189
|
+
* | language | `DATE` | `DATE_TIME` |
|
|
190
|
+
* |---|---|---|
|
|
191
|
+
* | SOQL | `2026-01-05` (unquoted) | `2026-01-05T10:00:00Z` (unquoted, whole seconds) |
|
|
192
|
+
* | SuiteQL | `TO_DATE('2026-01-05', 'YYYY-MM-DD')` ¹ | `TO_DATE('2026-01-05 10:00:00', 'YYYY-MM-DD HH24:MI:SS')` |
|
|
193
|
+
*
|
|
194
|
+
* ¹ spec-cite: N/A — the date-only mask is Oracle SQL's `TO_DATE` convention (SuiteQL is SQL-92 / Oracle SQL);
|
|
195
|
+
* NetSuite's page shows only the date-time mask cited below.
|
|
196
|
+
*
|
|
197
|
+
* Which one a field needs is a fact about the REMOTE column that nothing in a local `Date` carries, so a
|
|
198
|
+
* statement read that filters a date field DECLARES it; a date compared with an undeclared field is refused
|
|
199
|
+
* rather than guessed, because the wrong form is refused by the vendor or silently compares as text.
|
|
200
|
+
* spec-cite: Salesforce, "SOQL and SOSL Reference" v68.0, WHERE › "Date Formats and Date Literals in WHERE" —
|
|
201
|
+
* `WHERE CreatedDate > 2005-10-08T01:02:03Z`; `date YYYY-MM-DD`; `dateTime YYYY-MM-DDThh:mm:ss+hh:mm,
|
|
202
|
+
* YYYY-MM-DDThh:mm:ss-hh:mm, or YYYY-MM-DDThh:mm:ssZ`.
|
|
203
|
+
* spec-cite: Oracle NetSuite, "SuiteQL Performance and Best Practices" (article_0824094533) — "You can't use date
|
|
204
|
+
* literals. You must encapsulate dates using the `to_date()` function."; "Do not use plain string values for date
|
|
205
|
+
* comparisons."; `where lastmodifieddate >= TO_DATE('2024-01-01 00:00:00', 'yyyy-mm-dd hh24:mi:ss')`.
|
|
206
|
+
*
|
|
207
|
+
* Read by the REST_JSON STATEMENT compilers only; declared on another dialect, or on a REST_JSON binding none of
|
|
208
|
+
* whose read members is a statement, it would change nothing, so the binding coherence refuses it there.
|
|
209
|
+
*/
|
|
210
|
+
export enum HttpApiRemoteTemporalKind {
|
|
211
|
+
/** A calendar date with no time — SOQL `date`, a NetSuite date column. */
|
|
212
|
+
DATE = 'date',
|
|
213
|
+
/** An instant — SOQL `dateTime`, a NetSuite datetime column. */
|
|
214
|
+
DATE_TIME = 'date-time',
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* Local-to-remote field name mapping for fields whose names differ. Fields not listed map by
|
|
219
|
+
* identity (same name both sides). Key components are declared in `keyFields`, not here.
|
|
220
|
+
*
|
|
221
|
+
* A REST_JSON statement read that FILTERS a temporal field lists it here — with the same name on both sides
|
|
222
|
+
* when they agree — to declare its `temporalKind`.
|
|
223
|
+
*/
|
|
224
|
+
export const HttpApiFieldMappingSchema = z.object({
|
|
225
|
+
localField: z.string().min(1),
|
|
226
|
+
remoteField: z.string().min(1),
|
|
227
|
+
/** The remote column's temporal kind, when a statement compares it with a date — see {@link HttpApiRemoteTemporalKind}. */
|
|
228
|
+
temporalKind: z.enum(HttpApiRemoteTemporalKind).optional(),
|
|
229
|
+
});
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
233
|
+
|
|
234
|
+
```typescript
|
|
235
|
+
/**
|
|
236
|
+
* Where a declared REST parameter is placed on the request, when the method's own answer is wrong for it (#1686).
|
|
237
|
+
*/
|
|
238
|
+
export enum HttpApiRestParameterPlacement {
|
|
239
|
+
/**
|
|
240
|
+
* The URL query string, whatever the method — NetSuite's SuiteQL `limit` and `offset` on a POST.
|
|
241
|
+
* spec-cite: Oracle NetSuite, "Executing SuiteQL Queries Through REST Web Services" (section_157909186990) — the
|
|
242
|
+
* statement is POSTed as `{"q": …}` and paged by `?limit=10&offset=10` on the request URL.
|
|
243
|
+
*/
|
|
244
|
+
QUERY_STRING = 'query-string',
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/**
|
|
248
|
+
* REST_JSON per-operation declaration: how one read-family member maps onto a concrete HTTP
|
|
249
|
+
* operation. Deliberately minimal in slice 1 — pagination/filter parameter NAMES are declared,
|
|
250
|
+
* their VALUES are supplied by the adapter from the translated query.
|
|
251
|
+
*
|
|
252
|
+
* Related but distinct: `ProviderRestOperation` on a provider's `rest` runtime contract describes a
|
|
253
|
+
* VENDOR operation — one entry in the catalogue a reference below names. This schema describes a
|
|
254
|
+
* RESOURCE read surface, which is a different thing and stays here.
|
|
255
|
+
*
|
|
256
|
+
* (An earlier revision pointed at `REST_API_OperationSpecSchema` in
|
|
257
|
+
* `@wildo-ai/external-connectors-models` "for capability transformers". Both are gone: the
|
|
258
|
+
* transformer layer was retired with `features/` in #327, and that OpenAPI-shaped operations layer
|
|
259
|
+
* — ten exported symbols with zero code readers — was deleted in #331 rather than wired up, so
|
|
260
|
+
* "what a provider can do" has one description instead of two.)
|
|
261
|
+
*
|
|
262
|
+
* The convergence performed in S3a (#331) — a member naming an operation in a PROVIDER's own
|
|
263
|
+
* catalogue — was UNDONE in #1055. A system of record is not a connector (D10), and a read that
|
|
264
|
+
* depends on a provider catalogue being loadable is the crossing that decision forbids. An inline
|
|
265
|
+
* spec is now the only form, which is what every authored binding used anyway.
|
|
266
|
+
*/
|
|
267
|
+
/**
|
|
268
|
+
* A query LANGUAGE a REST system of record reads through, rather than a set of filter parameters
|
|
269
|
+
* (#1293).
|
|
270
|
+
*
|
|
271
|
+
* Two vendors read this way and neither can be expressed as parameters: Salesforce takes SOQL and
|
|
272
|
+
* NetSuite takes SuiteQL, each as ONE statement naming the fields, the entity, the predicates and
|
|
273
|
+
* the order. A `filterParams` map cannot say "SELECT these columns FROM that object", so without this
|
|
274
|
+
* neither vendor can be declared at all.
|
|
275
|
+
*
|
|
276
|
+
* ## Why this is a closed vocabulary and not a template string
|
|
277
|
+
*
|
|
278
|
+
* A statement is BUILT, and building means escaping. Each language has its own literal rules and its
|
|
279
|
+
* own paging spelling, and a template with `{filter}` holes would put the escaping in the author's
|
|
280
|
+
* hands — an injection surface in a file nobody reviews as one. The engine builds the statement and
|
|
281
|
+
* the vocabulary names which grammar to build.
|
|
282
|
+
*
|
|
283
|
+
* This is the same trade the OData compiler already makes for `$filter`: expressions are composed
|
|
284
|
+
* here, literals are escaped by one function, and no authored string reaches the wire uninspected.
|
|
285
|
+
*/
|
|
286
|
+
export enum HttpApiQueryStatementLanguage {
|
|
287
|
+
/**
|
|
288
|
+
* Salesforce Object Query Language.
|
|
289
|
+
*
|
|
290
|
+
* spec-cite: Salesforce Developers, "SOQL and SOSL Reference" —
|
|
291
|
+
* https://developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/
|
|
292
|
+
*
|
|
293
|
+
* `SELECT *` does not exist: every field is named, which the binding's `fieldMappings` and key
|
|
294
|
+
* fields already supply. Paging is by the response's own continuation rather than by `OFFSET`,
|
|
295
|
+
* which SOQL bounds at 2000 rows.
|
|
296
|
+
*/
|
|
297
|
+
SOQL = 'soql',
|
|
298
|
+
/**
|
|
299
|
+
* NetSuite SuiteQL — an SQL-92 dialect over its analytics schema.
|
|
300
|
+
*
|
|
301
|
+
* spec-cite: Oracle NetSuite, "SuiteQL" —
|
|
302
|
+
* https://docs.oracle.com/en/cloud/saas/netsuite/ns-online-help/section_156257770590.html
|
|
303
|
+
*
|
|
304
|
+
* Paged by `limit` / `offset` QUERY parameters rather than inside the statement, which is why the
|
|
305
|
+
* statement declaration and `pagingParams` are independent.
|
|
306
|
+
*/
|
|
307
|
+
SUITEQL = 'suiteql',
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
/**
|
|
311
|
+
* Where a KEYSET page's size bound goes, per statement language (#1686).
|
|
312
|
+
*
|
|
313
|
+
* A keyset page is "the next N rows after the last key", so the statement's predicate and order are
|
|
314
|
+
* the same in every language — `<key> > <last key> … ORDER BY <key> ASC` — and only the size bound
|
|
315
|
+
* differs. Decided by the LANGUAGE, never declared by an author: it is a fact about the grammar.
|
|
316
|
+
*/
|
|
317
|
+
export enum HttpApiKeysetPageBound {
|
|
318
|
+
/**
|
|
319
|
+
* The statement carries `LIMIT <n>` itself — SOQL, which has no size parameter on `/query`.
|
|
320
|
+
*
|
|
321
|
+
* The vendor may still split the limited result into several BATCHES and answer the first one with
|
|
322
|
+
* a continuation (`nextRecordsUrl`), so a keyset page on this bound follows the operation's declared
|
|
323
|
+
* `cursorPath` inside the page until the result is exhausted — which is why the bound requires one.
|
|
324
|
+
* Without it, a batch shorter than the limit would read as the end of the pass and every row after
|
|
325
|
+
* it would go unread, and a DELETE orphan policy would then delete them.
|
|
326
|
+
* spec-cite: Salesforce REST API Developer Guide v68.0, "Query" — "up to 2,000 records can be returned
|
|
327
|
+
* at a time … the returned batch can include fewer records than the limit or what's set in the
|
|
328
|
+
* request … If the total number of results exceeds the limit or the requested number of results, the
|
|
329
|
+
* response contains the first batch of records, a false value for done, and a query locator."
|
|
330
|
+
*/
|
|
331
|
+
STATEMENT_LIMIT_CLAUSE = 'statement-limit-clause',
|
|
332
|
+
/**
|
|
333
|
+
* The operation's declared `pagingParams.limitParam` carries the size, and its `offsetParam` is sent
|
|
334
|
+
* as 0 on every page — SuiteQL, which pages by `limit`/`offset` query parameters.
|
|
335
|
+
*
|
|
336
|
+
* Offset 0 always: each page is a NEW query that starts after the last key, so no offset is ever
|
|
337
|
+
* needed, and none of the offset rules (an offset divisible by the limit, the result ceiling) is
|
|
338
|
+
* ever reached.
|
|
339
|
+
* spec-cite: Oracle NetSuite, "Collection Paging" (section_156414087576) — "You can only set offset
|
|
340
|
+
* and limit values in a way that the offset is divisible by the limit"; "Executing SuiteQL Queries
|
|
341
|
+
* Through REST Web Services" (section_157909186990) — "Using SuiteQL queries, you can return a
|
|
342
|
+
* maximum of 100,000 results."
|
|
343
|
+
*/
|
|
344
|
+
LIMIT_PARAMETER = 'limit-parameter',
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
/** The page bound of each statement language. A `Record` over the enum, so a new language is a compile error until it has one. */
|
|
348
|
+
export const HTTP_API_KEYSET_PAGE_BOUND: Readonly<Record<HttpApiQueryStatementLanguage, HttpApiKeysetPageBound>> = {
|
|
349
|
+
[HttpApiQueryStatementLanguage.SOQL]: HttpApiKeysetPageBound.STATEMENT_LIMIT_CLAUSE,
|
|
350
|
+
[HttpApiQueryStatementLanguage.SUITEQL]: HttpApiKeysetPageBound.LIMIT_PARAMETER,
|
|
351
|
+
};
|
|
352
|
+
|
|
353
|
+
/**
|
|
354
|
+
* The key codecs a keyset may walk (#1686): an INTEGER compares as a number and a STRING by code
|
|
355
|
+
* unit, and the engine CHECKS every served page against that order before trusting its last key.
|
|
356
|
+
*
|
|
357
|
+
* GUID and DATETIME_ISO are refused. A GUID has no order the vendors agree on — SQL Server sorts a
|
|
358
|
+
* `uniqueidentifier` by its last bytes first — so a page could never be checked; a datetime is not
|
|
359
|
+
* unique, and a keyset on a non-unique column skips the rows that share the boundary value.
|
|
360
|
+
*/
|
|
361
|
+
export const HTTP_API_KEYSET_ELIGIBLE_CODECS: readonly HttpApiKeyComponentCodec[] = [
|
|
362
|
+
HttpApiKeyComponentCodec.INTEGER,
|
|
363
|
+
HttpApiKeyComponentCodec.STRING,
|
|
364
|
+
];
|
|
365
|
+
|
|
366
|
+
/**
|
|
367
|
+
* A declared KEYSET on a statement read (#1686) — what lets a REST system of record feed a pipeline.
|
|
368
|
+
*
|
|
369
|
+
* ## What it makes the engine build
|
|
370
|
+
*
|
|
371
|
+
* For the pipeline's extraction, the `list` member's statement becomes
|
|
372
|
+
*
|
|
373
|
+
* ```
|
|
374
|
+
* SELECT <mapped fields> FROM <entity> WHERE <sourceFilter> AND <key> > <last key> ORDER BY <key> ASC
|
|
375
|
+
* ```
|
|
376
|
+
*
|
|
377
|
+
* with the page size bounded per {@link HttpApiKeysetPageBound} (SOQL `LIMIT <n>`; SuiteQL
|
|
378
|
+
* `limit=<n>&offset=0`). The last key of each page is the pipeline's persisted cursor, and a page
|
|
379
|
+
* shorter than asked ends the pass — the Odoo id-keyset discipline, drift-safe for the same reason: a
|
|
380
|
+
* row inserted or deleted mid-pass never shifts the rows after the cursor, so none is skipped or read
|
|
381
|
+
* twice. Offset paging has neither property, which is why a REST source without a keyset stays
|
|
382
|
+
* refused.
|
|
383
|
+
*
|
|
384
|
+
* ## Why there is no cursor PLACEHOLDER to write
|
|
385
|
+
*
|
|
386
|
+
* The statement is BUILT by the engine (#1293), never templated by an author, so there is nowhere for a
|
|
387
|
+
* `:cursor` placeholder to go and no ORDER BY an author could forget: declaring the keyset is what puts
|
|
388
|
+
* both into the statement, and the engine writes them itself. What an author declares is only which
|
|
389
|
+
* column the walk runs on.
|
|
390
|
+
*
|
|
391
|
+
* ## Which column
|
|
392
|
+
*
|
|
393
|
+
* The binding's ONE key field — unique and immutable, which is what a keyset needs. Named by its
|
|
394
|
+
* remote field; its codec is the key field's own, so the two cannot disagree. A composite key is
|
|
395
|
+
* refused: one component of it is not unique.
|
|
396
|
+
*
|
|
397
|
+
* ## A vendor continuation is followed INSIDE a page, never persisted
|
|
398
|
+
*
|
|
399
|
+
* Salesforce's `nextRecordsUrl` names a server-side query locator. How long a locator lives is not
|
|
400
|
+
* stated in the REST API guide (UNVERIFIED), so it is never the cross-run cursor: the key is.
|
|
401
|
+
*/
|
|
402
|
+
export const HttpApiQueryStatementKeysetSchema = z.strictObject({
|
|
403
|
+
/** The remote field of the binding's single key field — Salesforce `Id`, NetSuite `id`. */
|
|
404
|
+
keyRemoteField: z.string().min(1),
|
|
405
|
+
});
|
|
406
|
+
export type HttpApiQueryStatementKeyset = z.infer<typeof HttpApiQueryStatementKeysetSchema>;
|
|
407
|
+
|
|
408
|
+
/**
|
|
409
|
+
* How a read member builds and sends a query STATEMENT (#1293).
|
|
410
|
+
*
|
|
411
|
+
* Declared per operation rather than per binding, because a vendor's `read` and `list` genuinely
|
|
412
|
+
* differ: Salesforce addresses one record at `/sobjects/Account/{key}` and queries collections
|
|
413
|
+
* through `/query`, and only the second is a statement at all.
|
|
414
|
+
*/
|
|
415
|
+
export const HttpApiQueryStatementSpecSchema = z.object({
|
|
416
|
+
language: z.enum(HttpApiQueryStatementLanguage),
|
|
417
|
+
/**
|
|
418
|
+
* The parameter or body member the statement is placed in (`q` for both vendors surveyed).
|
|
419
|
+
*
|
|
420
|
+
* WHERE it lands is not declared, because the operation's own `method` already decides: a GET puts
|
|
421
|
+
* parameters in the query string and a POST puts them in the JSON body, which is what the request
|
|
422
|
+
* builder has always done. A `placement` field was drafted here and removed before it shipped — it
|
|
423
|
+
* would have been a second declaration of something the method already says, free to disagree with
|
|
424
|
+
* it. Salesforce is a GET with `?q=`, NetSuite a POST with `{"q": …}`, and neither needs to be told
|
|
425
|
+
* twice. PAGING is the one parameter the method places wrongly for a vendor — NetSuite reads its
|
|
426
|
+
* `limit`/`offset` from the URL of that POST — which is why `pagingParams` carries its own
|
|
427
|
+
* `placement` (#1686) while the statement does not.
|
|
428
|
+
*/
|
|
429
|
+
parameterName: z.string().min(1),
|
|
430
|
+
/**
|
|
431
|
+
* The object the statement selects FROM. Absent = the binding's `entityRef`, which is the ordinary
|
|
432
|
+
* case; present when the vendor's query schema names an object differently from its REST resource.
|
|
433
|
+
*/
|
|
434
|
+
fromEntity: z.string().min(1).optional(),
|
|
435
|
+
/**
|
|
436
|
+
* The KEYSET a pipeline extraction walks (#1686) — see {@link HttpApiQueryStatementKeysetSchema}.
|
|
437
|
+
* Declared on the `list` member only. Absent = the binding can be read through, and cannot feed a
|
|
438
|
+
* pipeline.
|
|
439
|
+
*/
|
|
440
|
+
keyset: HttpApiQueryStatementKeysetSchema.optional(),
|
|
441
|
+
});
|
|
442
|
+
export type HttpApiQueryStatementSpec = z.infer<typeof HttpApiQueryStatementSpecSchema>;
|
|
443
|
+
|
|
444
|
+
export const HttpApiRestOperationSpecSchema = z.object({
|
|
445
|
+
/** HTTP method for this read-family operation. */
|
|
446
|
+
method: z.enum(HttpApiRestOperationMethod),
|
|
447
|
+
|
|
448
|
+
/**
|
|
449
|
+
* Path template relative to the provider's base URL. `{key}` interpolates the synthesized
|
|
450
|
+
* key's remote addressing form; other `{param}` tokens must be declared parameter names.
|
|
451
|
+
*/
|
|
452
|
+
pathTemplate: z.string().min(1),
|
|
453
|
+
|
|
454
|
+
/** Query/body parameter names for pagination, when the operation supports it. */
|
|
455
|
+
pagingParams: z
|
|
456
|
+
.object({
|
|
457
|
+
limitParam: z.string().min(1),
|
|
458
|
+
offsetParam: z.string().min(1),
|
|
459
|
+
/**
|
|
460
|
+
* Where the two paging parameters go (#1686). Absent = where the operation's method puts every
|
|
461
|
+
* parameter: the query string of a GET, the JSON body of a POST.
|
|
462
|
+
*
|
|
463
|
+
* NetSuite is why this exists: its SuiteQL read is a POST whose BODY is the statement and whose
|
|
464
|
+
* paging is in the URL, so a method-placed `limit` lands in the body, where the vendor does not
|
|
465
|
+
* read it, and the page is not bounded at all.
|
|
466
|
+
*/
|
|
467
|
+
placement: z.enum(HttpApiRestParameterPlacement).optional(),
|
|
468
|
+
})
|
|
469
|
+
.optional(),
|
|
470
|
+
|
|
471
|
+
/**
|
|
472
|
+
* Declared filter parameter name per LOCAL field. Only fields listed here are translatable for
|
|
473
|
+
* this operation (scope-down paper, shape T3); everything else is refused at the adapter
|
|
474
|
+
* boundary.
|
|
475
|
+
*/
|
|
476
|
+
filterParams: z.record(z.string().min(1), z.string().min(1)).optional(),
|
|
477
|
+
|
|
478
|
+
/**
|
|
479
|
+
* The parameter that receives the SEARCH text (T4), for a `search` operation. Absent =
|
|
480
|
+
* search is refused for this binding even when the operation exists.
|
|
481
|
+
*/
|
|
482
|
+
searchParam: z.string().min(1).optional(),
|
|
483
|
+
|
|
484
|
+
/**
|
|
485
|
+
* Dot-path to the payload inside the response body — the rows array (list/search), the entity
|
|
486
|
+
* object (read), or the number (count). Absent = the body IS the payload. Declared, never
|
|
487
|
+
* sniffed: response shapes vary per target (`items`, `result`, `value`, raw array) and a wrong
|
|
488
|
+
* guess would silently read zero rows.
|
|
489
|
+
*/
|
|
490
|
+
resultPath: z.string().min(1).optional(),
|
|
491
|
+
|
|
492
|
+
/** Wrap request/response in a JSON-RPC 2.0 envelope (the Odoo variant). */
|
|
493
|
+
jsonRpcEnvelope: z
|
|
494
|
+
.object({
|
|
495
|
+
rpcMethod: z.string().min(1),
|
|
496
|
+
})
|
|
497
|
+
.optional(),
|
|
498
|
+
|
|
499
|
+
/**
|
|
500
|
+
* Read through a query STATEMENT rather than through filter parameters (#1293).
|
|
501
|
+
*
|
|
502
|
+
* Mutually exclusive with `filterParams` and `searchParam` in practice rather than by schema: a
|
|
503
|
+
* statement expresses its own predicates, so a declaration carrying both has said the same thing
|
|
504
|
+
* twice in two grammars. The compiler refuses that pairing, where it can name which one it was
|
|
505
|
+
* about to ignore.
|
|
506
|
+
*/
|
|
507
|
+
statement: HttpApiQueryStatementSpecSchema.optional(),
|
|
508
|
+
|
|
509
|
+
/**
|
|
510
|
+
* Dot-path to a CONTINUATION URL in the response — Salesforce's `nextRecordsUrl` (#1293).
|
|
511
|
+
*
|
|
512
|
+
* Declared rather than sniffed, for the same reason `resultPath` is: response shapes vary per
|
|
513
|
+
* target and a wrong guess reads zero rows silently. Absent means the operation pages by
|
|
514
|
+
* `pagingParams` or not at all.
|
|
515
|
+
*
|
|
516
|
+
* A continuation is followed only on the target's OWN origin, exactly as the OData one is — the
|
|
517
|
+
* link comes from a remote response body and carries this deployment's credentials wherever it
|
|
518
|
+
* points.
|
|
519
|
+
*/
|
|
520
|
+
cursorPath: z.string().min(1).optional(),
|
|
521
|
+
|
|
522
|
+
/**
|
|
523
|
+
* Headers this vendor requires on the request — NetSuite's `Prefer: transient` (#1293).
|
|
524
|
+
*
|
|
525
|
+
* VENDOR headers only. A credential never goes here: credentials come from the instance's access,
|
|
526
|
+
* and a header authored in a binding would be a second credential channel in a file that is
|
|
527
|
+
* committed. The compiler refuses an `authorization` key by name rather than trusting the author.
|
|
528
|
+
*/
|
|
529
|
+
staticHeaders: z.record(z.string().min(1), z.string().min(1)).optional(),
|
|
530
|
+
});
|
|
531
|
+
|
|
532
|
+
export type HttpApiRestOperationSpec = z.infer<typeof HttpApiRestOperationSpecSchema>;
|
|
533
|
+
```
|
|
534
|
+
|
|
535
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
536
|
+
|
|
537
|
+
```typescript
|
|
538
|
+
/**
|
|
539
|
+
* The fields EVERY binding carries, whatever its dialect — spread into each arm of the union below.
|
|
540
|
+
*/
|
|
541
|
+
const httpApiResourceBindingBaseShape = {
|
|
542
|
+
/**
|
|
543
|
+
* The SYSTEM OF RECORD this resource lives in, by the NAME the application declared it under in
|
|
544
|
+
* `wildo.saas.config.ts` (`systemsOfRecord.<name>`, #1055).
|
|
545
|
+
*
|
|
546
|
+
* ## Why a name, and not a provider ref
|
|
547
|
+
*
|
|
548
|
+
* `providerRef` named a PROVIDER, and a provider's env-var names live in its module — so one ref
|
|
549
|
+
* was one deployment, and a second Odoo was unrepresentable. A name here is an INSTANCE: two
|
|
550
|
+
* (`odoo-fr`, `odoo-de`) share one vendor facet and differ only in the environment variables their
|
|
551
|
+
* names derive. It is also not a provider in any other sense (D10): nothing here is selected
|
|
552
|
+
* through the capability plane, carries a person's lent credential, or has an operation catalogue.
|
|
553
|
+
*
|
|
554
|
+
* ## What validates it, and where
|
|
555
|
+
*
|
|
556
|
+
* Not here, and not in the resource factory — the factory runs in the application's `shared-lib`,
|
|
557
|
+
* where the saas configuration is not in scope. The factory checks SHAPE; the boot registry checks
|
|
558
|
+
* that this name is DECLARED and that `dialect` below equals the instance's, at the first moment
|
|
559
|
+
* both are visible. That split is the honest one rather than a compromise.
|
|
560
|
+
*/
|
|
561
|
+
system: z.string().min(1),
|
|
562
|
+
|
|
563
|
+
/**
|
|
564
|
+
* The remote entity addressed by this binding — an OData entity-set name, or a logical name for
|
|
565
|
+
* a REST_JSON surface. One binding, one remote entity set.
|
|
566
|
+
*/
|
|
567
|
+
entityRef: z.string().min(1),
|
|
568
|
+
|
|
569
|
+
/*
|
|
570
|
+
* `connection` was here, and it is GONE (#1055 D12).
|
|
571
|
+
*
|
|
572
|
+
* It declared WHOSE ACCOUNT a binding spends — `ORGANIZATION × USER` and its siblings — which is a
|
|
573
|
+
* real question for a CONNECTOR, where a customer connects their own account. A system of record is
|
|
574
|
+
* not that: it is a deployment the application reads its own business rows out of, with its own
|
|
575
|
+
* service identity, and the only honest answer was always `APPLICATION × SERVICE`. A field with one
|
|
576
|
+
* legal value is a question nobody should be asked.
|
|
577
|
+
*
|
|
578
|
+
* The customer-connection case is case 2 of #1049 and keeps the connector resolver, untouched.
|
|
579
|
+
*/
|
|
580
|
+
|
|
581
|
+
/** Ordered key declaration — the source of the synthesized engine-facing `_id` (paper A). */
|
|
582
|
+
keyFields: z.array(HttpApiKeyFieldSchema).min(1),
|
|
583
|
+
|
|
584
|
+
/** Non-key field name mappings; unlisted fields map by identity. */
|
|
585
|
+
fieldMappings: z.array(HttpApiFieldMappingSchema).default([]),
|
|
586
|
+
|
|
587
|
+
/*
|
|
588
|
+
* `tenancy` was here, and it is GONE (#1055 §5).
|
|
589
|
+
*
|
|
590
|
+
* Both of its stances were wrong for a system of record. `SCOPE_FILTER_PUSHDOWN` sent WILDO's own
|
|
591
|
+
* organization id to the remote as a filter value — an id the remote has never heard of — and
|
|
592
|
+
* `SINGLE_TENANT_BINDING` became the only truth, which makes it a declaration with one legal answer.
|
|
593
|
+
*
|
|
594
|
+
* What replaced it is not a smaller field but a different mechanism: the row projector STAMPS the
|
|
595
|
+
* owner organization's id onto every remote row, so the per-row tenant gate passes with no exemption
|
|
596
|
+
* and a read under another organization's URL is refused by the gate that already existed.
|
|
597
|
+
* Partitioning a system of record BY organization unit returns in #1058, as a property of the
|
|
598
|
+
* INSTANCE and its vendor facet rather than of each binding.
|
|
599
|
+
*/
|
|
600
|
+
|
|
601
|
+
/** Erasure stance (D6) — required; no silent default. */
|
|
602
|
+
erasure: HttpApiErasureDeclarationSchema,
|
|
603
|
+
|
|
604
|
+
/**
|
|
605
|
+
* The processing PURPOSES this data flow serves (#1745) — each a `purposeRef` of
|
|
606
|
+
* `operatorComplianceIdentity.lawfulBases` in `wildo.saas.config.ts`. Absent = none linked.
|
|
607
|
+
*
|
|
608
|
+
* A system of record is where an application OBTAINS personal data it did not collect from the person, and a
|
|
609
|
+
* privacy notice then owes the purpose and the legal basis for it (GDPR Art. 14(1)(c)) beside the source (Art.
|
|
610
|
+
* 14(2)(f)). The source and the categories are derived from this binding; the purpose is the one thing the
|
|
611
|
+
* framework cannot infer from what the data is, so it is LINKED here, per binding, rather than typed into a
|
|
612
|
+
* notice. The same link a provider's compliance choice carries (#1709), for the same reason.
|
|
613
|
+
*
|
|
614
|
+
* Checked where both halves are visible — the document facts and the evidence collector — and a ref naming no
|
|
615
|
+
* declared purpose is REPORTED there as a broken link, never refused: the factory runs in `shared-lib`, where the
|
|
616
|
+
* lawful bases are not in scope, and a compliance link must never stop the application from starting.
|
|
617
|
+
*/
|
|
618
|
+
purposeRefs: z.array(z.string().trim().min(1)).optional(),
|
|
619
|
+
|
|
620
|
+
/**
|
|
621
|
+
* The row-level writes this binding OPENS toward its system of record (#1679). Absent = none: the
|
|
622
|
+
* binding is read-only, which is what every binding authored before #1679 declared implicitly.
|
|
623
|
+
*
|
|
624
|
+
* Opening a verb is not enough to write. The resource must also declare the matching operation
|
|
625
|
+
* (the factory refuses either without the other), the dialect must implement writes (the boot
|
|
626
|
+
* registration refuses a verb its dialect cannot send, naming the dialect), and every write
|
|
627
|
+
* variant carries a REQUIRED `Idempotency-Key`, because a remote write cannot be rolled back and
|
|
628
|
+
* a retried request must replay its first outcome rather than write twice.
|
|
629
|
+
*/
|
|
630
|
+
writableVerbs: z.array(z.enum(HttpApiWriteVerb)).default([]),
|
|
631
|
+
|
|
632
|
+
/**
|
|
633
|
+
* How an opened UPDATE is protected against overwriting a change made since its author read the row (#1724). See
|
|
634
|
+
* {@link HttpApiWriteConcurrencyMode} for the two answers and the limit of the first.
|
|
635
|
+
*
|
|
636
|
+
* REQUIRED when the binding opens UPDATE — on ODOO_JSONRPC (#1724), ODATA (#1726) and REST_JSON (#1728) alike — and
|
|
637
|
+
* refused when the binding opens no UPDATE — a concurrency stance on a door that is shut decides nothing. `versionField` names the LOCAL field that
|
|
638
|
+
* carries the version: it must map onto the vendor facet's `rowVersionField` (checked at boot, where the facet is
|
|
639
|
+
* visible) — Odoo `write_date`, an OData service's `@odata.etag` — and the resource's schema must let an UPDATE carry
|
|
640
|
+
* it and keep a CREATE from sending it (checked by the resource factory).
|
|
641
|
+
*/
|
|
642
|
+
writeConcurrency: z.discriminatedUnion('mode', [
|
|
643
|
+
z.strictObject({
|
|
644
|
+
mode: z.literal(HttpApiWriteConcurrencyMode.VERSION_CHECKED),
|
|
645
|
+
/** The LOCAL field carrying the row version the caller read — never written to the remote. */
|
|
646
|
+
versionField: z.string().min(1),
|
|
647
|
+
}),
|
|
648
|
+
z.strictObject({ mode: z.literal(HttpApiWriteConcurrencyMode.LAST_WRITER_WINS) }),
|
|
649
|
+
]).optional(),
|
|
650
|
+
|
|
651
|
+
/**
|
|
652
|
+
* The vendor ACTIONS this binding declares toward its system of record (#1678) — named operations that are not row
|
|
653
|
+
* writes: posting an invoice, confirming an order, an OData bound or unbound action. Absent = none.
|
|
654
|
+
*
|
|
655
|
+
* Declared here rather than on the instance for the reasons `system-of-record-actions.shared.schemas.ts` records: an
|
|
656
|
+
* action carries a Zod input schema and the roles admitted to it, both of which live in `shared-lib` beside this
|
|
657
|
+
* binding. An action runs only through the system-of-record action executor, under the instance's service identity,
|
|
658
|
+
* confined to the owner organization and to the caller's partition, and audited on every outcome. It is reached over
|
|
659
|
+
* HTTP only through a custom operation of this resource whose implementation calls the executor.
|
|
660
|
+
*/
|
|
661
|
+
actions: SystemOfRecordActionDeclarationsSchema.optional(),
|
|
662
|
+
|
|
663
|
+
/** Remote-call semantics (D10/R15). */
|
|
664
|
+
remoteCallSemantics: HttpApiRemoteCallSemanticsSchema.default({
|
|
665
|
+
timeoutMs: 10_000,
|
|
666
|
+
retry: { maxAttempts: 2, backoffMs: 500 },
|
|
667
|
+
maxIdSetSize: 50,
|
|
668
|
+
maxPartitionSetSize: 200,
|
|
669
|
+
}),
|
|
670
|
+
};
|
|
125
671
|
```
|
|
126
672
|
|
|
127
673
|
### Origin Package: `@wildo-ai/saas-models`
|
|
@@ -144,10 +690,21 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
|
|
|
144
690
|
* something somebody can act on.
|
|
145
691
|
*/
|
|
146
692
|
}),
|
|
693
|
+
z.object({
|
|
694
|
+
/*
|
|
695
|
+
* OData v2 (#1687) — generic like ODATA: the entity set IS `entityRef`, and read/list/count map mechanically. Its
|
|
696
|
+
* own arm rather than a flag on ODATA because the compiler, the envelope and the value encoding all differ.
|
|
697
|
+
*/
|
|
698
|
+
dialect: z.literal(HttpApiTransportDialect.ODATA_V2),
|
|
699
|
+
...httpApiResourceBindingBaseShape,
|
|
700
|
+
}),
|
|
147
701
|
z.object({
|
|
148
702
|
dialect: z.literal(HttpApiTransportDialect.REST_JSON),
|
|
149
703
|
...httpApiResourceBindingBaseShape,
|
|
150
|
-
/**
|
|
704
|
+
/**
|
|
705
|
+
* The declared read surface, and the declared request of each row write the binding opens (#1728) — absent members
|
|
706
|
+
* are refused, never emulated.
|
|
707
|
+
*/
|
|
151
708
|
operations: HttpApiRestOperationsSchema,
|
|
152
709
|
}),
|
|
153
710
|
z.object({
|
|
@@ -161,6 +718,92 @@ export const HttpApiResourceBindingSchema = z.discriminatedUnion('dialect', [
|
|
|
161
718
|
}),
|
|
162
719
|
]);
|
|
163
720
|
|
|
721
|
+
/**
|
|
722
|
+
* A declared statement keyset must be one the engine can walk (#1686). Every refusal names the fix.
|
|
723
|
+
*
|
|
724
|
+
* Checked on the BINDING rather than only on a pipeline, so a keyset declared on a read-through
|
|
725
|
+
* resource is refused the same way: a declaration that says something false is refused wherever it
|
|
726
|
+
* is written, not only where it is used.
|
|
727
|
+
*/
|
|
728
|
+
function assertRestJsonKeysetCoherence(keyFields: readonly HttpApiKeyField[], operations: HttpApiRestOperations): void {
|
|
729
|
+
for (const [member, declaration] of Object.entries(operations) as Array<[string, HttpApiRestOperationSpec | undefined]>) {
|
|
730
|
+
/*
|
|
731
|
+
* A statement on `read` is never sent (#1972 review): a key-addressed read is a path with `{key}` — Salesforce's
|
|
732
|
+
* `/sobjects/Account/{key}` — and `compileRestJsonKeyAddressedRead` reads no statement. Declared there it would
|
|
733
|
+
* look like it shapes the read and shape nothing, and it would admit a `temporalKind` that nothing reads.
|
|
734
|
+
*/
|
|
735
|
+
if (member === 'read' && declaration?.statement !== undefined) {
|
|
736
|
+
throw new Error(
|
|
737
|
+
'operations.read.statement: a key-addressed read is its `pathTemplate` with `{key}`, and sends no statement — declare the '
|
|
738
|
+
+ 'statement on `list` (or `search` / `count`), where collection reads are built.',
|
|
739
|
+
);
|
|
740
|
+
}
|
|
741
|
+
/*
|
|
742
|
+
* SuiteQL is NetSuite's, and NetSuite reads a SuiteQL POST's paging from the URL (#1686). Placed by method, the
|
|
743
|
+
* `limit` lands in the body, the vendor applies its own default, and the page is not bounded — a read-through LIST
|
|
744
|
+
* then serves whole results, and a keyset page is refused at every run. Refused here, where the declaration is.
|
|
745
|
+
* spec-cite: Oracle NetSuite, "Executing SuiteQL Queries Through REST Web Services" (section_157909186990) — the
|
|
746
|
+
* statement is POSTed as `{"q": …}` and paged by `?limit=10&offset=10` on the request URL.
|
|
747
|
+
*/
|
|
748
|
+
if (declaration?.statement?.language === HttpApiQueryStatementLanguage.SUITEQL
|
|
749
|
+
&& declaration.method === HttpApiRestOperationMethod.POST
|
|
750
|
+
&& declaration.pagingParams !== undefined
|
|
751
|
+
&& declaration.pagingParams.placement !== HttpApiRestParameterPlacement.QUERY_STRING) {
|
|
752
|
+
throw new Error(
|
|
753
|
+
`operations.${member}.pagingParams: a SuiteQL read POSTs its statement in the body and is paged in the URL — declare `
|
|
754
|
+
+ `\`placement: '${HttpApiRestParameterPlacement.QUERY_STRING}'\`, or the limit lands in the body and bounds nothing.`,
|
|
755
|
+
);
|
|
756
|
+
}
|
|
757
|
+
const keyset = declaration?.statement?.keyset;
|
|
758
|
+
if (declaration === undefined || keyset === undefined) continue;
|
|
759
|
+
if (member !== 'list') {
|
|
760
|
+
throw new Error(
|
|
761
|
+
`operations.${member}.statement.keyset: a keyset is what a pipeline walks a COLLECTION by, so it is declared on the 'list' member only.`,
|
|
762
|
+
);
|
|
763
|
+
}
|
|
764
|
+
if (keyFields.length !== 1) {
|
|
765
|
+
throw new Error(
|
|
766
|
+
`operations.list.statement.keyset: this binding declares ${keyFields.length} key components, and a keyset needs ONE unique column — `
|
|
767
|
+
+ 'one component of a composite key is not unique, and a walk on it skips the rows that share its boundary value.',
|
|
768
|
+
);
|
|
769
|
+
}
|
|
770
|
+
const keyField = keyFields[0];
|
|
771
|
+
if (keyset.keyRemoteField !== keyField.remoteField) {
|
|
772
|
+
throw new Error(
|
|
773
|
+
`operations.list.statement.keyset.keyRemoteField: '${keyset.keyRemoteField}' is not this binding's key field ('${keyField.remoteField}'). `
|
|
774
|
+
+ 'A keyset walks the row identity, which is the key field: unique and immutable, so no row can move behind the cursor.',
|
|
775
|
+
);
|
|
776
|
+
}
|
|
777
|
+
if (!HTTP_API_KEYSET_ELIGIBLE_CODECS.includes(keyField.codec)) {
|
|
778
|
+
throw new Error(
|
|
779
|
+
`operations.list.statement.keyset: the key field '${keyField.remoteField}' has the ${keyField.codec} codec, and a keyset walks `
|
|
780
|
+
+ `${HTTP_API_KEYSET_ELIGIBLE_CODECS.join(' or ')} keys only — the engine checks each page against the key's order, and that `
|
|
781
|
+
+ 'order must be one it can state.',
|
|
782
|
+
);
|
|
783
|
+
}
|
|
784
|
+
const bound = HTTP_API_KEYSET_PAGE_BOUND[declaration.statement!.language];
|
|
785
|
+
switch (bound) {
|
|
786
|
+
case HttpApiKeysetPageBound.STATEMENT_LIMIT_CLAUSE:
|
|
787
|
+
if (declaration.cursorPath === undefined) {
|
|
788
|
+
throw new Error(
|
|
789
|
+
`operations.list: a ${declaration.statement!.language.toUpperCase()} keyset bounds its page with LIMIT, and the vendor may still `
|
|
790
|
+
+ 'answer the limited result in several batches. Declare the continuation (`cursorPath`, e.g. \'nextRecordsUrl\') so a page is '
|
|
791
|
+
+ 'read to its end — a batch shorter than the limit would otherwise end the pass with rows unread.',
|
|
792
|
+
);
|
|
793
|
+
}
|
|
794
|
+
break;
|
|
795
|
+
case HttpApiKeysetPageBound.LIMIT_PARAMETER:
|
|
796
|
+
if (declaration.pagingParams === undefined) {
|
|
797
|
+
throw new Error(
|
|
798
|
+
`operations.list: a ${declaration.statement!.language.toUpperCase()} keyset bounds its page with the operation's limit parameter — `
|
|
799
|
+
+ 'declare `pagingParams` (limitParam / offsetParam; the offset is always sent as 0).',
|
|
800
|
+
);
|
|
801
|
+
}
|
|
802
|
+
break;
|
|
803
|
+
}
|
|
804
|
+
}
|
|
805
|
+
}
|
|
806
|
+
|
|
164
807
|
/**
|
|
165
808
|
* Dialect-specific structural constraints that a discriminated union cannot express member-side.
|
|
166
809
|
* Called by the resource-configuration factory AFTER the schema parse; throws with the offending
|
|
@@ -202,7 +845,100 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
|
|
|
202
845
|
);
|
|
203
846
|
}
|
|
204
847
|
}
|
|
848
|
+
assertRestJsonKeysetCoherence(binding.keyFields, binding.operations);
|
|
849
|
+
}
|
|
850
|
+
|
|
851
|
+
// #1972 — a temporal kind is read by the REST_JSON statement compilers only; anywhere no statement is built it would
|
|
852
|
+
// decide nothing — a setting that looks like it controls date spelling and controls nothing.
|
|
853
|
+
const declaredTemporal = binding.fieldMappings.find((mapping) => mapping.temporalKind !== undefined);
|
|
854
|
+
if (declaredTemporal !== undefined) {
|
|
855
|
+
const readsThroughStatement = binding.dialect === HttpApiTransportDialect.REST_JSON
|
|
856
|
+
&& Object.values(binding.operations).some((member) => (member as HttpApiRestOperationSpec | undefined)?.statement !== undefined);
|
|
857
|
+
if (!readsThroughStatement) {
|
|
858
|
+
throw new Error(
|
|
859
|
+
`fieldMappings('${declaredTemporal.localField}').temporalKind: declared on a ${binding.dialect} binding that reads through no query `
|
|
860
|
+
+ 'statement — it tells a SOQL or SuiteQL statement how to spell a date, and nothing here builds one, so it would change nothing. Remove it.',
|
|
861
|
+
);
|
|
862
|
+
}
|
|
863
|
+
}
|
|
864
|
+
|
|
865
|
+
// #1679 — each opened verb once. A duplicate is not harmful by itself, but it is a declaration that
|
|
866
|
+
// says the same thing twice, which is the shape that drifts when one copy is edited.
|
|
867
|
+
if (new Set(binding.writableVerbs).size !== binding.writableVerbs.length) {
|
|
868
|
+
throw new Error(`writableVerbs: each verb may be opened once — got [${binding.writableVerbs.join(', ')}].`);
|
|
869
|
+
}
|
|
870
|
+
|
|
871
|
+
// #1724 — the concurrency stance of an opened UPDATE. A stance with no UPDATE decides nothing; an Odoo UPDATE with no
|
|
872
|
+
// stance would be last-writer-wins by an omission nobody reviewed, because Odoo's `write` takes no precondition.
|
|
873
|
+
const opensUpdate = binding.writableVerbs.includes(HttpApiWriteVerb.UPDATE);
|
|
874
|
+
if (binding.writeConcurrency !== undefined && !opensUpdate) {
|
|
875
|
+
throw new Error(
|
|
876
|
+
'writeConcurrency: declared on a binding that opens no UPDATE — it governs updates only. Remove it, or open the update.',
|
|
877
|
+
);
|
|
878
|
+
}
|
|
879
|
+
if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect === HttpApiTransportDialect.ODOO_JSONRPC) {
|
|
880
|
+
throw new Error(
|
|
881
|
+
`writeConcurrency: this binding opens UPDATE toward '${binding.system}', and Odoo's external API has no conditional write — `
|
|
882
|
+
+ '`write(ids, vals)` applies the values whatever changed since they were read. State the stance: '
|
|
883
|
+
+ `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to write_date>' } to refuse `
|
|
884
|
+
+ `a stale version before sending (best-effort: it narrows the race, it does not close it), or { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }.`,
|
|
885
|
+
);
|
|
886
|
+
}
|
|
887
|
+
// #1728 — a REST_JSON write is sent exactly as the binding declares it, so each opened verb needs its member and a
|
|
888
|
+
// member of a verb that is not opened is a declaration nothing sends. Both are refused, naming the member.
|
|
889
|
+
if (binding.dialect === HttpApiTransportDialect.REST_JSON) {
|
|
890
|
+
for (const verb of Object.values(HttpApiWriteVerb)) {
|
|
891
|
+
const member = binding.operations[verb];
|
|
892
|
+
const opened = binding.writableVerbs.includes(verb);
|
|
893
|
+
if (opened && member === undefined) {
|
|
894
|
+
throw new Error(
|
|
895
|
+
`operations.${verb}: this binding opens ${verb.toUpperCase()} toward '${binding.system}', and a REST_JSON write is sent `
|
|
896
|
+
+ `exactly as declared — declare operations.${verb} (method + pathTemplate${verb === HttpApiWriteVerb.CREATE ? ' + createdKey' : ''}).`,
|
|
897
|
+
);
|
|
898
|
+
}
|
|
899
|
+
if (!opened && member !== undefined) {
|
|
900
|
+
throw new Error(
|
|
901
|
+
`operations.${verb}: declared on a binding that does not open ${verb.toUpperCase()} — nothing would ever send it. `
|
|
902
|
+
+ `Open it in writableVerbs, or remove the member.`,
|
|
903
|
+
);
|
|
904
|
+
}
|
|
905
|
+
if (member !== undefined) {
|
|
906
|
+
assertHttpApiRestWriteOperationShape(member, {
|
|
907
|
+
member: verb,
|
|
908
|
+
...HTTP_API_REST_WRITE_MEMBER_RULES[verb],
|
|
909
|
+
keyRemoteFields: binding.keyFields.map((keyField) => keyField.remoteField),
|
|
910
|
+
});
|
|
911
|
+
}
|
|
912
|
+
}
|
|
913
|
+
// Neither REST_JSON vendor's record API is written with a precondition, so an update's stance must be stated, as on Odoo.
|
|
914
|
+
if (opensUpdate && binding.writeConcurrency === undefined) {
|
|
915
|
+
throw new Error(
|
|
916
|
+
`writeConcurrency: this binding opens UPDATE toward '${binding.system}' over REST_JSON, which the engine writes with no `
|
|
917
|
+
+ `precondition. State the stance: { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }, or `
|
|
918
|
+
+ `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to the row version>' } — `
|
|
919
|
+
+ 'best-effort, and available only when the vendor facet declares its row version field.',
|
|
920
|
+
);
|
|
921
|
+
}
|
|
922
|
+
}
|
|
923
|
+
// #1726 — an OData UPDATE is conditional only on a version the caller supplies; without a stance it would be
|
|
924
|
+
// last-writer-wins by an omission nobody reviewed, exactly as for Odoo.
|
|
925
|
+
if (opensUpdate && binding.writeConcurrency === undefined && binding.dialect === HttpApiTransportDialect.ODATA) {
|
|
926
|
+
throw new Error(
|
|
927
|
+
`writeConcurrency: this binding opens UPDATE toward '${binding.system}' over OData. State the stance: `
|
|
928
|
+
+ `{ mode: '${HttpApiWriteConcurrencyMode.VERSION_CHECKED}', versionField: '<local field mapped to @odata.etag>' } to send the `
|
|
929
|
+
+ 'entity tag the caller read as If-Match, so the service itself refuses a stale update (412) — available only when the '
|
|
930
|
+
+ `vendor facet declares its entity tag as rowVersionField — or { mode: '${HttpApiWriteConcurrencyMode.LAST_WRITER_WINS}' }.`,
|
|
931
|
+
);
|
|
205
932
|
}
|
|
933
|
+
if (binding.writeConcurrency?.mode === HttpApiWriteConcurrencyMode.VERSION_CHECKED) {
|
|
934
|
+
const versionField = binding.writeConcurrency.versionField;
|
|
935
|
+
if (binding.keyFields.some((keyField) => keyField.localField === versionField)) {
|
|
936
|
+
throw new Error(`writeConcurrency.versionField: '${versionField}' is a key field — a row's version is not its address.`);
|
|
937
|
+
}
|
|
938
|
+
}
|
|
939
|
+
|
|
940
|
+
// #1678 — every declared action must be one this binding's dialect can call, on the target it names.
|
|
941
|
+
assertSystemOfRecordActionDeclarationsCoherence({ dialect: binding.dialect, actions: binding.actions });
|
|
206
942
|
|
|
207
943
|
// D6 stance 6b — the declared erasure operation's FORM is dialect-specific. The union schema
|
|
208
944
|
// admits both forms; only the pairing below is executable, so an incoherent pairing must refuse
|
|
@@ -213,6 +949,17 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
|
|
|
213
949
|
// - REST_JSON → an explicit operation spec only (there IS no canonical delete to rely on —
|
|
214
950
|
// the binding declares the exact call, like every other REST_JSON operation).
|
|
215
951
|
if (binding.erasure.stance === HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION) {
|
|
952
|
+
/*
|
|
953
|
+
* #1687 — an OData v2 binding reads only. The explicit-erasure stance is a remote DELETE, which on SAP Gateway needs
|
|
954
|
+
* the CSRF-token handshake the engine does not perform, and v2's write shapes are the write path's (#1679). Refused
|
|
955
|
+
* here rather than at the first erasure request, where a subject's Art. 17 answer would be the one to fail.
|
|
956
|
+
*/
|
|
957
|
+
if (binding.dialect === HttpApiTransportDialect.ODATA_V2) {
|
|
958
|
+
throw new Error(
|
|
959
|
+
'erasure: an ODATA_V2 binding reads only, and the explicit-erasure stance is a remote DELETE the engine does not send on v2 '
|
|
960
|
+
+ '(SAP Gateway requires a CSRF-token handshake). Declare NO_SUBJECT_DATA or CONTROLLER_ACKNOWLEDGED_NON_ERASURE, or bind a v4 service.',
|
|
961
|
+
);
|
|
962
|
+
}
|
|
216
963
|
const usesCanonicalDelete = 'useCanonicalDelete' in binding.erasure.operation;
|
|
217
964
|
if (binding.dialect === HttpApiTransportDialect.REST_JSON && usesCanonicalDelete) {
|
|
218
965
|
throw new Error(
|
|
@@ -227,3 +974,39 @@ export function assertHttpApiBindingDialectCoherence(binding: HttpApiResourceBin
|
|
|
227
974
|
}
|
|
228
975
|
}
|
|
229
976
|
```
|
|
977
|
+
|
|
978
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
979
|
+
|
|
980
|
+
```typescript
|
|
981
|
+
/**
|
|
982
|
+
* The declared erasure stance of an HTTP_API-backed resource. All three stances are first-class
|
|
983
|
+
* from slice 1 (decision D6, 2026-08-26); a binding MUST declare one — an undeclared stance is a
|
|
984
|
+
* registration refusal, because `exportSubject` is a fail-closed obligation on every resource and
|
|
985
|
+
* "we cannot delete rows we do not own" is not an answer the framework may imply silently.
|
|
986
|
+
*
|
|
987
|
+
* Import it from `@wildo-ai/saas-models` (the package root), not from the `external-data` subpath.
|
|
988
|
+
*/
|
|
989
|
+
export enum HttpApiErasureStance {
|
|
990
|
+
/**
|
|
991
|
+
* (6a) The resource declares it holds NO personal/subject data. Registration verifies the
|
|
992
|
+
* declaration is coherent (e.g. `exportSubject` posture) and erasure is structurally N/A for
|
|
993
|
+
* the remote rows.
|
|
994
|
+
*/
|
|
995
|
+
NO_SUBJECT_DATA = 'no-subject-data',
|
|
996
|
+
|
|
997
|
+
/**
|
|
998
|
+
* (6b) The binding declares HOW erasure reaches the foreign system: one named API operation the
|
|
999
|
+
* engine invokes on a subject-erasure request. This is a single declared write and does NOT
|
|
1000
|
+
* require general write support (slice 1 stays read-only otherwise).
|
|
1001
|
+
*/
|
|
1002
|
+
EXTERNAL_ERASURE_OPERATION = 'external-erasure-operation',
|
|
1003
|
+
|
|
1004
|
+
/**
|
|
1005
|
+
* (6c) Erasure REFUSES by default; an explicit, per-request, audited controller acknowledgement
|
|
1006
|
+
* lets it proceed and records the un-erased remote rows at high severity. Mirrors the existing
|
|
1007
|
+
* administrative-floor acknowledgement shape (`administrative-continuity-floors.md`): the record
|
|
1008
|
+
* is the control. NEVER a standing default — the acknowledgement is per erasure request.
|
|
1009
|
+
*/
|
|
1010
|
+
CONTROLLER_ACKNOWLEDGED_NON_ERASURE = 'controller-acknowledged-non-erasure',
|
|
1011
|
+
}
|
|
1012
|
+
```
|