@wildo-ai/framework-knowledge 1.1.4 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
- 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/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -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 +547 -17
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- 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 +1 -4
- 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 +135 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
- 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 +374 -11
- 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 +6 -4
- 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 +22 -20
- 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 +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- 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 +18 -8
- 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 +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
- 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 +68 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
- 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 +1 -2
- 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 +78 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- 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.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +172 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
- 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/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +173 -5
- 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 +6 -5
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +9 -8
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +23 -4
- 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 +6 -4
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +22 -13
- 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 +193 -28
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +173 -34
- 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 +3 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +7 -3
- 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 +183 -6
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +192 -6
- 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 +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +4 -3
- 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 +173 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- 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.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +3 -2
- 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.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +7 -3
- 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.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +3 -2
- 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 +2 -2
- 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 +7 -4
- 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 +33 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +28 -4
- 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 +3 -3
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +5 -3
- 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 +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +19 -5
- 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 +156 -5
- 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 +187 -5
- 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 +7 -6
- 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 +28 -19
- 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 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
- 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/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
- 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/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
- 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/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- 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/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +174 -0
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
- 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 +53 -7
- 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 +11 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -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.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -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 +30 -6
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- 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 +104 -43
- 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.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
- 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 +34 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -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 +34 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -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 +112 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
- 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.spec.frontend-component.prop-vocabulary.md +18 -0
- 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/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +318 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -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 +290 -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 +217 -0
- package/dist/knowledge/references/market.alternative.config.md +2 -2
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- 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 +4 -4
- package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
- package/dist/knowledge/references/market.gain.config.md +2 -2
- package/dist/knowledge/references/market.icp.config.md +3 -3
- package/dist/knowledge/references/market.job.config.md +2 -2
- package/dist/knowledge/references/market.message-template.config.md +3 -3
- package/dist/knowledge/references/market.objection.config.md +2 -2
- package/dist/knowledge/references/market.pain.config.md +2 -2
- package/dist/knowledge/references/market.persona.config.md +3 -3
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +2 -2
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
- package/dist/knowledge/references/market.trigger.config.md +2 -2
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +375 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +15 -36
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- 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 +194 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- 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 +206 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -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 +224 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -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.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- 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-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
- 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.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- 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 +90 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
- 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 +710 -10
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- 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.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
- 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.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -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 +13 -9
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -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.client-instance-id-scope.md +49 -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.redaction-treatments.md +106 -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.progression-tracker-variant.md +76 -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 +42 -5
- 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 +133 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -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 +870 -0
- 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 +268 -3
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
- 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 +217 -18
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +410 -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 +120 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -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 +92 -7
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
- package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
- 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 +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- 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 +70 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- 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 +66 -11
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- 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/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +238 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +4 -2
- package/dist/knowledge/references/zod.factories.duration.md +6 -4
- package/dist/knowledge/references/zod.factories.money.md +5 -3
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +2602 -214
- package/dist/knowledge/registries/playbooks.json +468 -92
- package/dist/knowledge/registries/source-tags.json +6171 -1996
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +137 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +67 -29
- 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 +111 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
- 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 +95 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -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 +44 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
- 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 +91 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
- 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 +20 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -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 +41 -12
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
- 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 +248 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -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 +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -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 +387 -81
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- 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 +289 -37
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
- 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-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
- package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
- package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
- 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 +5 -4
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- 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 +55 -19
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- 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 +518 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- 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-loader-api.md +55 -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-package-convention-api.md +48 -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 +165 -29
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- 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 +270 -9
- 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 +247 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -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 +86 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -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 +300 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
- 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 +472 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
- 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 +739 -17
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
- 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 +70 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- 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 +34 -4
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- 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 +77 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- 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 +216 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- 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 +206 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -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 +52 -19
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
- package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -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 +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -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 +6 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
- 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 +71 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -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 +159 -180
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
- 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 +64 -54
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
- 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 +44 -26
- package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +12659 -4142
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -0,0 +1,745 @@
|
|
|
1
|
+
# Writing through a read-through resource
|
|
2
|
+
|
|
3
|
+
Read this when a virtual (`HTTP_API`) resource must CREATE, UPDATE or DELETE rows in its system of
|
|
4
|
+
record — an Odoo partner created from the application, an invoice line corrected, a record removed.
|
|
5
|
+
|
|
6
|
+
The data still lives only in the remote system. A write is sent there, once, and the answer is read
|
|
7
|
+
back from there. Nothing is stored locally except a short-lived record that the request's
|
|
8
|
+
`Idempotency-Key` was spent.
|
|
9
|
+
|
|
10
|
+
## What you declare
|
|
11
|
+
|
|
12
|
+
Three things, and the framework refuses the resource at startup until all three agree:
|
|
13
|
+
|
|
14
|
+
1. **The verbs the binding OPENS** — `httpApiBinding.writableVerbs`, a list of `HttpApiWriteVerb`
|
|
15
|
+
(`create`, `update`, `delete`). Absent means none: the binding stays read-only.
|
|
16
|
+
2. **The operations that perform them** — the ordinary `CREATE`, `UPDATE` and `DELETE` core
|
|
17
|
+
operations, or a custom operation that borrows one through `resourceOperationLike`. An operation
|
|
18
|
+
that writes a verb the binding does not open is refused, and so is an opened verb no operation
|
|
19
|
+
uses.
|
|
20
|
+
3. **Nothing else.** You do not declare an `Idempotency-Key` requirement on the write variants: the
|
|
21
|
+
framework sets it to REQUIRED, because a remote write cannot be rolled back and every retry must
|
|
22
|
+
replay the first outcome. Declaring `accepted` is refused.
|
|
23
|
+
|
|
24
|
+
Also refused, whatever you open:
|
|
25
|
+
|
|
26
|
+
- **bulk writes** — `CREATE_MANY`, `UPDATE_MANY`, `DELETE_MANY`, and a `haveBulkOperation` twin of a
|
|
27
|
+
write. Ten remote writes are ten calls with no transaction to roll back into when the sixth fails;
|
|
28
|
+
- **a queued or background write** — it could not carry the Idempotency-Key;
|
|
29
|
+
- **personal data under `erasure: NO_SUBJECT_DATA`** — refused whether or not you write: a
|
|
30
|
+
read-through resource whose fields declare `.dataCategories(...)` holds personal data in the
|
|
31
|
+
system, so declare `EXTERNAL_ERASURE_OPERATION` or `CONTROLLER_ACKNOWLEDGED_NON_ERASURE` (or, if
|
|
32
|
+
the fields are not about a person, remove the categories);
|
|
33
|
+
- **a dialect that cannot write** — the application refuses to start and names the dialect.
|
|
34
|
+
Which dialects write is a property of your engine version, not of your binding. `ODOO_JSONRPC`
|
|
35
|
+
(see "Writing to Odoo"), `ODATA` v4 (see "Writing to an OData v4 service") and `REST_JSON` (see
|
|
36
|
+
"Writing to a REST_JSON API") write. An OData **v2** service (SAP `/sap/opu/odata/…`) is the
|
|
37
|
+
`ODATA_V2` dialect, which reads only: a binding opening a verb on it is refused at startup.
|
|
38
|
+
- **an UPDATE with no concurrency stance** — a binding that opens `update` must state
|
|
39
|
+
`writeConcurrency` (see each dialect's section below).
|
|
40
|
+
- **on `REST_JSON`, an opened verb with no declared request** — each opened verb needs its
|
|
41
|
+
`operations.<verb>` member, and a member of a verb that is not opened is refused too.
|
|
42
|
+
|
|
43
|
+
## Who may write what
|
|
44
|
+
|
|
45
|
+
- **Only the organization that owns the application.** A write scoped to any other organization is
|
|
46
|
+
refused before anything is sent (`SYSTEM_OF_RECORD_WRITE_ORGANIZATION_NOT_OWNER`). A read under
|
|
47
|
+
another organization answers an empty page; a write has no honest empty answer.
|
|
48
|
+
- **A CREATE lands in the caller's unit's partition** when the instance is partitioned. A member of
|
|
49
|
+
exactly one assigned unit need send nothing — the engine writes that unit's partition key onto the
|
|
50
|
+
remote row. A member of several units, or an organization-wide caller, must name the unit in
|
|
51
|
+
`organizationUnitId`; otherwise the answer is `SYSTEM_OF_RECORD_WRITE_PARTITION_UNIT_REQUIRED`,
|
|
52
|
+
listing the candidates. `organizationUnitId` is a SELECTION and is never sent to the remote.
|
|
53
|
+
- **An UPDATE or DELETE reads the row first**, through the same gates a read passes. A row the caller
|
|
54
|
+
cannot see answers as if it did not exist — it never tells a caller that a row exists elsewhere.
|
|
55
|
+
A SHARED row (partition unset) is readable by everyone and writable only by an organization-wide
|
|
56
|
+
caller.
|
|
57
|
+
- **The partition field, the owner stamp, a row's unit after creation and its key are never
|
|
58
|
+
writable.** Sending one is refused, not stripped (`SYSTEM_OF_RECORD_WRITE_FIELD_NOT_WRITABLE`), and
|
|
59
|
+
a schema field that lands on the partition field must be `.excludeFromCreate().excludeFromUpdate()`
|
|
60
|
+
or the application refuses to start.
|
|
61
|
+
|
|
62
|
+
## Writing to Odoo
|
|
63
|
+
|
|
64
|
+
Each write is ONE `execute_kw` on the binding's model (`entityRef`), under the instance's own service
|
|
65
|
+
identity and in-args credential:
|
|
66
|
+
|
|
67
|
+
| verb | Odoo call | answer |
|
|
68
|
+
|---|---|---|
|
|
69
|
+
| create | `create(vals)` | the new record's id, from which the row's `_id` is built; the row is then read back |
|
|
70
|
+
| update | `write([id], vals)` | `true`; the row is read back |
|
|
71
|
+
| delete | `unlink([id])` | `true`. If someone else deleted the record a moment earlier, Odoo is expected to answer `true` as well (its access check does not complain about deleting a deleted record); should it refuse instead, the answer is a remote refusal while the row is in fact gone |
|
|
72
|
+
|
|
73
|
+
- **Values are sent under their Odoo names** (`fieldMappings`). A many2one is WRITTEN as the bare id
|
|
74
|
+
(`company_id: 10`) although Odoo READS it back as `[10, "Acme"]`; the partition field on a create is
|
|
75
|
+
written that way by the engine.
|
|
76
|
+
- **A `Date` is sent as `YYYY-MM-DD HH:MM:SS`, UTC** — the only datetime form Odoo parses.
|
|
77
|
+
- **An update that changes no field is refused** rather than sent: Odoo would still stamp a new
|
|
78
|
+
`write_date` and answer `true`.
|
|
79
|
+
- **Odoo has no idempotency mechanism.** A write is sent exactly once, whatever
|
|
80
|
+
`remoteCallSemantics.retry` allows for reads. A timeout or a gateway error after the request left is
|
|
81
|
+
`SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`, and a retry under the same key answers it again instead of
|
|
82
|
+
creating a second record.
|
|
83
|
+
- **An Odoo refusal** (a validation error, a record another one still references, a record gone
|
|
84
|
+
before an update) comes back as a JSON-RPC error. Odoo ran the call in a transaction and rolled it
|
|
85
|
+
back, so nothing was applied: it is a refusal, never an unknown outcome.
|
|
86
|
+
|
|
87
|
+
### Concurrency: Odoo has no conditional write, so the check is BEST-EFFORT
|
|
88
|
+
|
|
89
|
+
`write(ids, vals)` applies the values to whatever the record holds now; there is no `If-Match`, no
|
|
90
|
+
expected version. A binding that opens `update` on Odoo therefore states one of two stances:
|
|
91
|
+
|
|
92
|
+
```ts
|
|
93
|
+
writeConcurrency: { mode: HttpApiWriteConcurrencyMode.VERSION_CHECKED, versionField: 'lastUpdatedAt' }
|
|
94
|
+
// or
|
|
95
|
+
writeConcurrency: { mode: HttpApiWriteConcurrencyMode.LAST_WRITER_WINS }
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
`VERSION_CHECKED` names a LOCAL field mapped onto Odoo's `write_date` (the vendor's row version; the
|
|
99
|
+
application refuses to start if the mapping names another field). Declare it
|
|
100
|
+
`.optional().excludeFromCreate()` and NOT `.excludeFromUpdate()` — the factory refuses both mistakes —
|
|
101
|
+
and make it a `string` (the factory refuses any other type), so it is compared byte for byte with
|
|
102
|
+
what Odoo served. Then:
|
|
103
|
+
|
|
104
|
+
- every UPDATE must send the version it READ, unchanged — one without it is refused
|
|
105
|
+
(`SYSTEM_OF_RECORD_WRITE_VERSION_REQUIRED`);
|
|
106
|
+
- the engine compares it with the `write_date` Odoo answers to the read it makes just before writing,
|
|
107
|
+
and refuses a mismatch before anything is sent (`SYSTEM_OF_RECORD_WRITE_VERSION_STALE`, 409);
|
|
108
|
+
- the version is compared, never written, and a CREATE may not send it — nor may any other field
|
|
109
|
+
mapped onto `write_date`: Odoo discards a sent `write_date`, so the application refuses to start
|
|
110
|
+
while such a field is writable, and a request carrying one is refused;
|
|
111
|
+
- a DELETE is NOT version-checked: it is read first for the partition, then unlinked.
|
|
112
|
+
|
|
113
|
+
**What it does NOT guarantee — say this to whoever relies on it.** The comparison and the write are
|
|
114
|
+
two calls, so a change that lands between them is overwritten. And Odoo serves `write_date` to the
|
|
115
|
+
SECOND, so two changes inside one second read as the same version. The check turns most lost updates
|
|
116
|
+
into a refusal; it cannot make them impossible. If an update must never overwrite a concurrent change,
|
|
117
|
+
the system of record has to offer a conditional write, and Odoo's external API does not.
|
|
118
|
+
|
|
119
|
+
`LAST_WRITER_WINS` makes no check at all. It is legitimate for data nobody edits concurrently; it is
|
|
120
|
+
declared so that the choice is visible rather than an accident.
|
|
121
|
+
|
|
122
|
+
## Writing to an OData v4 service
|
|
123
|
+
|
|
124
|
+
Each write is ONE request on the binding's entity set (`entityRef`), under the instance's own
|
|
125
|
+
credential, with `OData-Version: 4.0` and `OData-MaxVersion: 4.0`:
|
|
126
|
+
|
|
127
|
+
| verb | request | answer |
|
|
128
|
+
|---|---|---|
|
|
129
|
+
| create | `POST /<EntitySet>` with the fields, `Prefer: return=representation` | `201` with the created entity, whose key becomes the row's `_id`; no second read |
|
|
130
|
+
| update | `PATCH /<EntitySet>(<key>)` with ONLY the changed fields, `Prefer: return=representation`, `If-Match` | `200` with the entity, or `204` and the row is read back |
|
|
131
|
+
| delete | `DELETE /<EntitySet>(<key>)`, `If-Match` | `204` |
|
|
132
|
+
|
|
133
|
+
- **Never `PUT`.** `PUT` replaces the whole entity, so a partial update would reset every field it
|
|
134
|
+
did not send. `PATCH` leaves them alone.
|
|
135
|
+
- **Values are sent under their OData names** (`fieldMappings`); a `Date` is sent as ISO 8601 UTC,
|
|
136
|
+
the form an `Edm.DateTimeOffset` takes. A property typed `Edm.Date` wants `YYYY-MM-DD`: declare such
|
|
137
|
+
a field as a string. A lookup written as `field@odata.bind` (Dataverse navigation properties) is not
|
|
138
|
+
expressible — map only plain properties.
|
|
139
|
+
- **Every update and delete carries `If-Match`**: the entity tag (`@odata.etag`) of the row the
|
|
140
|
+
engine reads just before writing (for the partition check), or `*` when the service serves no tag
|
|
141
|
+
for this entity set. The service refuses a mismatch with `412 Precondition Failed` and applies
|
|
142
|
+
nothing, so a row that moved — edited, or moved into another partition — between that read and the
|
|
143
|
+
write is never written. `*` still matters: some services (Dataverse) turn a `PATCH` to a key that
|
|
144
|
+
no longer exists into a CREATE, and `If-Match` forbids that.
|
|
145
|
+
- **A `412` is a refusal**, `SYSTEM_OF_RECORD_WRITE_PRECONDITION_FAILED`: nothing was applied, it is
|
|
146
|
+
not retried. Read the row again, re-apply the change and send it under a NEW key.
|
|
147
|
+
- **No idempotency.** OData offers nothing a service deduplicates a write by, so a write is sent
|
|
148
|
+
exactly once; an interrupted one is `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`, as for Odoo. So is a
|
|
149
|
+
create answered `204` with no entity: the entity exists and the answer does not say which one.
|
|
150
|
+
- **An update that changes no field is refused** rather than sent: it would move the entity tag and
|
|
151
|
+
make every other holder of it stale.
|
|
152
|
+
- **SAP S/4HANA cannot be written.** SAP Gateway requires an `X-CSRF-Token` fetched by a prior request
|
|
153
|
+
(with its session cookie) on every modifying request, and the engine does not perform that
|
|
154
|
+
handshake — so a binding opening writes against `sap-s4hana` is refused at startup
|
|
155
|
+
(`SYSTEM_OF_RECORD_WRITE_PREREQUISITE_NOT_SUPPORTED`) rather than answered `403` at its first write.
|
|
156
|
+
- **Partitions.** A FIELD partition (a company column) works as for Odoo: a create carries the
|
|
157
|
+
caller's unit's value, and an update or delete of another partition's row sends only its read.
|
|
158
|
+
Business Central's company is a PATH segment, which startup refuses to confine on: a Business
|
|
159
|
+
Central write lands in whatever company its `baseUrl` or `entityRef` path names, exactly as its
|
|
160
|
+
reads do.
|
|
161
|
+
|
|
162
|
+
### Concurrency on OData: a REAL conditional write
|
|
163
|
+
|
|
164
|
+
State the stance as for Odoo — `VERSION_CHECKED` or `LAST_WRITER_WINS` — with one difference in
|
|
165
|
+
what `VERSION_CHECKED` is worth:
|
|
166
|
+
|
|
167
|
+
```ts
|
|
168
|
+
fieldMappings: [{ localField: 'rowVersion', remoteField: '@odata.etag' }],
|
|
169
|
+
writeConcurrency: { mode: HttpApiWriteConcurrencyMode.VERSION_CHECKED, versionField: 'rowVersion' },
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
The caller reads `rowVersion` (the entity tag) and sends it back with the update. The engine refuses
|
|
173
|
+
a mismatch with the row it reads first (`…_WRITE_VERSION_STALE`, nothing sent), then sends the same
|
|
174
|
+
tag as `If-Match` — so a change landing after that comparison is refused BY THE SERVICE
|
|
175
|
+
(`…_WRITE_PRECONDITION_FAILED`). Unlike Odoo, no concurrent change can be overwritten.
|
|
176
|
+
|
|
177
|
+
It is available only against a vendor whose facet declares the entity tag as its row version (the
|
|
178
|
+
generic `odata` facet, `microsoft-dataverse`, `microsoft-dynamics-365-business-central`). A row the service serves without
|
|
179
|
+
a tag is refused by name (`…_WRITE_ROW_VERSION_NOT_SERVED`): the entity set has no versions, and
|
|
180
|
+
`LAST_WRITER_WINS` is the honest stance for it. Declare the field `.optional().excludeFromCreate()`,
|
|
181
|
+
a `string`, and never `.excludeFromUpdate()`, as for Odoo.
|
|
182
|
+
|
|
183
|
+
`LAST_WRITER_WINS` on OData still sends the tag of the row read first, so the service refuses a write
|
|
184
|
+
racing a change by microseconds; what it does not check is the version the CALLER read.
|
|
185
|
+
|
|
186
|
+
## Writing to a REST_JSON API
|
|
187
|
+
|
|
188
|
+
`REST_JSON` names no protocol, so nothing about a write is inferred: each verb the binding opens is
|
|
189
|
+
declared as the ONE request it sends, beside the read members, and the application refuses to start
|
|
190
|
+
until every opened verb has its member (and every member its opened verb).
|
|
191
|
+
|
|
192
|
+
```ts
|
|
193
|
+
operations: {
|
|
194
|
+
read: { method: 'GET', pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
|
|
195
|
+
list: { method: 'GET', pathTemplate: '/services/data/v62.0/query', statement: { /* SOQL */ } },
|
|
196
|
+
create: { method: HttpApiRestWriteMethod.POST, pathTemplate: '/services/data/v62.0/sobjects/Account',
|
|
197
|
+
createdKey: { source: HttpApiRestCreatedKeySource.RESPONSE_BODY, path: 'id' } },
|
|
198
|
+
update: { method: HttpApiRestWriteMethod.PATCH, pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
|
|
199
|
+
delete: { method: HttpApiRestWriteMethod.DELETE, pathTemplate: '/services/data/v62.0/sobjects/Account/{key}' },
|
|
200
|
+
},
|
|
201
|
+
writableVerbs: [HttpApiWriteVerb.CREATE, HttpApiWriteVerb.UPDATE, HttpApiWriteVerb.DELETE],
|
|
202
|
+
writeConcurrency: { mode: HttpApiWriteConcurrencyMode.LAST_WRITER_WINS },
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
The two vendors this was built against, and the one thing they differ in:
|
|
206
|
+
|
|
207
|
+
| | create | update | delete | where the new key is |
|
|
208
|
+
|---|---|---|---|---|
|
|
209
|
+
| Salesforce sObject rows | `POST …/sobjects/<Object>` → `201` | `PATCH …/sobjects/<Object>/{key}` → `204` | `DELETE …/sobjects/<Object>/{key}` → `204` | the body: `createdKey: { source: RESPONSE_BODY, path: 'id' }` |
|
|
210
|
+
| NetSuite record service | `POST …/record/v1/<type>` → `204`, no body | `PATCH …/record/v1/<type>/{key}` → `204` | `DELETE …/record/v1/<type>/{key}` → `204` | the `Location` header: `createdKey: { source: LOCATION_HEADER }` |
|
|
211
|
+
|
|
212
|
+
- **A create must say where its key is answered** (`createdKey`). The engine names the new row by
|
|
213
|
+
that key and reads the row back through your `read` member, so what a create answers is what a read
|
|
214
|
+
would. A `Location` is read only when it names a record of the path the create was sent to; an
|
|
215
|
+
answer that does not name the key is `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` — the record was made
|
|
216
|
+
and the engine cannot say which one. A created key needs a single key field.
|
|
217
|
+
- **An update or a delete addresses one record** with `{key}` (or `{key.<RemoteField>}` tokens), the
|
|
218
|
+
`read` member's grammar; a create carries no key token and names its collection. Every path starts
|
|
219
|
+
with `/`. No other `{…}` token is allowed, `{key}` needs a single key field, and a
|
|
220
|
+
`{key.<RemoteField>}` must name one of yours — all checked at startup, not at the first write.
|
|
221
|
+
- **Methods:** a create is a `POST`; an update a `PATCH` (or an RPC-style `POST`); a delete a `DELETE`
|
|
222
|
+
(or an RPC-style `POST`). **Never `PUT`** — it replaces the record, so a partial update would reset
|
|
223
|
+
every field it did not send. A vendor whose only update is a full replacement stays read-only.
|
|
224
|
+
- **Values are sent under their remote names** (`fieldMappings`); a `Date` as ISO 8601 UTC. The
|
|
225
|
+
partition field on a create is written by the engine, as for the other dialects. An update that
|
|
226
|
+
changes no field is refused rather than sent.
|
|
227
|
+
- **Vendor headers** go in the member's `staticHeaders`. A credential never does: `Authorization` is
|
|
228
|
+
refused by name, since the binding is committed and the credential comes from the instance.
|
|
229
|
+
- **No idempotency, no precondition.** Neither vendor deduplicates a synchronous write by a request id
|
|
230
|
+
(NetSuite's idempotency header is documented for asynchronous requests), so every write is sent
|
|
231
|
+
exactly once and an interrupted one is `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN`. Nothing is sent
|
|
232
|
+
conditionally, so `writeConcurrency` is required on an opened update and `VERSION_CHECKED` is
|
|
233
|
+
best-effort, as on Odoo — and available only where the vendor facet declares a row version field,
|
|
234
|
+
which neither the Salesforce nor the NetSuite facet does today: state `LAST_WRITER_WINS` there.
|
|
235
|
+
- **Declared ERP actions are not available on REST_JSON** (see `system-of-record-actions.md`); only
|
|
236
|
+
row writes are.
|
|
237
|
+
|
|
238
|
+
## The answers a client must handle
|
|
239
|
+
|
|
240
|
+
| code | what happened | what the client does |
|
|
241
|
+
|---|---|---|
|
|
242
|
+
| `SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN` | The write was sent and nobody knows whether it landed (a timeout, a dropped connection, a gateway answering) | Do NOT resend under a new key. Read the row (or search for it); if it is missing, send a NEW request under a NEW key |
|
|
243
|
+
| `SYSTEM_OF_RECORD_WRITE_IN_PROGRESS` (`409`) | The same key is being sent right now | Wait and retry the same request with the same key |
|
|
244
|
+
| `SYSTEM_OF_RECORD_WRITE_IDEMPOTENCY_KEY_REUSED` (`422`, see below) | The key was already used for a different request (another row, verb or payload) | Never retry that request as it is; use a new key for a new request |
|
|
245
|
+
| `SYSTEM_OF_RECORD_WRITE_APPLIED_FOLLOW_UP_FAILED` | The remote applied the write and a step after it failed | Treat it as written; `appliedWrites` names the rows |
|
|
246
|
+
| `SYSTEM_OF_RECORD_WRITE_PARTITION_UNIT_REQUIRED` / `…_PARTITION_REFUSED` / `…_FIELD_NOT_WRITABLE` | Refused before anything was sent | Fix the request; the same key may be retried |
|
|
247
|
+
| `SYSTEM_OF_RECORD_WRITE_VERSION_REQUIRED` | A version-checked update carried no version | Send the version field exactly as it was read |
|
|
248
|
+
| `SYSTEM_OF_RECORD_WRITE_VERSION_STALE` | The row changed since it was read; nothing was sent | Read the row again, re-apply the change, send under a NEW key |
|
|
249
|
+
| `SYSTEM_OF_RECORD_WRITE_PRECONDITION_FAILED` | OData: the service refused the write because the row's entity tag moved (412); nothing was applied | Read the row again, re-apply the change, send under a NEW key |
|
|
250
|
+
| `SYSTEM_OF_RECORD_WRITE_ROW_VERSION_NOT_SERVED` | A version-checked update of a row the service serves no version for; nothing was sent | A binding problem: declare `LAST_WRITER_WINS` for that entity set |
|
|
251
|
+
|
|
252
|
+
**Of the three answers the key ledger gives, a reused key is the one that is not a `409` and carries
|
|
253
|
+
no `error.code`.** A key still in flight and a key spent on a different request are opposite
|
|
254
|
+
instructions, so they get different statuses — `409` and `422`, the statuses the Idempotency-Key draft names for them. A `422`
|
|
255
|
+
is a business-rule answer whose details the engine strips on the wire, so an HTTP client branches on
|
|
256
|
+
the status and on `error.customMessageReference: 'idempotency_key_reused'` — the same answer the
|
|
257
|
+
engine's own idempotent operations give a reused key. The code above is what your own server code
|
|
258
|
+
reads when it catches the error in-process (`error.context.code`), and what the audit trail records.
|
|
259
|
+
The same holds for a declared action's door.
|
|
260
|
+
|
|
261
|
+
A retry of an APPLIED create or update under the same key sends nothing and answers the row as it is
|
|
262
|
+
now — even when the operation's `enabledCondition` would refuse the row in the state the first attempt
|
|
263
|
+
left it: the key, not the row's current state, decides a retry. (Only where the framework runs the
|
|
264
|
+
core write that spends the key; an OVERRIDE_ALL or REPLACE implementation in front of it keeps the refusal.) A retried delete under the same key answers what the first attempt did — the deleted id — and sends nothing, even though the row is gone; a delete sent under a NEW key after the row is gone answers "not found".
|
|
265
|
+
|
|
266
|
+
**Idempotency-Key expiry: one day.** After a day a key is forgotten, and reusing it is a new request.
|
|
267
|
+
|
|
268
|
+
## What you cannot do in the same request
|
|
269
|
+
|
|
270
|
+
- **Write nested children** under a read-through parent. Parent and children could not land together,
|
|
271
|
+
because the parent's write lands in a system with no transaction to share. Write them separately.
|
|
272
|
+
- **Cascade a delete into local rows.** A local resource whose rows point at a read-through parent
|
|
273
|
+
that opens `delete` must declare, on that relationship, `REFUSE_WHILE_CHILDREN_EXIST` (the parent is
|
|
274
|
+
refused while a child names it) or `onParentDelete: { enabled: false }` (the children survive). A
|
|
275
|
+
remote delete cannot be atomic with a local cascade, and neither order is safe.
|
|
276
|
+
- **Run it inside a transaction.** A write is refused inside a database transaction — a retried
|
|
277
|
+
transaction would send it twice. Call it from code that is not inside one.
|
|
278
|
+
|
|
279
|
+
## The trail
|
|
280
|
+
|
|
281
|
+
Every write attempt — applied, refused, refused by the remote, unknown, replayed — is recorded as
|
|
282
|
+
`http_api_write_through` with the person who acted, the row, and the NAMES of the fields written.
|
|
283
|
+
Never their values: those live in the system of record.
|
|
284
|
+
|
|
285
|
+
## The stable codes
|
|
286
|
+
|
|
287
|
+
## Import Origins
|
|
288
|
+
|
|
289
|
+
- `@wildo-ai/saas-models`
|
|
290
|
+
|
|
291
|
+
## Source Excerpts
|
|
292
|
+
|
|
293
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
294
|
+
|
|
295
|
+
```typescript
|
|
296
|
+
*
|
|
297
|
+
* Why a system of record could not be prepared, read, or written — the stable `context.code` a client branches on.
|
|
298
|
+
* Imported from `@wildo-ai/saas-models`. Request codes ride a `CONFLICT` (409) or `VALIDATION` (400) answer, the two
|
|
299
|
+
* error types whose context reaches the client.
|
|
300
|
+
*/
|
|
301
|
+
export enum SystemOfRecordErrorCode {
|
|
302
|
+
/**
|
|
303
|
+
* BOOT — an instance names a vendor no facet answers to.
|
|
304
|
+
*
|
|
305
|
+
* The framework's facets ship in the opt-in library `@wildo-ai/systems-of-record` (#2013), and an augmentation
|
|
306
|
+
* package an instance opts into may add others, so this means the vendor is spelled wrong OR the package that
|
|
307
|
+
* owns it is not installed. The message names both, because from inside the registry the two are
|
|
308
|
+
* indistinguishable, and names the library and its remedy.
|
|
309
|
+
*/
|
|
310
|
+
VENDOR_HAS_NO_FACET = 'SYSTEM_OF_RECORD_VENDOR_HAS_NO_FACET',
|
|
311
|
+
|
|
312
|
+
/**
|
|
313
|
+
* BOOT — the application declares systems of record, but its provider runtime artifact lists no facet
|
|
314
|
+
* modules at all: it predates the field, or was never generated. Distinct from
|
|
315
|
+
* {@link VENDOR_HAS_NO_FACET}, because the remedy is a regeneration rather than a spelling or an
|
|
316
|
+
* install, and reporting it as that one sent a correct configuration looking for a typo (2026-09-24).
|
|
317
|
+
*/
|
|
318
|
+
FACET_MODULES_NOT_GENERATED = 'SYSTEM_OF_RECORD_FACET_MODULES_NOT_GENERATED',
|
|
319
|
+
|
|
320
|
+
/**
|
|
321
|
+
* BOOT — an instance opts into a facet AUGMENTATION (#1675) from a package that ships none for its
|
|
322
|
+
* vendor: `wildo config sync` did not record its `<package>/systems-of-record` module (a package discovery
|
|
323
|
+
* does not walk by name must be listed in `providers.packages`, #1676), the recorded module fails to load
|
|
324
|
+
* (the import error is named), or it augments other vendors only. `wildo config sync` refuses the first
|
|
325
|
+
* case too, before anything starts. Named rather than ignored, because an augmentation the author believes
|
|
326
|
+
* applies — a partition declaration, say — that silently does not is a confinement they think they have.
|
|
327
|
+
*/
|
|
328
|
+
FACET_AUGMENTATION_NOT_FOUND = 'SYSTEM_OF_RECORD_FACET_AUGMENTATION_NOT_FOUND',
|
|
329
|
+
|
|
330
|
+
/**
|
|
331
|
+
* BOOT — an opted-in augmentation (#1675) fails the augmentation schema, or the facet it produces once
|
|
332
|
+
* merged into the base fails the facet schema. The refusal names the package and the instance rather
|
|
333
|
+
* than surfacing a bare schema error that names neither.
|
|
334
|
+
*/
|
|
335
|
+
FACET_AUGMENTATION_INVALID = 'SYSTEM_OF_RECORD_FACET_AUGMENTATION_INVALID',
|
|
336
|
+
|
|
337
|
+
/**
|
|
338
|
+
* BOOT — two facet modules each present a BASE facet for one vendor (#1675). Refused naming both,
|
|
339
|
+
* because the base carries the vendor's partition and "first in module order" would let whichever
|
|
340
|
+
* package name sorts first decide how a tenant's rows are confined. A package that adds to a vendor it
|
|
341
|
+
* does not own ships an augmentation an instance opts into.
|
|
342
|
+
*/
|
|
343
|
+
FACET_BASE_CONFLICT = 'SYSTEM_OF_RECORD_FACET_BASE_CONFLICT',
|
|
344
|
+
|
|
345
|
+
/**
|
|
346
|
+
* BOOT — two sources declare the same thing for one instance's vendor (#1675): a partition declared by
|
|
347
|
+
* the base facet AND an augmentation, or by two augmentations; one credential kind offered twice. The
|
|
348
|
+
* facet is the single partition authority, so which declaration confines a tenant's rows must never
|
|
349
|
+
* depend on order. The refusal names both sources.
|
|
350
|
+
*/
|
|
351
|
+
FACET_AUGMENTATION_CONFLICT = 'SYSTEM_OF_RECORD_FACET_AUGMENTATION_CONFLICT',
|
|
352
|
+
|
|
353
|
+
/**
|
|
354
|
+
* BOOT — the instance declares a dialect its vendor's facet does not speak.
|
|
355
|
+
*
|
|
356
|
+
* A vendor may legitimately offer several (a service reachable over OData v4 and a bespoke REST
|
|
357
|
+
* surface is one vendor, two ways in), so this is checked against the facet's list rather than
|
|
358
|
+
* assumed from the vendor.
|
|
359
|
+
*/
|
|
360
|
+
DIALECT_NOT_SPOKEN_BY_VENDOR = 'SYSTEM_OF_RECORD_DIALECT_NOT_SPOKEN_BY_VENDOR',
|
|
361
|
+
|
|
362
|
+
/**
|
|
363
|
+
* BOOT — the instance names a credential kind its vendor does not offer.
|
|
364
|
+
*/
|
|
365
|
+
CREDENTIAL_KIND_NOT_OFFERED = 'SYSTEM_OF_RECORD_CREDENTIAL_KIND_NOT_OFFERED',
|
|
366
|
+
|
|
367
|
+
/**
|
|
368
|
+
* BOOT — the vendor offers several credential kinds and the instance named none.
|
|
369
|
+
*
|
|
370
|
+
* Only reachable once a facet offers more than one (#1056). Until then the kind is DERIVED and an
|
|
371
|
+
* author is never asked for something with a single legal answer.
|
|
372
|
+
*/
|
|
373
|
+
CREDENTIAL_KIND_AMBIGUOUS = 'SYSTEM_OF_RECORD_CREDENTIAL_KIND_AMBIGUOUS',
|
|
374
|
+
|
|
375
|
+
/**
|
|
376
|
+
* BOOT — a required slot's environment variable is unset while the environment DID author a block
|
|
377
|
+
* for the instance (#1055 E4).
|
|
378
|
+
*
|
|
379
|
+
* Distinct from the instance being declared absent: an environment that has no access says so with
|
|
380
|
+
* `{ enabled: false }`, and this is what is left — an environment that meant to have access and is
|
|
381
|
+
* missing a value. Silence is not a declaration, which is why these two are separable at all.
|
|
382
|
+
*/
|
|
383
|
+
REQUIRED_SLOT_MISSING = 'SYSTEM_OF_RECORD_REQUIRED_SLOT_MISSING',
|
|
384
|
+
|
|
385
|
+
/**
|
|
386
|
+
* BOOT — a resource's `httpApiBinding` names an instance the application does not declare.
|
|
387
|
+
*
|
|
388
|
+
* Checked at REGISTRATION rather than in the resource factory, because the factory runs in the
|
|
389
|
+
* application's `shared-lib` where the saas configuration is not in scope. The factory checks
|
|
390
|
+
* SHAPE; this checks AGREEMENT, at the first moment both are visible.
|
|
391
|
+
*/
|
|
392
|
+
BINDING_NAMES_UNDECLARED_SYSTEM = 'SYSTEM_OF_RECORD_BINDING_NAMES_UNDECLARED_SYSTEM',
|
|
393
|
+
|
|
394
|
+
/**
|
|
395
|
+
* BOOT — a binding's dialect and its instance's dialect disagree.
|
|
396
|
+
*
|
|
397
|
+
* Both are authored, in different files, and the binding's is the discriminator of its own
|
|
398
|
+
* per-dialect union — so the binding cannot simply inherit the instance's, and the disagreement has
|
|
399
|
+
* to be refused where both are known.
|
|
400
|
+
*/
|
|
401
|
+
BINDING_DIALECT_DISAGREES_WITH_SYSTEM = 'SYSTEM_OF_RECORD_BINDING_DIALECT_DISAGREES_WITH_SYSTEM',
|
|
402
|
+
|
|
403
|
+
/**
|
|
404
|
+
* REQUEST — this environment declared it has no access to the instance (#1055 E3).
|
|
405
|
+
*
|
|
406
|
+
* A developer laptop and a staging with no ERP are the ordinary case. The application boots, every
|
|
407
|
+
* other resource works, and a read on a bound resource answers this rather than a transport error
|
|
408
|
+
* against an address nobody authored.
|
|
409
|
+
*/
|
|
410
|
+
UNAVAILABLE_IN_ENVIRONMENT = 'SYSTEM_OF_RECORD_UNAVAILABLE_IN_ENVIRONMENT',
|
|
411
|
+
|
|
412
|
+
/**
|
|
413
|
+
* REQUEST — the application has no owner organization to stamp remote rows with (#1055 E10,
|
|
414
|
+
* resting on #1054 E1).
|
|
415
|
+
*
|
|
416
|
+
* A fresh install before bootstrap runs is the real case. Rows read out of a system of record carry
|
|
417
|
+
* the owner organization's id so the per-row tenant gate passes without an exemption; with no owner
|
|
418
|
+
* there is nothing to stamp, and answering an empty list would say "this system holds nothing about
|
|
419
|
+
* you", which is false.
|
|
420
|
+
*/
|
|
421
|
+
OWNER_ORGANIZATION_ABSENT = 'SYSTEM_OF_RECORD_OWNER_ORGANIZATION_ABSENT',
|
|
422
|
+
|
|
423
|
+
/**
|
|
424
|
+
* REQUEST — the instance's token endpoint could not be reached, refused to mint, or answered
|
|
425
|
+
* something that is not a token (#1056 E2, E3; R11).
|
|
426
|
+
*
|
|
427
|
+
* ONE code for the whole family rather than one per failure, with a `reason` in the context and an
|
|
428
|
+
* optional `retryAfterSeconds` taken from the answer's `Retry-After`. The family is deliberately
|
|
429
|
+
* coarse because every member has the same shape from a caller's side: the remote is not currently
|
|
430
|
+
* giving us an identity, the request cannot proceed, and retrying later may work. Splitting it
|
|
431
|
+
* would ask a client to branch on a distinction it cannot act on differently.
|
|
432
|
+
*
|
|
433
|
+
* Never carries the token endpoint's own `error_description` verbatim into a client-visible
|
|
434
|
+
* message: an authorization server is entitled to say things about the credential, and a
|
|
435
|
+
* credential's failure mode is not an application user's business. The detail is logged.
|
|
436
|
+
*/
|
|
437
|
+
TOKEN_UNAVAILABLE = 'SYSTEM_OF_RECORD_TOKEN_UNAVAILABLE',
|
|
438
|
+
|
|
439
|
+
/**
|
|
440
|
+
* BOOT — the instance's credential material cannot produce a credential at all: an encrypted
|
|
441
|
+
* private key (#1056 E6), a certificate whose validity window does not contain now (E7), a BASIC
|
|
442
|
+
* username carrying the `:` that RFC 7617 makes the delimiter (E11).
|
|
443
|
+
*
|
|
444
|
+
* Separate from {@link REQUIRED_SLOT_MISSING} because the remedy is different: a value IS present
|
|
445
|
+
* and it is the wrong KIND of value, so an operator re-reading their environment for a blank finds
|
|
446
|
+
* nothing. Refused at boot rather than at the first read — the material is known then, and a
|
|
447
|
+
* certificate that expired last week should not first be noticed by a user.
|
|
448
|
+
*/
|
|
449
|
+
CREDENTIAL_MATERIAL_UNUSABLE = 'SYSTEM_OF_RECORD_CREDENTIAL_MATERIAL_UNUSABLE',
|
|
450
|
+
|
|
451
|
+
/**
|
|
452
|
+
* BOOT — the instance opts into partitioning and its vendor declares none (#1058).
|
|
453
|
+
*
|
|
454
|
+
* Refused rather than ignored, for the reason the `partition` field was RESERVED for three slices:
|
|
455
|
+
* an author who writes `partition: true` and sees it accepted believes their rows are confined to
|
|
456
|
+
* organization units while every member still sees every row. An accepted declaration that does
|
|
457
|
+
* nothing is worse than a refusal, because only one of the two is visible.
|
|
458
|
+
*/
|
|
459
|
+
PARTITION_NOT_SUPPORTED_BY_VENDOR = 'SYSTEM_OF_RECORD_PARTITION_NOT_SUPPORTED_BY_VENDOR',
|
|
460
|
+
|
|
461
|
+
/**
|
|
462
|
+
* BOOT — the instance opts into partitioning and its vendor partitions by a PATH SEGMENT, which
|
|
463
|
+
* this engine cannot confine (#1058 E9).
|
|
464
|
+
*
|
|
465
|
+
* A path segment is chosen before the request is built, so it cannot express "these three
|
|
466
|
+
* companies" in one read: the confinement would have to fan out into one request per unit, which is
|
|
467
|
+
* a different MECHANISM rather than a different predicate. Distinct from the code above because the
|
|
468
|
+
* remedy differs — there the vendor has no partitions at all, here it has partitions this engine
|
|
469
|
+
* does not yet reach, and only the second is a gap on our side.
|
|
470
|
+
*/
|
|
471
|
+
PARTITION_KIND_UNSUPPORTED = 'SYSTEM_OF_RECORD_PARTITION_KIND_UNSUPPORTED',
|
|
472
|
+
|
|
473
|
+
// ─── Writes (#1679) ─────────────────────────────────────────────────────────────────────────────
|
|
474
|
+
//
|
|
475
|
+
// Every REQUEST code below is raised BEFORE anything is sent, except the two that name what the
|
|
476
|
+
// remote did (OUTCOME_UNKNOWN, APPLIED_FOLLOW_UP_FAILED) and the admission codes, which name what a
|
|
477
|
+
// retried request would do. A refusal before the send is safe to retry once the cause is fixed;
|
|
478
|
+
// the other two are the cases a client must NOT blindly retry, which is why they are codes at all.
|
|
479
|
+
|
|
480
|
+
/**
|
|
481
|
+
* BOOT — a binding opens a write verb whose DIALECT has no write implementation in this engine yet.
|
|
482
|
+
*
|
|
483
|
+
* Refused at boot rather than at the first write, for the reason every declaration refusal here is:
|
|
484
|
+
* the remedy is editing a file (remove the verb, or wait for the dialect), so nothing needs a
|
|
485
|
+
* running application to fix it. The message names the dialect, because that is the half an author
|
|
486
|
+
* cannot see from their own binding.
|
|
487
|
+
*/
|
|
488
|
+
WRITE_DIALECT_NOT_IMPLEMENTED = 'SYSTEM_OF_RECORD_WRITE_DIALECT_NOT_IMPLEMENTED',
|
|
489
|
+
|
|
490
|
+
/**
|
|
491
|
+
* REQUEST — the write was scoped to an organization that does not own the application.
|
|
492
|
+
*
|
|
493
|
+
* A system of record's rows belong to the OWNER organization (#1055 Q2). A read under another
|
|
494
|
+
* organization answers an empty page, because an empty page is a true statement about what that
|
|
495
|
+
* tenant may see; a write has no such honest empty answer, so it is refused, before anything is
|
|
496
|
+
* sent, and the refusal is audited.
|
|
497
|
+
*/
|
|
498
|
+
WRITE_ORGANIZATION_NOT_OWNER = 'SYSTEM_OF_RECORD_WRITE_ORGANIZATION_NOT_OWNER',
|
|
499
|
+
|
|
500
|
+
/**
|
|
501
|
+
* REQUEST — a CREATE on a partitioned instance could not tell which organization unit the new row
|
|
502
|
+
* belongs to, and the caller must name one (`organizationUnitId` in the payload).
|
|
503
|
+
*
|
|
504
|
+
* Reached by a member confined to SEVERAL units that own a partition of this instance, and by an
|
|
505
|
+
* organization-wide caller, who is entitled to every assigned partition and so has no single answer.
|
|
506
|
+
* Distinct from {@link WRITE_PARTITION_REFUSED} because the remedy is to ADD something, not to change it.
|
|
507
|
+
*/
|
|
508
|
+
WRITE_PARTITION_UNIT_REQUIRED = 'SYSTEM_OF_RECORD_WRITE_PARTITION_UNIT_REQUIRED',
|
|
509
|
+
|
|
510
|
+
/**
|
|
511
|
+
* REQUEST — the partition this write would land in is not one the caller may write. The context
|
|
512
|
+
* carries a {@link SystemOfRecordWritePartitionRefusal} naming which rule refused.
|
|
513
|
+
*/
|
|
514
|
+
WRITE_PARTITION_REFUSED = 'SYSTEM_OF_RECORD_WRITE_PARTITION_REFUSED',
|
|
515
|
+
|
|
516
|
+
/**
|
|
517
|
+
* REQUEST — the payload writes a field the engine owns: the partition field (it is DERIVED from the
|
|
518
|
+
* organization unit on create and never moves afterwards), the owner organization stamp, the unit
|
|
519
|
+
* stamp on update, or a key component.
|
|
520
|
+
*
|
|
521
|
+
* Refused rather than stripped. A caller who sends a partition value believes it decides where the
|
|
522
|
+
* row lands; silently discarding it would put the row somewhere they did not ask for.
|
|
523
|
+
*/
|
|
524
|
+
WRITE_FIELD_NOT_WRITABLE = 'SYSTEM_OF_RECORD_WRITE_FIELD_NOT_WRITABLE',
|
|
525
|
+
|
|
526
|
+
/**
|
|
527
|
+
* REQUEST — the write was SENT and nobody knows whether the system of record applied it: the call
|
|
528
|
+
* timed out, the connection dropped after the request left, or a gateway answered for the vendor.
|
|
529
|
+
*
|
|
530
|
+
* The one answer a client must not treat as "not written". A retry with the SAME `Idempotency-Key`
|
|
531
|
+
* answers this again without sending anything; the way forward is to READ the row (or search for it)
|
|
532
|
+
* and decide, then send a NEW request under a new key if it is genuinely missing.
|
|
533
|
+
*/
|
|
534
|
+
WRITE_OUTCOME_UNKNOWN = 'SYSTEM_OF_RECORD_WRITE_OUTCOME_UNKNOWN',
|
|
535
|
+
|
|
536
|
+
/**
|
|
537
|
+
* REQUEST — a request with this `Idempotency-Key` is being sent right now. The client retried before
|
|
538
|
+
* the first attempt settled; answering it would mean sending the write twice.
|
|
539
|
+
*
|
|
540
|
+
* Answered `409` (a CONFLICT carrying this code): wait, then retry the SAME request under the same key.
|
|
541
|
+
*/
|
|
542
|
+
WRITE_IN_PROGRESS = 'SYSTEM_OF_RECORD_WRITE_IN_PROGRESS',
|
|
543
|
+
|
|
544
|
+
/**
|
|
545
|
+
* REQUEST — this `Idempotency-Key` was already used for a DIFFERENT write (another target, verb or
|
|
546
|
+
* payload). A key names one request; replaying the first request's outcome for a second one would
|
|
547
|
+
* tell the caller something false about the second.
|
|
548
|
+
*
|
|
549
|
+
* Answered `422` with `customMessageReference: IDEMPOTENCY_KEY_REUSED` (#1941) — the status and the
|
|
550
|
+
* reference the engine's generic request idempotency answers a reused key with, so a client learns ONE
|
|
551
|
+
* spelling. A 422's context is stripped on the wire, so THIS code does not reach an HTTP client: it is
|
|
552
|
+
* what an in-process caller catching the error reads (`context.code`), and what the trail and the
|
|
553
|
+
* refusal audit row record. Never retry the request as it is; send a new request under a new key.
|
|
554
|
+
* spec-cite: draft-ietf-httpapi-idempotency-key-header-07 §2.7 (reused key with a different payload → 422;
|
|
555
|
+
* a request still being processed → 409).
|
|
556
|
+
*/
|
|
557
|
+
WRITE_IDEMPOTENCY_KEY_REUSED = 'SYSTEM_OF_RECORD_WRITE_IDEMPOTENCY_KEY_REUSED',
|
|
558
|
+
|
|
559
|
+
/**
|
|
560
|
+
* REQUEST — the system of record APPLIED the write, and something the engine did after it failed
|
|
561
|
+
* (a postfix hook, a local lifecycle step, the response description).
|
|
562
|
+
*
|
|
563
|
+
* Never reported as a failure to write: the remote change is durable and nothing here can undo it.
|
|
564
|
+
* The context names the written row, so the caller can read it; a retry with the same key replays
|
|
565
|
+
* the applied outcome rather than writing again.
|
|
566
|
+
*/
|
|
567
|
+
WRITE_APPLIED_FOLLOW_UP_FAILED = 'SYSTEM_OF_RECORD_WRITE_APPLIED_FOLLOW_UP_FAILED',
|
|
568
|
+
|
|
569
|
+
// ─── Version-checked updates (#1724, #1726) ─────────────────────────────────────────────────────
|
|
570
|
+
//
|
|
571
|
+
// A binding may declare `writeConcurrency: VERSION_CHECKED`: the caller sends the row version it read, and the engine
|
|
572
|
+
// compares it with the row it reads just before sending. On a system with no CONDITIONAL write (Odoo) that NARROWS the
|
|
573
|
+
// lost-update race and does not close it — the comparison and the write are two calls, and a change landing between
|
|
574
|
+
// them is overwritten. On OData the same version then travels as `If-Match`, and the vendor closes the gap itself
|
|
575
|
+
// (`WRITE_PRECONDITION_FAILED` below). The request codes in this block are raised BEFORE anything is sent.
|
|
576
|
+
|
|
577
|
+
/**
|
|
578
|
+
* BOOT — a binding declares `writeConcurrency: VERSION_CHECKED` and its vendor facet names no row version field
|
|
579
|
+
* (`rowVersionField`), or the binding's version field does not map onto that remote field. The check would compare a
|
|
580
|
+
* value the vendor does not maintain, and so would refuse or admit writes for no reason at all.
|
|
581
|
+
*/
|
|
582
|
+
WRITE_ROW_VERSION_NOT_SUPPORTED_BY_VENDOR = 'SYSTEM_OF_RECORD_WRITE_ROW_VERSION_NOT_SUPPORTED_BY_VENDOR',
|
|
583
|
+
|
|
584
|
+
/**
|
|
585
|
+
* REQUEST — an UPDATE on a `VERSION_CHECKED` binding carried no row version. The binding declared that every change is
|
|
586
|
+
* checked against the version its author read; an update without one would silently be last-writer-wins. Send the
|
|
587
|
+
* version field exactly as the read answered it.
|
|
588
|
+
*/
|
|
589
|
+
WRITE_VERSION_REQUIRED = 'SYSTEM_OF_RECORD_WRITE_VERSION_REQUIRED',
|
|
590
|
+
|
|
591
|
+
/**
|
|
592
|
+
* REQUEST — the row changed since the caller read it: the version it sent is not the version the system of record
|
|
593
|
+
* answered just before the write. Nothing was sent. Read the row again and decide.
|
|
594
|
+
*
|
|
595
|
+
* BEST-EFFORT on Odoo, and the refusal's message says so: a change landing between that read and the write is not
|
|
596
|
+
* seen, and a vendor that serves its version coarsely (Odoo serves `write_date` to the SECOND) cannot tell two changes
|
|
597
|
+
* made in the same second apart. The absence of this code is therefore not proof that nobody else changed the row. On
|
|
598
|
+
* OData the change landing in that gap is refused by the vendor instead, as `WRITE_PRECONDITION_FAILED`.
|
|
599
|
+
*/
|
|
600
|
+
WRITE_VERSION_STALE = 'SYSTEM_OF_RECORD_WRITE_VERSION_STALE',
|
|
601
|
+
|
|
602
|
+
/**
|
|
603
|
+
* REQUEST — an UPDATE on a `VERSION_CHECKED` binding, and the row the engine read just before writing carries NO
|
|
604
|
+
* version at all (#1726). Not "stale": nobody changed anything. The vendor serves no version for this row — an OData
|
|
605
|
+
* service that returns no `@odata.etag` for this entity set, although OData lets each set decide — so the binding's
|
|
606
|
+
* stance cannot be honoured for it. Nothing was sent. The remedy is the
|
|
607
|
+
* binding's, not the caller's: declare `LAST_WRITER_WINS` for this entity set, or have the vendor serve its versions.
|
|
608
|
+
*/
|
|
609
|
+
WRITE_ROW_VERSION_NOT_SERVED = 'SYSTEM_OF_RECORD_WRITE_ROW_VERSION_NOT_SERVED',
|
|
610
|
+
|
|
611
|
+
// ─── Conditional writes (#1726) ─────────────────────────────────────────────────────────────────
|
|
612
|
+
//
|
|
613
|
+
// A vendor that offers a real precondition (OData `If-Match` against the row's entity tag) refuses a stale write
|
|
614
|
+
// ITSELF, atomically — so the refusal arrives from the remote, after the write was sent, and still means that
|
|
615
|
+
// nothing was applied.
|
|
616
|
+
|
|
617
|
+
/**
|
|
618
|
+
* REQUEST — the system of record refused an UPDATE or DELETE because the row's version no longer matched the one the
|
|
619
|
+
* write was conditioned on: an OData `412 Precondition Failed` answering the `If-Match` the engine sent (#1726).
|
|
620
|
+
*
|
|
621
|
+
* Unlike {@link WRITE_VERSION_STALE} this is the VENDOR's decision, taken atomically against the row it was about to
|
|
622
|
+
* change, and the protocol requires that it change nothing — so it is a definite refusal, never an unknown outcome,
|
|
623
|
+
* and it is never retried: re-sending the same precondition would only be refused again. Read the row again and
|
|
624
|
+
* decide.
|
|
625
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §8.2.4 (Header If-Match).
|
|
626
|
+
*/
|
|
627
|
+
WRITE_PRECONDITION_FAILED = 'SYSTEM_OF_RECORD_WRITE_PRECONDITION_FAILED',
|
|
628
|
+
|
|
629
|
+
/**
|
|
630
|
+
* BOOT — a binding opens writes toward a vendor whose facet lists a step it requires before any modifying request
|
|
631
|
+
* (`writePrerequisites`, e.g. SAP Gateway's `X-CSRF-Token` handshake) that this engine does not perform (#1726). Every
|
|
632
|
+
* such write would be refused by the vendor; the binding stays read-only until the engine performs the step.
|
|
633
|
+
*/
|
|
634
|
+
WRITE_PREREQUISITE_NOT_SUPPORTED = 'SYSTEM_OF_RECORD_WRITE_PREREQUISITE_NOT_SUPPORTED',
|
|
635
|
+
|
|
636
|
+
// ── Declared ACTIONS (#1678) ───────────────────────────────────────────────────────────────────
|
|
637
|
+
//
|
|
638
|
+
// An action re-uses the write path's key-ledger answers as they are — WRITE_OUTCOME_UNKNOWN, WRITE_IN_PROGRESS and
|
|
639
|
+
// WRITE_IDEMPOTENCY_KEY_REUSED mean exactly the same thing for an action as for a row write, and a client that already
|
|
640
|
+
// branches on them must not learn a second spelling. Both doors answer them from one table, statuses included (#1941). What follows is what only an action can be refused for.
|
|
641
|
+
|
|
642
|
+
/**
|
|
643
|
+
* BOOT — a binding declares an action whose call shape the instance's vendor facet does not list
|
|
644
|
+
* (`actionCallShapes`). The vendor's product does not expose actions that way, so the declaration could never run.
|
|
645
|
+
*/
|
|
646
|
+
ACTION_CALL_SHAPE_NOT_SUPPORTED_BY_VENDOR = 'SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_NOT_SUPPORTED_BY_VENDOR',
|
|
647
|
+
|
|
648
|
+
/**
|
|
649
|
+
* BOOT — a record-free action toward a PARTITIONED instance declares no partition stance. It must say either why it
|
|
650
|
+
* reaches no partitioned data, or which parameter carries the partition the engine derives from the caller's unit;
|
|
651
|
+
* otherwise one member's action could land in every company.
|
|
652
|
+
*/
|
|
653
|
+
ACTION_PARTITION_STANCE_REQUIRED = 'SYSTEM_OF_RECORD_ACTION_PARTITION_STANCE_REQUIRED',
|
|
654
|
+
|
|
655
|
+
/** BOOT — two bindings of one instance declare the same action name; callers address an action by `(system, action)`. */
|
|
656
|
+
ACTION_NAME_DUPLICATED = 'SYSTEM_OF_RECORD_ACTION_NAME_DUPLICATED',
|
|
657
|
+
|
|
658
|
+
/** REQUEST — no binding of this instance declares an action of that name. */
|
|
659
|
+
ACTION_NOT_DECLARED = 'SYSTEM_OF_RECORD_ACTION_NOT_DECLARED',
|
|
660
|
+
|
|
661
|
+
/**
|
|
662
|
+
* REQUEST — this kind of context may not run this action: an anonymous or public execution, an application-scoped
|
|
663
|
+
* machine with no organization, or a system context (batch, cron, webhook, an autonomous agent with nobody behind it)
|
|
664
|
+
* on an action that does not declare `admitsSystemInitiation`.
|
|
665
|
+
*/
|
|
666
|
+
ACTION_INITIATION_NOT_ADMITTED = 'SYSTEM_OF_RECORD_ACTION_INITIATION_NOT_ADMITTED',
|
|
667
|
+
|
|
668
|
+
/**
|
|
669
|
+
* REQUEST — the action was initiated for an organization that does not own the application. A system of record's rows
|
|
670
|
+
* and actions belong to the owner organization; a tenant that is not the owner never reaches the ERP.
|
|
671
|
+
*/
|
|
672
|
+
ACTION_ORGANIZATION_NOT_OWNER = 'SYSTEM_OF_RECORD_ACTION_ORGANIZATION_NOT_OWNER',
|
|
673
|
+
|
|
674
|
+
/** REQUEST — the caller holds none of the roles the action declares, in the owner organization. */
|
|
675
|
+
ACTION_ROLE_NOT_HELD = 'SYSTEM_OF_RECORD_ACTION_ROLE_NOT_HELD',
|
|
676
|
+
|
|
677
|
+
/** REQUEST — the input does not satisfy the action's declared input schema; the context carries the issues. */
|
|
678
|
+
ACTION_INPUT_INVALID = 'SYSTEM_OF_RECORD_ACTION_INPUT_INVALID',
|
|
679
|
+
|
|
680
|
+
/**
|
|
681
|
+
* REQUEST — a WRITING action was called without an Idempotency-Key. A remote change cannot be rolled back, so every
|
|
682
|
+
* caller names its request; a retry under the same key then replays the first outcome instead of acting twice.
|
|
683
|
+
*/
|
|
684
|
+
ACTION_IDEMPOTENCY_KEY_REQUIRED = 'SYSTEM_OF_RECORD_ACTION_IDEMPOTENCY_KEY_REQUIRED',
|
|
685
|
+
|
|
686
|
+
/**
|
|
687
|
+
* REQUEST — a record-free action that carries the partition must know the caller's unit, and the caller is a member
|
|
688
|
+
* of several units owning partitions of this instance. Name one in `organizationUnitId`.
|
|
689
|
+
*/
|
|
690
|
+
ACTION_PARTITION_UNIT_REQUIRED = 'SYSTEM_OF_RECORD_ACTION_PARTITION_UNIT_REQUIRED',
|
|
691
|
+
|
|
692
|
+
/**
|
|
693
|
+
* REQUEST — the partition the action would land in is not one the caller may act in. The context carries a
|
|
694
|
+
* {@link SystemOfRecordWritePartitionRefusal} naming which rule refused — the same rules a read-through create obeys.
|
|
695
|
+
*/
|
|
696
|
+
ACTION_PARTITION_REFUSED = 'SYSTEM_OF_RECORD_ACTION_PARTITION_REFUSED',
|
|
697
|
+
|
|
698
|
+
/**
|
|
699
|
+
* REQUEST — the record a record-targeted action names is not one this caller may act on: absent, or outside its
|
|
700
|
+
* partition, or (for a shared record) not writable by a unit-confined caller. Answered as NOT_FOUND and
|
|
701
|
+
* indistinguishably, as a read answers, so an action cannot probe for records the caller may not see.
|
|
702
|
+
*/
|
|
703
|
+
ACTION_TARGET_NOT_REACHABLE = 'SYSTEM_OF_RECORD_ACTION_TARGET_NOT_REACHABLE',
|
|
704
|
+
|
|
705
|
+
/** REQUEST — the system of record refused the action with a definite answer; nothing was applied. */
|
|
706
|
+
ACTION_REMOTE_REFUSED = 'SYSTEM_OF_RECORD_ACTION_REMOTE_REFUSED',
|
|
707
|
+
|
|
708
|
+
/**
|
|
709
|
+
* REQUEST — the action could not be SENT: the instance's access could not be resolved, its handshake failed, the
|
|
710
|
+
* connection was refused before the request left, the rate budget was spent, or the read-first could not reach the
|
|
711
|
+
* record. Nothing reached the vendor as an action, so nothing was applied and the Idempotency-Key may be spent again.
|
|
712
|
+
* The context carries the transport KIND (and status), never the transport's message, which names the URL.
|
|
713
|
+
*/
|
|
714
|
+
ACTION_NOT_SENT = 'SYSTEM_OF_RECORD_ACTION_NOT_SENT',
|
|
715
|
+
}
|
|
716
|
+
|
|
717
|
+
/**
|
|
718
|
+
* Which rule refused a write's PARTITION (#1679), carried as `context.reason` beside
|
|
719
|
+
* {@link SystemOfRecordErrorCode.WRITE_PARTITION_REFUSED}.
|
|
720
|
+
*
|
|
721
|
+
* Distinct members because the remedy differs for each, and every one is somebody else's work: an
|
|
722
|
+
* operator assigns partitions, an administrator grants units, an author declares the instance.
|
|
723
|
+
*/
|
|
724
|
+
export enum SystemOfRecordWritePartitionRefusal {
|
|
725
|
+
/** The unit named (or derived) is not one the caller's grant covers. */
|
|
726
|
+
UNIT_OUTSIDE_GRANT = 'unit_outside_grant',
|
|
727
|
+
/** The unit owns no partition of this instance, so a row created "for it" would belong to nobody. */
|
|
728
|
+
UNIT_HAS_NO_PARTITION = 'unit_has_no_partition',
|
|
729
|
+
/**
|
|
730
|
+
* The unit owns SEVERAL partitions of this instance, so the unit alone does not say which one the row
|
|
731
|
+
* belongs to. The operator's assignment map decides this, not the caller: one unit, one partition is
|
|
732
|
+
* what makes a create's destination derivable.
|
|
733
|
+
*/
|
|
734
|
+
UNIT_HAS_SEVERAL_PARTITIONS = 'unit_has_several_partitions',
|
|
735
|
+
/** A unit was named for a write to an instance that is not partitioned — a stamp nothing would enforce. */
|
|
736
|
+
INSTANCE_NOT_PARTITIONED = 'instance_not_partitioned',
|
|
737
|
+
/** The narrowing authority denied the caller every unit (no decision, a registry disagreement, an empty grant). */
|
|
738
|
+
NARROWING_DENIED = 'narrowing_denied',
|
|
739
|
+
/**
|
|
740
|
+
* A UNIT-ONLY principal (a unit-scoped service-provider expert, #1597) writing a resource that does not
|
|
741
|
+
* narrow. The organization-wide admission such a principal may hold covers reads only.
|
|
742
|
+
*/
|
|
743
|
+
UNIT_ONLY_PRINCIPAL_NOT_ADMITTED = 'unit_only_principal_not_admitted',
|
|
744
|
+
}
|
|
745
|
+
```
|