@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,870 @@
|
|
|
1
|
+
# saas.models.systems-of-record
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* The charset law for an instance name, exported because the environment-variable derivation and
|
|
14
|
+
* every tool that parses a derived name back into a `(name, slot)` pair depend on it: a name may
|
|
15
|
+
* not contain `_`, so the `__` delimiter is unambiguous (#1055 R4).
|
|
16
|
+
*/
|
|
17
|
+
export const SYSTEM_OF_RECORD_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
|
|
18
|
+
|
|
19
|
+
/** 32 characters, because the name is a stem of an environment-variable name rather than a label. */
|
|
20
|
+
export const SYSTEM_OF_RECORD_NAME_MAX_LENGTH = 32;
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Whether the personal data held in a system-of-record INSTANCE can have originated from publicly
|
|
24
|
+
* accessible sources (#1745) — the half of GDPR Art. 14(2)(f) nothing else in an application can
|
|
25
|
+
* derive.
|
|
26
|
+
*
|
|
27
|
+
* A privacy notice owes, for personal data not collected from the person, "from which source the
|
|
28
|
+
* personal data originate, and if applicable, whether it came from publicly accessible sources".
|
|
29
|
+
* spec-cite: GDPR Art. 14(2)(f), https://gdpr-info.eu/art-14-gdpr/.
|
|
30
|
+
* The binding already makes the first half true: the source is this instance, a deployment the
|
|
31
|
+
* operator runs. The second half is about how records got INTO that deployment — an ERP contact
|
|
32
|
+
* may have been typed in from a public register, a website or a bought list — and only the
|
|
33
|
+
* operator knows. So the operator states it here, once per instance, as a typed value a reviewer
|
|
34
|
+
* can diff, rather than answering a question or leaving it to a drafter's guess.
|
|
35
|
+
*
|
|
36
|
+
* Omitting it is legitimate and is NOT read as "no": the notice's source statement then marks the
|
|
37
|
+
* public-origin half owed for every resource read from the instance.
|
|
38
|
+
*/
|
|
39
|
+
export enum SystemOfRecordPersonalDataOrigin {
|
|
40
|
+
/** Every person's data in this instance was collected by the operator — from the person, their organisation or the operator's own dealings with them — and none from a publicly accessible source. */
|
|
41
|
+
NO_PUBLICLY_ACCESSIBLE_SOURCES = 'no-publicly-accessible-sources',
|
|
42
|
+
/** Some of it may come from publicly accessible sources: company registers, websites, social profiles, enrichment services. The notice says so. */
|
|
43
|
+
INCLUDES_PUBLICLY_ACCESSIBLE_SOURCES = 'includes-publicly-accessible-sources',
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
export const SystemOfRecordNameSchema = z
|
|
47
|
+
.string()
|
|
48
|
+
.regex(SYSTEM_OF_RECORD_NAME_PATTERN, 'A system-of-record name is lower-kebab-case, starting with a letter.')
|
|
49
|
+
.max(SYSTEM_OF_RECORD_NAME_MAX_LENGTH);
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
* The i18n bucket holding every instance's display words — the first segment of
|
|
53
|
+
* {@link buildSystemOfRecordDisplayNameLabelKey}'s keys.
|
|
54
|
+
*/
|
|
55
|
+
export const SYSTEM_OF_RECORD_LABEL_BUCKET = 'systems_of_record';
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* The label key naming ONE declared instance to a person: `systems_of_record.<name>.displayName` (#1997).
|
|
59
|
+
*
|
|
60
|
+
* An instance NAME is an environment-variable stem (`odoo`, `sap-fr`), not words: it cannot be translated, and the
|
|
61
|
+
* words a reader recognises ("Odoo", "SAP France") are not derivable from it. So a surface that names an instance —
|
|
62
|
+
* the provenance cue on a field a pipeline wrote, "synced from Odoo" — resolves this key, and the labelling pipeline
|
|
63
|
+
* plans it for every declared instance, total over `systemsOfRecord`. There is deliberately no `displayName` on the
|
|
64
|
+
* declaration: display text comes from the i18n tree, never from configuration. A key nobody generated renders the
|
|
65
|
+
* raw name, which is the missing label looking missing.
|
|
66
|
+
*/
|
|
67
|
+
export function buildSystemOfRecordDisplayNameLabelKey(name: string): string {
|
|
68
|
+
return `${SYSTEM_OF_RECORD_LABEL_BUCKET}.${name}.displayName`;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** ONE declared instance. */
|
|
72
|
+
export const SystemOfRecordDeclarationSchema = z.strictObject({
|
|
73
|
+
/**
|
|
74
|
+
* Which vendor this is an instance of — the `vendor` of a facet the deployment ships: the framework's facets
|
|
75
|
+
* come from the opt-in library `@wildo-ai/systems-of-record`, which `wildo config sync` declares on the backend
|
|
76
|
+
* as soon as an instance is declared (#2013). Refused at boot when no facet answers to it, rather than here,
|
|
77
|
+
* because the facet map is not in scope in `wildo.saas.config.ts`.
|
|
78
|
+
*/
|
|
79
|
+
vendor: z.string().regex(/^[a-z][a-z0-9-]*$/, 'A vendor id is lower-kebab-case.').max(40),
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* How this instance is READ. Declared per instance rather than taken from the facet because a
|
|
83
|
+
* vendor may speak several dialects — a service reachable over both OData v4 and a bespoke REST
|
|
84
|
+
* surface is one vendor and two ways in. The facet's `dialects` is the closed set this must belong
|
|
85
|
+
* to, checked at boot.
|
|
86
|
+
*
|
|
87
|
+
* ## One instance per SERVICE ROOT — so a system serving OData v2 and v4 is two instances (#1687)
|
|
88
|
+
*
|
|
89
|
+
* An instance has ONE dialect and ONE base URL, and for OData that URL is a service root: an SAP
|
|
90
|
+
* system's `/sap/opu/odata/sap/API_BUSINESS_PARTNER` (v2) and `/sap/opu/odata4/sap/<service>/…` (v4)
|
|
91
|
+
* are different roots, as two v4 services of the same system already are. So a system reached over
|
|
92
|
+
* both versions is declared as two instances, one per root, each with its own dialect, credential
|
|
93
|
+
* and `maxRequestsPerMinute`.
|
|
94
|
+
*
|
|
95
|
+
* Decided rather than asked, because the model already answered it: an instance naming several roots
|
|
96
|
+
* would need a root per binding, which is what two instances are, and a budget SHARED across
|
|
97
|
+
* instances would be a new cross-instance ledger for a ceiling the operator can already honour by
|
|
98
|
+
* splitting it between the instances' `maxRequestsPerMinute`. Both were rejected on that ground.
|
|
99
|
+
* The cost, stated: two instances against one vendor account are paced separately, so their sum —
|
|
100
|
+
* not either one — is what must stay under the vendor's allowance.
|
|
101
|
+
*/
|
|
102
|
+
dialect: z.enum(HttpApiTransportDialect),
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* How the engine proves who it is.
|
|
106
|
+
*
|
|
107
|
+
* OPTIONAL, and the absence is DERIVED rather than defaulted: when the instance's facet offers
|
|
108
|
+
* exactly one credential kind there is nothing for an author to decide, so the registry takes it;
|
|
109
|
+
* when a facet offers more than one and the instance names none, boot refuses and lists them.
|
|
110
|
+
* The framework derives before it asks: a declaration with one legal value is a question whose
|
|
111
|
+
* answer the mechanism already holds.
|
|
112
|
+
*
|
|
113
|
+
* This stays additive when #1056 widens the facet set: an instance that omitted the field is
|
|
114
|
+
* refused on the day its facet gains a second kind, which is exactly the day its author acquires a
|
|
115
|
+
* real decision.
|
|
116
|
+
*/
|
|
117
|
+
credential: z.strictObject({ kind: z.enum(SystemOfRecordCredentialKind) }).optional(),
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* The pace this deployment may call the instance at, across EVERY resource bound to it (#1056 §3).
|
|
121
|
+
*
|
|
122
|
+
* Per INSTANCE because that is the unit the vendor accounts for: two resources bound to one
|
|
123
|
+
* Dataverse are one application user to Dataverse, so two independent per-binding budgets would
|
|
124
|
+
* each believe they were within a limit the pair together exceeds.
|
|
125
|
+
*
|
|
126
|
+
* A binding's own `remoteCallSemantics.maxRequestsPerMinute` stays, and becomes a CEILING UNDER
|
|
127
|
+
* this one: it answers a different question — how much of the shared allowance may ONE resource
|
|
128
|
+
* take — which matters when a pipeline load and an interactive read share an instance. Both are
|
|
129
|
+
* consumed for every call, and a call proceeds only if both have room.
|
|
130
|
+
*
|
|
131
|
+
* Omitted means unlimited HERE, which is the honest default: the framework does not know the
|
|
132
|
+
* vendor's contract, and inventing a number would either throttle a deployment that paid for more
|
|
133
|
+
* or fail to protect one that has less.
|
|
134
|
+
*/
|
|
135
|
+
maxRequestsPerMinute: z.number().int().min(1).max(600_000).optional(),
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* Whether THIS deployment's data is partitioned, and its rows therefore confined to organization
|
|
139
|
+
* units of the owner organization (#1058).
|
|
140
|
+
*
|
|
141
|
+
* ## The reservation this replaces
|
|
142
|
+
*
|
|
143
|
+
* #1055 declared this field `z.never()` and refused it by name, because accepting a declaration the
|
|
144
|
+
* mechanism could not honour would let an author believe their rows were narrowed while every
|
|
145
|
+
* member still saw every row. That refusal did its job and is now lifted.
|
|
146
|
+
*
|
|
147
|
+
* ## Why the VENDOR says how and the INSTANCE says whether
|
|
148
|
+
*
|
|
149
|
+
* How a vendor partitions — which field, what shape, what codec — is a property of the vendor and
|
|
150
|
+
* lives on its facet. Whether a given deployment's data is partitioned is a property of the
|
|
151
|
+
* deployment: a single-company Odoo has a `company_id` on every row and nothing to confine, and
|
|
152
|
+
* asking its operator to restate the field name would be asking a question the facet answers.
|
|
153
|
+
*
|
|
154
|
+
* Opting in against a facet that declares no partitioning is refused at boot, naming the vendor —
|
|
155
|
+
* the alternative is a `true` that does nothing, which is the shape the reservation existed to
|
|
156
|
+
* prevent in the first place.
|
|
157
|
+
*/
|
|
158
|
+
partition: z.boolean().optional(),
|
|
159
|
+
|
|
160
|
+
/**
|
|
161
|
+
* The PACKAGES whose facet augmentation applies to this instance (#1675) — npm package names, each of which
|
|
162
|
+
* must ship an augmentation for this instance's vendor from its `./systems-of-record` export.
|
|
163
|
+
*
|
|
164
|
+
* An explicit opt-in per INSTANCE, never implied by installation, because what an augmentation adds can be a
|
|
165
|
+
* partition declaration, and the facet is the single authority on how a tenant's rows are confined. Two
|
|
166
|
+
* instances of one vendor may therefore differ: one opts a package's partition in, the other does not.
|
|
167
|
+
* A package named here that ships no augmentation for the vendor refuses at startup, naming it.
|
|
168
|
+
*
|
|
169
|
+
* Naming a package here is also what ADMITS its `./systems-of-record` module to discovery (#2013): apart from the
|
|
170
|
+
* framework library `@wildo-ai/systems-of-record`, a facet module is recorded only from a package some instance
|
|
171
|
+
* names. The package must still be walked — named `<scope>/provider-*`, or listed in `providers.packages`.
|
|
172
|
+
*/
|
|
173
|
+
facetAugmentations: z.array(z.string().min(1).max(214)).min(1).refine(
|
|
174
|
+
(packages) => new Set(packages).size === packages.length,
|
|
175
|
+
'A package is named twice in facetAugmentations.',
|
|
176
|
+
).optional(),
|
|
177
|
+
|
|
178
|
+
/**
|
|
179
|
+
* Whether the personal data in THIS deployment can have come from publicly accessible sources — see
|
|
180
|
+
* {@link SystemOfRecordPersonalDataOrigin}. A property of the deployment, not the vendor: two Odoo
|
|
181
|
+
* instances may be fed differently. Optional; omitted, the privacy notice marks that statement owed
|
|
182
|
+
* for every resource read from this instance, and never states "not from public sources" by default.
|
|
183
|
+
*/
|
|
184
|
+
personalDataOrigin: z.enum(SystemOfRecordPersonalDataOrigin).optional(),
|
|
185
|
+
});
|
|
186
|
+
export type SystemOfRecordDeclaration = z.infer<typeof SystemOfRecordDeclarationSchema>;
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* Every instance this application declares, keyed by name.
|
|
190
|
+
*
|
|
191
|
+
* Optional as a whole: an application that reads nothing out of another system declares nothing, and
|
|
192
|
+
* declaring this block is what ENABLES the external-data lane (#1055 D3) rather than an engine
|
|
193
|
+
* capability flag — the lane has no meaning without an instance to point at.
|
|
194
|
+
*/
|
|
195
|
+
export const SystemsOfRecordConfigSchema = z
|
|
196
|
+
.record(SystemOfRecordNameSchema, SystemOfRecordDeclarationSchema)
|
|
197
|
+
.superRefine((systemsOfRecord, ctx) => {
|
|
198
|
+
if (Object.keys(systemsOfRecord).length === 0) {
|
|
199
|
+
ctx.addIssue({
|
|
200
|
+
code: 'custom',
|
|
201
|
+
path: [],
|
|
202
|
+
message:
|
|
203
|
+
'An empty `systemsOfRecord` declares nothing and enables nothing. Omit the block entirely, or declare the '
|
|
204
|
+
+ 'instance the application reads.',
|
|
205
|
+
});
|
|
206
|
+
}
|
|
207
|
+
});
|
|
208
|
+
export type SystemsOfRecordConfig = z.infer<typeof SystemsOfRecordConfigSchema>;
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
212
|
+
|
|
213
|
+
```typescript
|
|
214
|
+
/**
|
|
215
|
+
* One input an instance must supply — an address slot (non-secret, authored in the infra env
|
|
216
|
+
* config) or a secret slot (authored in `secrets.json`). Both halves share this shape because both
|
|
217
|
+
* derive an environment-variable name the same way; what differs is WHERE the value is authored and
|
|
218
|
+
* whether it is ever printed.
|
|
219
|
+
*/
|
|
220
|
+
export const SystemOfRecordSlotSchema = z.strictObject({
|
|
221
|
+
/**
|
|
222
|
+
* lowerCamelCase, and nothing else — see the module header. Becomes the `<SLOT>` half of
|
|
223
|
+
* `WILDO_SOR_<NAME>__<SLOT>` by upper-snake-casing.
|
|
224
|
+
*/
|
|
225
|
+
slug: z
|
|
226
|
+
.string()
|
|
227
|
+
.regex(SYSTEM_OF_RECORD_SLOT_SLUG_PATTERN, 'A slot slug is lowerCamelCase with no separators.')
|
|
228
|
+
.max(40)
|
|
229
|
+
.refine((slug) => slug !== SYSTEM_OF_RECORD_ENABLED_SLOT, {
|
|
230
|
+
error:
|
|
231
|
+
`"${SYSTEM_OF_RECORD_ENABLED_SLOT}" is reserved: the environment builder emits `
|
|
232
|
+
+ `${deriveSystemOfRecordEnabledEnvVarName('example')} itself to say an environment has no access to an instance. `
|
|
233
|
+
+ 'A slot of that name would make "declared absent" indistinguishable from an address whose value happens to be false.',
|
|
234
|
+
}),
|
|
235
|
+
/**
|
|
236
|
+
* Whether an instance MUST supply it. A missing required slot refuses at `wildo config sync` and
|
|
237
|
+
* again at boot (#1055 E4) — the remedy is authoring a value, which needs no running companion,
|
|
238
|
+
* so refusing is legitimate there.
|
|
239
|
+
*/
|
|
240
|
+
required: z.boolean(),
|
|
241
|
+
/** What an operator must put in it. Printed by sync and by the secrets report. */
|
|
242
|
+
description: z.string().min(1),
|
|
243
|
+
});
|
|
244
|
+
export type SystemOfRecordSlot = z.infer<typeof SystemOfRecordSlotSchema>;
|
|
245
|
+
|
|
246
|
+
/**
|
|
247
|
+
* A slot list that cannot be order-dependent or ambiguous: sorted by slug, slugs unique.
|
|
248
|
+
*
|
|
249
|
+
* Mirrors `ProviderSecretContractShapeSchema`, and for the same reason — these lists are compared,
|
|
250
|
+
* reported and (once #1057 lands) contributed by independently-versioned packages, so two facets
|
|
251
|
+
* declaring the same slots in different orders must not be two different things.
|
|
252
|
+
*/
|
|
253
|
+
const systemOfRecordSlotListSchema = (label: string) =>
|
|
254
|
+
z.array(SystemOfRecordSlotSchema).superRefine((slots, context) => {
|
|
255
|
+
const seen = new Set<string>();
|
|
256
|
+
for (const [index, slot] of slots.entries()) {
|
|
257
|
+
if (seen.has(slot.slug)) {
|
|
258
|
+
context.addIssue({ code: 'custom', path: [index, 'slug'], message: `Duplicate ${label} slot "${slot.slug}".` });
|
|
259
|
+
}
|
|
260
|
+
seen.add(slot.slug);
|
|
261
|
+
if (index > 0 && slots[index - 1]!.slug.localeCompare(slot.slug) >= 0) {
|
|
262
|
+
context.addIssue({ code: 'custom', path: [index, 'slug'], message: `${label} slots must be sorted by slug.` });
|
|
263
|
+
}
|
|
264
|
+
}
|
|
265
|
+
});
|
|
266
|
+
|
|
267
|
+
/**
|
|
268
|
+
* What ONE credential kind needs, independent of vendor (#1055 R15).
|
|
269
|
+
*
|
|
270
|
+
* The kind owns its secrets and any address slot that exists only because the kind was chosen — a
|
|
271
|
+
* future `OAUTH2_CLIENT_CREDENTIALS` owns `tokenUrl`, which no vendor would declare if it were
|
|
272
|
+
* reached with a static key. `ODOO_API_KEY_IN_ARGS` needs no address slot of its own, and that is
|
|
273
|
+
* the seam rather than an omission: its `database` and `login` inputs identify WHICH Odoo and WHICH
|
|
274
|
+
* user, so they belong to the vendor and would survive a second Odoo credential kind.
|
|
275
|
+
*/
|
|
276
|
+
export const SystemOfRecordCredentialKindContractSchema = z.strictObject({
|
|
277
|
+
addressSlots: systemOfRecordSlotListSchema('credential address'),
|
|
278
|
+
secretSlots: systemOfRecordSlotListSchema('credential secret'),
|
|
279
|
+
});
|
|
280
|
+
export type SystemOfRecordCredentialKindContract = z.infer<typeof SystemOfRecordCredentialKindContractSchema>;
|
|
281
|
+
|
|
282
|
+
/**
|
|
283
|
+
* Every credential kind's inputs. Engine-owned and CLOSED, keyed by the enum so a member added
|
|
284
|
+
* without a contract is a compile error rather than a boot surprise.
|
|
285
|
+
*
|
|
286
|
+
* ## Which half a slot lands in, since the answer is not "is it secret"
|
|
287
|
+
*
|
|
288
|
+
* The split follows the precedent #1055 set with Odoo's `login`: **an identity slot is an ADDRESS
|
|
289
|
+
* slot and a proof slot is a SECRET slot.** A `clientId` and a BASIC `username` are not
|
|
290
|
+
* confidential — they name WHICH client and WHICH user — and putting them in `secrets.json` would
|
|
291
|
+
* hide, from every diff and every environment review, the one thing an operator most often needs to
|
|
292
|
+
* check. What must never be printed is the half that PROVES the identity.
|
|
293
|
+
*
|
|
294
|
+
* The consequence is that a credential's two halves are authored in two files. That is deliberate
|
|
295
|
+
* and it is the same shape Odoo already has (`login` in the infra config, `apiKey` in the secrets),
|
|
296
|
+
* so an operator meets one convention rather than two.
|
|
297
|
+
*
|
|
298
|
+
* ## Required-ness that a static list cannot express
|
|
299
|
+
*
|
|
300
|
+
* Three slots are declared `required: false` here and are made required by the FACET's offer, which
|
|
301
|
+
* is the only place that knows: `certificateKeyId` when the vendor's assertion header policy is
|
|
302
|
+
* {@link SystemOfRecordAssertionHeaderPolicy.KEY_ID_SUPPLIED}, `certificatePem` when it is
|
|
303
|
+
* `X509_THUMBPRINT_DERIVED`, and `subject` for the JWT-bearer grant's `sub`. The join is performed
|
|
304
|
+
* ONCE, in {@link resolveSystemOfRecordInstanceSlots}, rather than by each of the five readers of
|
|
305
|
+
* "what does this instance need" — which is the enumeration failure
|
|
306
|
+
* `invariant-call-site-enumeration.md` exists to stop.
|
|
307
|
+
*/
|
|
308
|
+
export const SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS: Readonly<Record<SystemOfRecordCredentialKind, SystemOfRecordCredentialKindContract>> = {
|
|
309
|
+
[SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS]: {
|
|
310
|
+
addressSlots: [],
|
|
311
|
+
secretSlots: [
|
|
312
|
+
{
|
|
313
|
+
slug: 'apiKey',
|
|
314
|
+
required: true,
|
|
315
|
+
description:
|
|
316
|
+
'Odoo external-API key (Settings → Users → API Keys). It replaces the password in '
|
|
317
|
+
+ '`common.authenticate` and rides as a positional argument of every `execute_kw` call.',
|
|
318
|
+
},
|
|
319
|
+
],
|
|
320
|
+
},
|
|
321
|
+
|
|
322
|
+
[SystemOfRecordCredentialKind.API_KEY_HEADER]: {
|
|
323
|
+
addressSlots: [],
|
|
324
|
+
secretSlots: [
|
|
325
|
+
{
|
|
326
|
+
slug: 'apiKey',
|
|
327
|
+
required: true,
|
|
328
|
+
description:
|
|
329
|
+
'The static key this deployment presents. It travels in the header the vendor facet names — '
|
|
330
|
+
+ 'the operator never chooses the header, only supplies the key.',
|
|
331
|
+
},
|
|
332
|
+
],
|
|
333
|
+
},
|
|
334
|
+
|
|
335
|
+
[SystemOfRecordCredentialKind.API_KEY_QUERY]: {
|
|
336
|
+
addressSlots: [],
|
|
337
|
+
secretSlots: [
|
|
338
|
+
{
|
|
339
|
+
slug: 'apiKey',
|
|
340
|
+
required: true,
|
|
341
|
+
description:
|
|
342
|
+
'The static key this deployment presents, appended as the query parameter the vendor facet '
|
|
343
|
+
+ 'names. Weaker than a header — a URL reaches access logs and proxy logs — so prefer a '
|
|
344
|
+
+ 'header kind when the vendor offers one.',
|
|
345
|
+
},
|
|
346
|
+
],
|
|
347
|
+
},
|
|
348
|
+
|
|
349
|
+
[SystemOfRecordCredentialKind.BASIC]: {
|
|
350
|
+
addressSlots: [
|
|
351
|
+
{
|
|
352
|
+
slug: 'username',
|
|
353
|
+
required: true,
|
|
354
|
+
description:
|
|
355
|
+
'The user this deployment authenticates as (SAP calls it a communication user). It names an '
|
|
356
|
+
+ 'identity rather than proving one, so it is authored in the environment config beside the '
|
|
357
|
+
+ 'base URL. It may not contain ":" — RFC 7617 makes the colon the delimiter.',
|
|
358
|
+
},
|
|
359
|
+
],
|
|
360
|
+
secretSlots: [
|
|
361
|
+
{ slug: 'password', required: true, description: "That user's password. Half of one credential; rotate it with the username only if the vendor requires." },
|
|
362
|
+
],
|
|
363
|
+
},
|
|
364
|
+
|
|
365
|
+
[SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET]: {
|
|
366
|
+
addressSlots: [
|
|
367
|
+
{ slug: 'audience', required: false, description: 'The `audience` / `resource` parameter, when the vendor requires one to scope the token (Entra names the resource; Salesforce does not).' },
|
|
368
|
+
{ slug: 'clientId', required: true, description: 'The registered application (client) id. Names WHICH client, so it is addressing rather than proof.' },
|
|
369
|
+
{ slug: 'scope', required: false, description: 'Space-delimited scopes to request. Omitted when the vendor derives them from the client registration.' },
|
|
370
|
+
{ slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL. Kind-owned: no vendor would declare it if the instance were reached with a static key." },
|
|
371
|
+
],
|
|
372
|
+
secretSlots: [
|
|
373
|
+
{ slug: 'clientSecret', required: true, description: 'The client secret issued with the client id. This is the half that proves the identity, and the only half that is never printed.' },
|
|
374
|
+
],
|
|
375
|
+
},
|
|
376
|
+
|
|
377
|
+
[SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE]: {
|
|
378
|
+
addressSlots: [
|
|
379
|
+
{ slug: 'audience', required: false, description: 'The `audience` / `resource` parameter when the vendor requires one.' },
|
|
380
|
+
{
|
|
381
|
+
slug: 'certificateKeyId',
|
|
382
|
+
required: false,
|
|
383
|
+
description:
|
|
384
|
+
'The key id the vendor assigned to this certificate, placed in the assertion\'s protected '
|
|
385
|
+
+ 'header as `kid` (NetSuite issues one at upload). REQUIRED when the vendor facet declares '
|
|
386
|
+
+ 'the key-id header policy; unused otherwise.',
|
|
387
|
+
},
|
|
388
|
+
{
|
|
389
|
+
slug: 'certificatePem',
|
|
390
|
+
required: false,
|
|
391
|
+
description:
|
|
392
|
+
'The PUBLIC certificate in PEM, used to derive the `x5t` thumbprint the assertion header '
|
|
393
|
+
+ 'carries. REQUIRED when the vendor facet declares the thumbprint header policy; unused '
|
|
394
|
+
+ 'otherwise. Public material, so it is an address slot rather than a secret.',
|
|
395
|
+
},
|
|
396
|
+
{ slug: 'clientId', required: true, description: 'The registered application (client) id — the assertion\'s `iss` and `sub`.' },
|
|
397
|
+
{ slug: 'scope', required: false, description: 'Space-delimited scopes to request.' },
|
|
398
|
+
{ slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL, and the assertion's `aud`." },
|
|
399
|
+
],
|
|
400
|
+
secretSlots: [
|
|
401
|
+
{
|
|
402
|
+
slug: 'privateKeyPem',
|
|
403
|
+
required: true,
|
|
404
|
+
description:
|
|
405
|
+
'The UNENCRYPTED PKCS#8 private key, in PEM, that signs the client assertion. An '
|
|
406
|
+
+ 'encrypted key is refused by name: the secret channel is the protection, and a passphrase '
|
|
407
|
+
+ 'stored beside the key it protects protects nothing.',
|
|
408
|
+
},
|
|
409
|
+
],
|
|
410
|
+
},
|
|
411
|
+
|
|
412
|
+
[SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER]: {
|
|
413
|
+
addressSlots: [
|
|
414
|
+
{ slug: 'audience', required: false, description: 'The assertion\'s `aud`, when it differs from the token endpoint (Salesforce wants the login host).' },
|
|
415
|
+
{ slug: 'clientId', required: true, description: 'The connected app\'s consumer key — the assertion\'s `iss`.' },
|
|
416
|
+
{ slug: 'scope', required: false, description: 'Space-delimited scopes to request.' },
|
|
417
|
+
{
|
|
418
|
+
slug: 'subject',
|
|
419
|
+
required: false,
|
|
420
|
+
description:
|
|
421
|
+
'The user the assertion is made FOR — its `sub`. REQUIRED for this grant and declared '
|
|
422
|
+
+ 'optional here only because the facet\'s offer is what asserts it; a service account\'s '
|
|
423
|
+
+ 'username on the vendor side.',
|
|
424
|
+
},
|
|
425
|
+
{ slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL." },
|
|
426
|
+
],
|
|
427
|
+
secretSlots: [
|
|
428
|
+
{ slug: 'privateKeyPem', required: true, description: 'The UNENCRYPTED PKCS#8 private key, in PEM, that signs the assertion. An encrypted key is refused by name.' },
|
|
429
|
+
],
|
|
430
|
+
},
|
|
431
|
+
};
|
|
432
|
+
|
|
433
|
+
/**
|
|
434
|
+
* How a vendor wants a client assertion's PROTECTED HEADER built (#1056 R2).
|
|
435
|
+
*
|
|
436
|
+
* A generic "sign it with the private key" is rejected by both vendors that want an assertion, and
|
|
437
|
+
* they want DIFFERENT things — which is why this is a facet policy rather than an engine constant.
|
|
438
|
+
*/
|
|
439
|
+
export enum SystemOfRecordAssertionHeaderPolicy {
|
|
440
|
+
/** `kid` carries a key id the VENDOR assigned when the certificate was uploaded (NetSuite). */
|
|
441
|
+
KEY_ID_SUPPLIED = 'key-id-supplied',
|
|
442
|
+
/**
|
|
443
|
+
* `x5t` carries the base64url SHA-1 thumbprint of the certificate, DERIVED by the engine from the
|
|
444
|
+
* supplied `certificatePem` (Microsoft Entra's certificate credential).
|
|
445
|
+
*
|
|
446
|
+
* SHA-1 is not a security choice here: `x5t` is defined as a SHA-1 thumbprint (RFC 7515 §4.1.7)
|
|
447
|
+
* and is an identifier for locating a key, never an integrity proof.
|
|
448
|
+
* spec-cite: RFC 7515 §4.1.7 ("x5t" (X.509 Certificate SHA-1 Thumbprint) Header Parameter).
|
|
449
|
+
*/
|
|
450
|
+
X509_THUMBPRINT_DERIVED = 'x509-thumbprint-derived',
|
|
451
|
+
}
|
|
452
|
+
|
|
453
|
+
/**
|
|
454
|
+
* Where a client's id and secret travel on a client-credentials token request.
|
|
455
|
+
*
|
|
456
|
+
* RFC 6749 §2.3.1 permits BOTH and says a server MUST support the Basic header while it MAY support
|
|
457
|
+
* the body form — and real vendors differ, so the choice cannot be an engine default.
|
|
458
|
+
* spec-cite: RFC 6749 §2.3.1 (Client Password).
|
|
459
|
+
*/
|
|
460
|
+
export enum SystemOfRecordClientAuthenticationPlacement {
|
|
461
|
+
/** `client_id` and `client_secret` as form fields in the request body. */
|
|
462
|
+
REQUEST_BODY = 'request-body',
|
|
463
|
+
/** `Authorization: Basic base64(client_id ":" client_secret)`. */
|
|
464
|
+
BASIC_HEADER = 'basic-header',
|
|
465
|
+
}
|
|
466
|
+
|
|
467
|
+
/**
|
|
468
|
+
* The algorithms an assertion may be signed with. Asymmetric ONLY, and that is the point: a
|
|
469
|
+
* symmetric `HS*` assertion is signed with a shared secret, which makes the assertion no stronger
|
|
470
|
+
* than the secret it was supposed to replace, and `none` is not an algorithm.
|
|
471
|
+
*/
|
|
472
|
+
export enum SystemOfRecordAssertionSigningAlgorithm {
|
|
473
|
+
RS256 = 'RS256',
|
|
474
|
+
RS384 = 'RS384',
|
|
475
|
+
RS512 = 'RS512',
|
|
476
|
+
PS256 = 'PS256',
|
|
477
|
+
ES256 = 'ES256',
|
|
478
|
+
ES384 = 'ES384',
|
|
479
|
+
ES512 = 'ES512',
|
|
480
|
+
}
|
|
481
|
+
|
|
482
|
+
/**
|
|
483
|
+
* How long to treat a token as valid when the answer carries no `expires_in` (#1056 R3).
|
|
484
|
+
*
|
|
485
|
+
* A FACET property rather than a per-kind engine constant, because two vendors of the SAME kind
|
|
486
|
+
* disagree: NetSuite's answer states `expires_in` is always 3600, while Salesforce's
|
|
487
|
+
* client-credentials answer is reported to omit it. A per-kind constant would have to be wrong for
|
|
488
|
+
* one of them.
|
|
489
|
+
*/
|
|
490
|
+
const tokenLifetimeFallbackSecondsSchema = z.number().int().min(30).max(86_400);
|
|
491
|
+
|
|
492
|
+
/**
|
|
493
|
+
* ONE credential kind as ONE vendor offers it — the kind, plus everything about it that varies by
|
|
494
|
+
* VENDOR and not by deployment.
|
|
495
|
+
*
|
|
496
|
+
* A discriminated union rather than a kind list beside a policy map, so a policy cannot exist
|
|
497
|
+
* without its kind and a kind cannot be offered without the policy it needs. `API_KEY_HEADER` with
|
|
498
|
+
* no header name is unrepresentable here; under a parallel map it would parse and fail at the first
|
|
499
|
+
* read.
|
|
500
|
+
*/
|
|
501
|
+
export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind', [
|
|
502
|
+
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS).systemEnum('SystemOfRecordCredentialKind') }),
|
|
503
|
+
|
|
504
|
+
z.strictObject({
|
|
505
|
+
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_HEADER).systemEnum('SystemOfRecordCredentialKind'),
|
|
506
|
+
/** The header the key travels in — `Authorization`, `X-API-Key`, `apikey`, whatever the vendor reads. */
|
|
507
|
+
headerName: z.string().regex(/^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/, 'A header name is an RFC 9110 token.').max(64),
|
|
508
|
+
/** What precedes the key in the header value, INCLUDING its trailing space (`"Bearer "`). Omitted when the key stands alone. */
|
|
509
|
+
valuePrefix: z.string().max(32).optional(),
|
|
510
|
+
}),
|
|
511
|
+
|
|
512
|
+
z.strictObject({
|
|
513
|
+
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_QUERY).systemEnum('SystemOfRecordCredentialKind'),
|
|
514
|
+
/** The query parameter the key is appended as. */
|
|
515
|
+
parameterName: z.string().regex(/^[A-Za-z0-9_.-]+$/, 'A query parameter name is alphanumeric with -._').max(64),
|
|
516
|
+
}),
|
|
517
|
+
|
|
518
|
+
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.BASIC).systemEnum('SystemOfRecordCredentialKind') }),
|
|
519
|
+
|
|
520
|
+
z.strictObject({
|
|
521
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET).systemEnum('SystemOfRecordCredentialKind'),
|
|
522
|
+
clientAuthentication: z.enum(SystemOfRecordClientAuthenticationPlacement),
|
|
523
|
+
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
524
|
+
}),
|
|
525
|
+
|
|
526
|
+
z.strictObject({
|
|
527
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'),
|
|
528
|
+
assertionHeaderPolicy: z.enum(SystemOfRecordAssertionHeaderPolicy),
|
|
529
|
+
assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
|
|
530
|
+
/** How long the ASSERTION is valid — minutes, not hours; it is consumed once at the token endpoint. */
|
|
531
|
+
assertionLifetimeSeconds: z.number().int().min(30).max(600),
|
|
532
|
+
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
533
|
+
}),
|
|
534
|
+
|
|
535
|
+
z.strictObject({
|
|
536
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER).systemEnum('SystemOfRecordCredentialKind'),
|
|
537
|
+
assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
|
|
538
|
+
assertionLifetimeSeconds: z.number().int().min(30).max(600),
|
|
539
|
+
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
540
|
+
}),
|
|
541
|
+
]);
|
|
542
|
+
export type SystemOfRecordCredentialOffer = z.infer<typeof SystemOfRecordCredentialOfferSchema>;
|
|
543
|
+
|
|
544
|
+
/**
|
|
545
|
+
* How a vendor's OData service pages a COLLECTION READ (#1292).
|
|
546
|
+
*
|
|
547
|
+
* A vendor property rather than a dialect constant, and the reason is one large implementation: the
|
|
548
|
+
* Microsoft Dataverse Web API refuses `$skip` outright, while OData v4 defines it and a conformant
|
|
549
|
+
* service serves it. A per-dialect default would have to be wrong for one of them — the same
|
|
550
|
+
* argument #1056 R3 settled for the token-lifetime fallback.
|
|
551
|
+
*
|
|
552
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §11.2.6 ("$top and $skip") for the default; Microsoft
|
|
553
|
+
* Learn, "Query data using the Web API"
|
|
554
|
+
* (https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query-data-web-api) for
|
|
555
|
+
* the refusal — that page enumerates the query options the Web API does not support.
|
|
556
|
+
*/
|
|
557
|
+
export enum SystemOfRecordODataListPaging {
|
|
558
|
+
/**
|
|
559
|
+
* `$top` + `$skip` — one request for any page, which is what a page-numbered contract wants, unless the
|
|
560
|
+
* service serves fewer rows than `$top` and hands back a continuation: the page is then read to its end
|
|
561
|
+
* along the continuation (#1998), so the next page's `$skip` does not jump the rows the service held back.
|
|
562
|
+
*
|
|
563
|
+
* The default, because it is what OData v4 defines and what an uncatalogued service serves.
|
|
564
|
+
*/
|
|
565
|
+
SKIP = 'skip',
|
|
566
|
+
/**
|
|
567
|
+
* `@odata.nextLink` only: the service hands back a continuation URL and refuses to be addressed by
|
|
568
|
+
* offset.
|
|
569
|
+
*
|
|
570
|
+
* The consequence is structural rather than a detail — a cursor has no page NUMBER, so reaching a page
|
|
571
|
+
* costs one request per page before it. The engine asks for the page size with `Prefer:
|
|
572
|
+
* odata.maxpagesize` on v4 (v2 has no such preference, so the service's own size decides) — never with
|
|
573
|
+
* `$top`, which would cap the whole collection (#1991) — walks forward
|
|
574
|
+
* counting ROWS rather than links (the service may serve a page size of its own, #1998), and refuses
|
|
575
|
+
* past a bound rather than pretending otherwise.
|
|
576
|
+
*/
|
|
577
|
+
NEXT_LINK_ONLY = 'next-link-only',
|
|
578
|
+
}
|
|
579
|
+
|
|
580
|
+
/**
|
|
581
|
+
* HOW a vendor partitions the data one deployment holds (#1058).
|
|
582
|
+
*
|
|
583
|
+
* Inside ONE corporate, a system of record usually holds several partitions — Odoo companies, SAP
|
|
584
|
+
* company codes, Dynamics business units, NetSuite subsidiaries. They are not tenants: they all
|
|
585
|
+
* belong to the operator, which is why they map onto ORGANIZATION UNITS of the owner organization
|
|
586
|
+
* rather than onto organizations (#1049 Q3).
|
|
587
|
+
*/
|
|
588
|
+
export enum SystemOfRecordPartitionKind {
|
|
589
|
+
/**
|
|
590
|
+
* A FIELD on every row carries the partition (Odoo `company_id`, NetSuite `subsidiary`). The only
|
|
591
|
+
* kind supported today: it is filterable, so the confinement can be PUSHED DOWN and a caller never
|
|
592
|
+
* receives rows of a partition they may not see.
|
|
593
|
+
*/
|
|
594
|
+
FIELD = 'field',
|
|
595
|
+
/**
|
|
596
|
+
* The partition is a PATH SEGMENT of the request (Business Central's `/companies({id})/customers`).
|
|
597
|
+
*
|
|
598
|
+
* Declared so a facet can be HONEST about a vendor this engine cannot confine yet, and refused by
|
|
599
|
+
* name where a partition is opted into. A path segment is chosen before the request is built, so it
|
|
600
|
+
* cannot express "these three companies" in one read — the confinement would have to fan out into
|
|
601
|
+
* one request per unit, which is a different mechanism rather than a different predicate.
|
|
602
|
+
*/
|
|
603
|
+
PATH_SEGMENT = 'path-segment',
|
|
604
|
+
}
|
|
605
|
+
|
|
606
|
+
/**
|
|
607
|
+
* The SHAPE a partition value arrives in — the difference between a number and a pair.
|
|
608
|
+
*
|
|
609
|
+
* Odoo answers a many2one as `[id, display_name]`: `company_id: [10, "Acme"]` on a read, and `false`
|
|
610
|
+
* when unset. A reader that took the whole array as the key would match nothing, and one that took
|
|
611
|
+
* `row.company_id` as a scalar would stamp `"10,Acme"`. The shape is declared because the engine
|
|
612
|
+
* cannot tell a pair from a two-element list by looking.
|
|
613
|
+
*
|
|
614
|
+
* spec-cite: Odoo 18.0 developer documentation, "External API" — a many2one is returned as an
|
|
615
|
+
* `[id, display_name]` pair under both *Read records* and *Search and read*.
|
|
616
|
+
*/
|
|
617
|
+
export enum SystemOfRecordPartitionValueShape {
|
|
618
|
+
/** The field holds the key directly (an integer, a GUID, a string). */
|
|
619
|
+
SCALAR = 'scalar',
|
|
620
|
+
/** Odoo's many2one: `[id, label]`, and `false` when unset. The id is the key. */
|
|
621
|
+
MANY2ONE_PAIR = 'many2one-pair',
|
|
622
|
+
}
|
|
623
|
+
|
|
624
|
+
/**
|
|
625
|
+
* What a vendor's partitioning IS — declared by the FACET, opted into by the INSTANCE.
|
|
626
|
+
*
|
|
627
|
+
* The split is the same one every other vendor fact takes: how a vendor partitions is a property of
|
|
628
|
+
* the vendor, and WHETHER this deployment's data is partitioned is a property of the deployment. A
|
|
629
|
+
* single-company Odoo has a `company_id` on every row and nothing to confine.
|
|
630
|
+
*/
|
|
631
|
+
export const SystemOfRecordPartitionSupportSchema = z.strictObject({
|
|
632
|
+
kind: z.enum(SystemOfRecordPartitionKind),
|
|
633
|
+
/** The remote field carrying the partition key (`company_id`, `subsidiary`, `CompanyCode`). */
|
|
634
|
+
remoteField: z.string().min(1).max(120),
|
|
635
|
+
/**
|
|
636
|
+
* How a key is spelled on the wire. Reused from the KEY component vocabulary rather than given its
|
|
637
|
+
* own: a partition key is addressed exactly as a key component is — decoded from an operator's
|
|
638
|
+
* authored string, compiled into a remote predicate — and two vocabularies for one job would drift.
|
|
639
|
+
*/
|
|
640
|
+
codec: z.enum(HttpApiKeyComponentCodec),
|
|
641
|
+
valueShape: z.enum(SystemOfRecordPartitionValueShape),
|
|
642
|
+
});
|
|
643
|
+
export type SystemOfRecordPartitionSupport = z.infer<typeof SystemOfRecordPartitionSupportSchema>;
|
|
644
|
+
|
|
645
|
+
/**
|
|
646
|
+
* A step a vendor requires before it accepts ANY modifying request — a row write or a writing action — beyond the
|
|
647
|
+
* credential every request carries (#1726).
|
|
648
|
+
*
|
|
649
|
+
* Declared by the FACET because it is a fact about the product, and refused at startup by the engine for every step it
|
|
650
|
+
* does not perform (`WRITE_PREREQUISITE_NOT_SUPPORTED`): a write the vendor is known to refuse must not be opened, since
|
|
651
|
+
* it would only surface as a remote `403` at the first request, under a code that names nothing.
|
|
652
|
+
*/
|
|
653
|
+
export enum SystemOfRecordWritePrerequisite {
|
|
654
|
+
/**
|
|
655
|
+
* SAP Gateway's cross-site-request-forgery protection: a modifying request must carry an `X-CSRF-Token` obtained by a
|
|
656
|
+
* prior NON-modifying request sent with `X-CSRF-Token: Fetch`, together with the session cookie that request set.
|
|
657
|
+
* spec-cite: SAP Help Portal, SAP Gateway Foundation — "Cross-Site Request Forgery Protection"
|
|
658
|
+
* (https://help.sap.com/saphelp_gateway20sp12/helpdata/en/e6/cae27d5e8d4996add4067280c8714e/frameset.htm).
|
|
659
|
+
*/
|
|
660
|
+
CSRF_TOKEN_HANDSHAKE = 'csrf-token-handshake',
|
|
661
|
+
}
|
|
662
|
+
|
|
663
|
+
/**
|
|
664
|
+
* The OData v4 control information that carries an entity's ETag in a JSON row (#1726) — the only row version an OData
|
|
665
|
+
* vendor can declare in `rowVersionField`, and the value the OData write dialect sends as `If-Match`.
|
|
666
|
+
*
|
|
667
|
+
* The OData 4.0 spelling. A payload that is not OData-Version 4.0 omits the `odata.` infix (`@etag`); the engine asks
|
|
668
|
+
* for 4.0 on its OData requests (`OData-MaxVersion: 4.0`), so a conformant service answers this spelling. A field MAPPED
|
|
669
|
+
* onto the tag, and a `VERSION_CHECKED` comparison, read this spelling only; the write dialect alone also reads the
|
|
670
|
+
* short form when it derives `If-Match`, which only widens what it can condition on.
|
|
671
|
+
* spec-cite: OData JSON Format Version 4.01 §4.5.10 (Control Information: etag (odata.etag)) and §4.5 ("In requests and
|
|
672
|
+
* responses with an OData-Version header with a value of 4.0 control information names are prefixed with @odata.").
|
|
673
|
+
*/
|
|
674
|
+
export const ODATA_ENTITY_TAG_CONTROL_INFORMATION = '@odata.etag';
|
|
675
|
+
|
|
676
|
+
/**
|
|
677
|
+
* What a vendor is, as a system of record. Parsed rather than trusted because #1057 lets a PACKAGE
|
|
678
|
+
* ship one — a record produced by one package version and read by another.
|
|
679
|
+
*/
|
|
680
|
+
export const SystemOfRecordVendorFacetSchema = z.strictObject({
|
|
681
|
+
/** The vendor's stable identifier, named by an instance's `vendor`. Same charset law as an instance name. */
|
|
682
|
+
vendor: z.string().regex(/^[a-z][a-z0-9-]*$/, 'A vendor id is lower-kebab-case.').max(40),
|
|
683
|
+
/**
|
|
684
|
+
* The dialects this vendor can be READ through. An instance's `dialect` must be one of them, and
|
|
685
|
+
* a binding's `dialect` must equal its instance's — both refused at boot registration, where the
|
|
686
|
+
* declaration and the facet are finally in the same scope.
|
|
687
|
+
*/
|
|
688
|
+
dialects: z.array(z.enum(HttpApiTransportDialect)).min(1),
|
|
689
|
+
/**
|
|
690
|
+
* The vendor's own address slots — non-secret, authored per instance in the infra env config. The
|
|
691
|
+
* base URL is registration-scoped and is never credential material.
|
|
692
|
+
*/
|
|
693
|
+
addressSlots: systemOfRecordSlotListSchema('vendor address'),
|
|
694
|
+
/**
|
|
695
|
+
* The credential kinds this vendor offers, each carrying THIS vendor's policy for it. The instance
|
|
696
|
+
* chooses one kind; a kind no offer names is refused.
|
|
697
|
+
*
|
|
698
|
+
* Reshaped from a bare `credentialKinds: Kind[]` in #1056. A list of kinds could say that a vendor
|
|
699
|
+
* accepts a header-borne API key and could not say WHICH header — so either the operator was asked
|
|
700
|
+
* (a question the vendor already answers, `derive-before-you-ask.md`) or the engine guessed. An
|
|
701
|
+
* offer is the kind and its vendor policy as one indivisible thing.
|
|
702
|
+
*/
|
|
703
|
+
credentialOffers: z.array(SystemOfRecordCredentialOfferSchema).min(1),
|
|
704
|
+
/**
|
|
705
|
+
* How a COLLECTION READ pages against this vendor (#1292). Meaningful only for the OData dialects.
|
|
706
|
+
*
|
|
707
|
+
* OPTIONAL rather than defaulted, and the difference is not cosmetic: `.default()` would make the
|
|
708
|
+
* field REQUIRED on the parsed type, so every facet — Odoo's JSON-RPC included — would have to
|
|
709
|
+
* state an answer to a question about a dialect it does not speak. Absent means "not an OData
|
|
710
|
+
* concern, or the conformant default", and {@link resolveSystemOfRecordODataListPaging} is the one
|
|
711
|
+
* place that turns absence into `SKIP`.
|
|
712
|
+
*/
|
|
713
|
+
odataListPaging: z.enum(SystemOfRecordODataListPaging).optional(),
|
|
714
|
+
/**
|
|
715
|
+
* How this vendor partitions one deployment's data (#1058), when it does.
|
|
716
|
+
*
|
|
717
|
+
* ABSENT means the vendor has no partition concept the engine can confine on — which is a real
|
|
718
|
+
* answer rather than an unfinished one, and the reason an instance opting into `partition` against
|
|
719
|
+
* such a facet is refused by name rather than silently doing nothing.
|
|
720
|
+
*/
|
|
721
|
+
partition: SystemOfRecordPartitionSupportSchema.optional(),
|
|
722
|
+
/**
|
|
723
|
+
* The change-tracking mechanisms this vendor's deployments support, which a pipeline may read
|
|
724
|
+
* incrementally through (#1682). A pipeline declaring `incremental.mode` outside this list is refused
|
|
725
|
+
* at startup, naming the vendor.
|
|
726
|
+
*
|
|
727
|
+
* A VENDOR property rather than a dialect constant: whether a deployment can say what changed is a
|
|
728
|
+
* fact about the product (Odoo's ORM stamps `write_date` on every model that logs access; an OData
|
|
729
|
+
* service may or may not enable change tracking, #1722), not about the wire language.
|
|
730
|
+
*
|
|
731
|
+
* ABSENT means none — a real answer: that vendor's pipelines run full passes only.
|
|
732
|
+
*/
|
|
733
|
+
incrementalExtractionModes: z.array(z.enum(ExternalDataIncrementalExtractionMode)).optional(),
|
|
734
|
+
/**
|
|
735
|
+
* The service-defined OData error codes with which this vendor says a tracked change position has EXPIRED (#1722), for a
|
|
736
|
+
* vendor that answers it with its own code rather than the protocol's `410 Gone` / `404 Not Found`.
|
|
737
|
+
*
|
|
738
|
+
* A delta-link pass whose link the vendor no longer honours starts over with a full pass. The protocol names the status
|
|
739
|
+
* for an expired URL, and the engine recognises it for every vendor; a vendor that answers something else instead
|
|
740
|
+
* states its code here, so the fallback does not depend on guessing which `400` means "too old". Dataverse documents
|
|
741
|
+
* `0x80044352` (`ExpiredVersionStamp`, "Please perform a full sync").
|
|
742
|
+
*
|
|
743
|
+
* ABSENT means the vendor answers the protocol's status, or has no change tracking.
|
|
744
|
+
*/
|
|
745
|
+
odataExpiredChangePositionErrorCodes: z.array(z.string().min(1)).optional(),
|
|
746
|
+
/**
|
|
747
|
+
* The ACTION call shapes this vendor's product supports (#1678) — how a declared action is called on it: Odoo's
|
|
748
|
+
* `execute_kw` on a model method, an OData bound action, an OData unbound action import.
|
|
749
|
+
*
|
|
750
|
+
* A VENDOR property, like `partition`: whether a product exposes callable operations beyond row reads is a fact about
|
|
751
|
+
* the product, and a generic OData service may expose none. A binding declaring an action whose shape its vendor does
|
|
752
|
+
* not list is refused at boot, naming the vendor. ABSENT means none — the vendor is read (and perhaps written) only.
|
|
753
|
+
* Each listed shape must be spoken over one of the facet's own `dialects`.
|
|
754
|
+
*/
|
|
755
|
+
actionCallShapes: z.array(z.enum(SystemOfRecordActionCallShape)).optional(),
|
|
756
|
+
/**
|
|
757
|
+
* The remote field this vendor's product maintains on EVERY row as its version — changed by the product itself on every
|
|
758
|
+
* write, never by a caller (#1724, #1726). Odoo: `write_date`, the ORM's "Last Updated on". An OData v4 vendor that
|
|
759
|
+
* serves entity tags: {@link ODATA_ENTITY_TAG_CONTROL_INFORMATION} (`@odata.etag`), and nothing else.
|
|
760
|
+
*
|
|
761
|
+
* A binding may declare `writeConcurrency: VERSION_CHECKED` only against a vendor that names one, and only with a
|
|
762
|
+
* version field that maps onto it (refused at boot, `WRITE_ROW_VERSION_NOT_SUPPORTED_BY_VENDOR`). The engine then
|
|
763
|
+
* compares the version a caller read with the one it reads just before the write.
|
|
764
|
+
*
|
|
765
|
+
* ## What that comparison is worth depends on the DIALECT, not on this field
|
|
766
|
+
*
|
|
767
|
+
* - **Odoo (best-effort).** Its external API has no conditional write — `write(ids, vals)` applies the values, with no
|
|
768
|
+
* precondition — so the comparison and the write are two separate calls, and a change landing between them is
|
|
769
|
+
* overwritten. The check NARROWS the lost-update window to the gap between two calls; it does not close it.
|
|
770
|
+
* - **OData v4 (atomic).** The OData write dialect sends the version as `If-Match` on the `PATCH` or `DELETE`, and the
|
|
771
|
+
* service itself refuses a mismatch with `412 Precondition Failed` and applies nothing. The engine's comparison
|
|
772
|
+
* before sending is then only a fast refusal; the guarantee is the vendor's.
|
|
773
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §8.2.4 (Header If-Match) — "the service MUST respond with 412
|
|
774
|
+
* Precondition Failed and MUST ensure that no observable change occurs as a result of the request".
|
|
775
|
+
*
|
|
776
|
+
* Declaring it for an OData vendor is also what lets its writes send the row's own entity tag rather than `*`: the
|
|
777
|
+
* write dialect reads `@odata.etag` from the row it reads first, so a row moved (into another partition, say) between
|
|
778
|
+
* that read and the write is refused by the vendor instead of written.
|
|
779
|
+
*
|
|
780
|
+
* A VENDOR property, like `incrementalExtractionModes`: whether a product maintains a per-row version is a fact about the
|
|
781
|
+
* product. ABSENT means none, and a binding against such a vendor states `LAST_WRITER_WINS` instead.
|
|
782
|
+
*/
|
|
783
|
+
rowVersionField: z.string().min(1).max(120).optional(),
|
|
784
|
+
/**
|
|
785
|
+
* What this vendor requires before any modifying request (#1726) — see {@link SystemOfRecordWritePrerequisite}. ABSENT
|
|
786
|
+
* means nothing beyond the credential. A binding opening writes against a vendor listing a step the engine does not
|
|
787
|
+
* perform is refused at startup.
|
|
788
|
+
*/
|
|
789
|
+
writePrerequisites: z.array(z.enum(SystemOfRecordWritePrerequisite)).optional(),
|
|
790
|
+
}).superRefine((facet, context) => {
|
|
791
|
+
/*
|
|
792
|
+
* #1726 — over OData the row version IS the entity tag: it is what `If-Match` carries and what the service compares.
|
|
793
|
+
* A property value (a `modifiedon` column, a `RowVersion` field) is not an ETag, and sending one as `If-Match` would
|
|
794
|
+
* be refused as a mismatch on every write — so an OData vendor names the entity tag or nothing.
|
|
795
|
+
*/
|
|
796
|
+
if (facet.rowVersionField !== undefined && facet.dialects.includes(HttpApiTransportDialect.ODATA)
|
|
797
|
+
&& facet.rowVersionField !== ODATA_ENTITY_TAG_CONTROL_INFORMATION) {
|
|
798
|
+
context.addIssue({
|
|
799
|
+
code: 'custom',
|
|
800
|
+
path: ['rowVersionField'],
|
|
801
|
+
message: `An OData vendor's row version is its entity tag, "${ODATA_ENTITY_TAG_CONTROL_INFORMATION}" — got "${facet.rowVersionField}".`,
|
|
802
|
+
});
|
|
803
|
+
}
|
|
804
|
+
// #1678 — a call shape is spoken over one dialect; listing a shape over a dialect the vendor is not read through would
|
|
805
|
+
// advertise an action no instance of it could ever reach.
|
|
806
|
+
for (const [index, shape] of (facet.actionCallShapes ?? []).entries()) {
|
|
807
|
+
if (!facet.dialects.includes(SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT[shape])) {
|
|
808
|
+
context.addIssue({
|
|
809
|
+
code: 'custom',
|
|
810
|
+
path: ['actionCallShapes', index],
|
|
811
|
+
message: `Action call shape "${shape}" is spoken over ${SYSTEM_OF_RECORD_ACTION_CALL_SHAPE_DIALECT[shape]}, which this vendor's dialects do not list.`,
|
|
812
|
+
});
|
|
813
|
+
}
|
|
814
|
+
}
|
|
815
|
+
// #1722 — an expired-position code is read only by a delta-link pass, so a vendor listing one without that mode states a
|
|
816
|
+
// fact nothing could ever consult.
|
|
817
|
+
if (facet.odataExpiredChangePositionErrorCodes !== undefined
|
|
818
|
+
&& !(facet.incrementalExtractionModes ?? []).includes(ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK)) {
|
|
819
|
+
context.addIssue({
|
|
820
|
+
code: 'custom',
|
|
821
|
+
path: ['odataExpiredChangePositionErrorCodes'],
|
|
822
|
+
message: `An expired change-position code is read only by the "${ExternalDataIncrementalExtractionMode.ODATA_DELTA_LINK}" mode, which this vendor's incrementalExtractionModes do not list.`,
|
|
823
|
+
});
|
|
824
|
+
}
|
|
825
|
+
const seenDialects = new Set<string>();
|
|
826
|
+
for (const [index, dialect] of facet.dialects.entries()) {
|
|
827
|
+
if (seenDialects.has(dialect)) {
|
|
828
|
+
context.addIssue({ code: 'custom', path: ['dialects', index], message: `Duplicate dialects member "${dialect}".` });
|
|
829
|
+
}
|
|
830
|
+
seenDialects.add(dialect);
|
|
831
|
+
}
|
|
832
|
+
|
|
833
|
+
// One vendor may not offer the same kind twice: the instance names a KIND, so two offers of one
|
|
834
|
+
// kind would make the policy the engine reads depend on array order.
|
|
835
|
+
const seenKinds = new Set<string>();
|
|
836
|
+
for (const [index, offer] of facet.credentialOffers.entries()) {
|
|
837
|
+
if (seenKinds.has(offer.kind)) {
|
|
838
|
+
context.addIssue({ code: 'custom', path: ['credentialOffers', index], message: `Duplicate credentialOffers member "${offer.kind}".` });
|
|
839
|
+
}
|
|
840
|
+
seenKinds.add(offer.kind);
|
|
841
|
+
}
|
|
842
|
+
|
|
843
|
+
// A vendor address slug that a kind also declares would make the derived environment variable
|
|
844
|
+
// ambiguous about who owns the value, so the two namespaces are checked against each other here
|
|
845
|
+
// rather than at the instance, where the failure would read as an authoring mistake.
|
|
846
|
+
const vendorSlugs = new Set(facet.addressSlots.map((slot) => slot.slug));
|
|
847
|
+
for (const offer of facet.credentialOffers) {
|
|
848
|
+
for (const slot of SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS[offer.kind].addressSlots) {
|
|
849
|
+
if (vendorSlugs.has(slot.slug)) {
|
|
850
|
+
context.addIssue({
|
|
851
|
+
code: 'custom',
|
|
852
|
+
path: ['addressSlots'],
|
|
853
|
+
message: `Address slot "${slot.slug}" is declared by this vendor AND by credential kind "${offer.kind}" — one slot has one owner.`,
|
|
854
|
+
});
|
|
855
|
+
}
|
|
856
|
+
}
|
|
857
|
+
}
|
|
858
|
+
});
|
|
859
|
+
export type SystemOfRecordVendorFacet = z.infer<typeof SystemOfRecordVendorFacetSchema>;
|
|
860
|
+
|
|
861
|
+
/**
|
|
862
|
+
* The export a package's `./systems-of-record` module presents: a record of facets keyed by vendor id. The
|
|
863
|
+
* backend's facet resolver and `wildo secrets` (which lists the credential slots an instance needs) both read
|
|
864
|
+
* a facet module through this name, so it is declared once, beside the shape it carries.
|
|
865
|
+
*/
|
|
866
|
+
export const SYSTEM_OF_RECORD_FACET_RECORD_EXPORT = 'PROVIDER_CATALOGUE_SYSTEM_OF_RECORD_FACETS';
|
|
867
|
+
|
|
868
|
+
/** The subpath a package exports its facet module under: `<package>/systems-of-record`. */
|
|
869
|
+
export const SYSTEM_OF_RECORD_FACET_MODULE_SUBPATH = '/systems-of-record';
|
|
870
|
+
```
|