@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
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/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 +227 -6
- 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 +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- 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 +125 -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 +177 -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 +213 -7
- 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 +326 -8
- 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 +5 -3
- 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 +21 -14
- 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.map +1 -1
- 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 +63 -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 +179 -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 +67 -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 +76 -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 +10 -5
- 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 +82 -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 +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- 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 +67 -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 +83 -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 +71 -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 +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -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 +88 -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 +97 -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 +156 -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/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 +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- 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 +157 -4
- 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 +172 -4
- 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 +5 -4
- 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 +8 -7
- 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 +22 -3
- 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 +5 -3
- 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 +21 -12
- 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 +192 -27
- 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 +172 -33
- 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 +2 -1
- 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 +6 -2
- 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 +182 -5
- 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 +191 -5
- 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 +2 -1
- 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 +3 -2
- 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 +154 -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 +214 -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.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 +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.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 +6 -2
- 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 +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +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 -3
- 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 +32 -4
- 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 +27 -3
- 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 +2 -2
- 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 +4 -2
- 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 +5 -3
- 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 +18 -4
- 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 +155 -4
- 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 -4
- 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 +6 -5
- 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 +18 -17
- 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 +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -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 +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- 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 +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -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 +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -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 +873 -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 +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- 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 +343 -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 +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -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 +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -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 +42 -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 +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -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 +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -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 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- 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 +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- 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 +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- 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/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 +581 -7
- 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 +155 -0
- 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 +21 -0
- 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-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -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.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- 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 +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -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 +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- 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.models.labelling.sections.md +14 -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.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.app-config.backend-authored.md +1 -2
- 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 +86 -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.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -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 +17 -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.providers.connection-target-credential-resolution.md +200 -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.system-access-service.md +51 -42
- 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.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-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 +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -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.composite-view.authoring.md +64 -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-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.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -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 +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- 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.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 +76 -110
- 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.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -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 +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -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 +111 -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 +122 -4
- 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-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 +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -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.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- 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 +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- 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.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- 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/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -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 +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- 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 +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- 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 +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- 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 +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -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 +10 -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 +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- 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 +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -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 +135 -5
- 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 +369 -111
- 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 +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- 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-design-system/SKILL.md +43 -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 +85 -2
- 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 +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -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 +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -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 +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -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 +58 -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 +316 -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 +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -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 +169 -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 +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -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 +41 -69
- 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 +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -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 +33 -24
- 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-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- 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-component-catalog/SKILL.md +258 -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 +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -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 +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- 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 +174 -21
- 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/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -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/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -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 +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -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 +140 -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/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -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-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- 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-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -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 +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -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 +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -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 +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -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 +859 -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 +124 -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 +457 -15
- 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 +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -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 +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -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 +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -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-schema-authoring/SKILL.md +32 -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/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -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 +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- 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 +74 -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 +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -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/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -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 +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -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 +1 -0
- 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 +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- 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 +3 -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 +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -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 +5335 -1010
- 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/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -0,0 +1,785 @@
|
|
|
1
|
+
# `systemsOfRecord` — the deployments this application reads its own rows out of
|
|
2
|
+
|
|
3
|
+
A **system of record** is somebody else's deployment holding rows your application treats as its own
|
|
4
|
+
— your company's Odoo, your S/4HANA, the Dynamics your operations team lives in. You declare it once,
|
|
5
|
+
by NAME, and resources bind it by that name.
|
|
6
|
+
|
|
7
|
+
Read this when:
|
|
8
|
+
|
|
9
|
+
- a resource's rows live in an ERP, a CRM or a partner system and will stay there;
|
|
10
|
+
- you have two deployments of the same vendor and need both;
|
|
11
|
+
- an integration should act as the APPLICATION rather than as a customer who connected their account;
|
|
12
|
+
- a boot refusal names a system of record, a vendor facet, a dialect or a missing slot.
|
|
13
|
+
|
|
14
|
+
## It is not a provider, and the difference decides where everything goes
|
|
15
|
+
|
|
16
|
+
| | a system of record | a provider |
|
|
17
|
+
|---|---|---|
|
|
18
|
+
| whose deployment | yours | the vendor's |
|
|
19
|
+
| whose credential | your deployment's service key | often a PERSON's, connected by them |
|
|
20
|
+
| chosen how | named by an instance a resource binds | selected through the capability plane |
|
|
21
|
+
| whose rows | your own business rows | the vendor's, reached per operation |
|
|
22
|
+
|
|
23
|
+
Declaring one under `providers` instead would put it into a selection mechanism nothing consults,
|
|
24
|
+
and — the reason that matters — a provider's environment-variable names live in its module, so one
|
|
25
|
+
provider ref can only ever be ONE deployment.
|
|
26
|
+
|
|
27
|
+
## Three places, and only the first is a decision
|
|
28
|
+
|
|
29
|
+
1. **`wildo.saas.config.ts`** declares the instance: its vendor, its dialect, optionally its
|
|
30
|
+
credential kind. Nothing here is an address or a secret.
|
|
31
|
+
2. **`wildo.infra.<env>.config.ts`** says WHERE it is in that environment — or `{ enabled: false }`
|
|
32
|
+
when that environment has no access to it at all, which a developer laptop and a staging with no
|
|
33
|
+
ERP genuinely do not. Silence is NOT that declaration: an instance you declare and this file omits
|
|
34
|
+
is refused, because "no access here" and "somebody forgot" need opposite behaviours.
|
|
35
|
+
3. **`secrets.json`** holds the credential under `systemsOfRecordEnv`, keyed by the DERIVED variable
|
|
36
|
+
name.
|
|
37
|
+
|
|
38
|
+
You never author a variable name. They are derived as `WILDO_SOR_<NAME>__<SLOT>` — so renaming an
|
|
39
|
+
instance renames its variables, and `wildo config sync` reports every slot that went missing.
|
|
40
|
+
|
|
41
|
+
## Rows belong to the organization that owns the application
|
|
42
|
+
|
|
43
|
+
Which is why declaring a system of record requires an organization type carrying `ownsApplication`,
|
|
44
|
+
and why a bound resource must be ORGANIZATIONS-scoped with a `REQUIRES_CONTEXT` primary-scope
|
|
45
|
+
relationship and no foreign key. Rows read out of the system are STAMPED with that organization's id,
|
|
46
|
+
so the engine's ordinary per-row tenant gate decides who may see them — with no exemption, and with
|
|
47
|
+
nothing about your tenants sent to a remote that has never heard of them.
|
|
48
|
+
|
|
49
|
+
## Choosing a vendor: a named facet, or the generic `odata` one
|
|
50
|
+
|
|
51
|
+
Declaring an instance names a VENDOR, and the vendor is what supplies the facet — the record that
|
|
52
|
+
says which dialects the system speaks, which credential kinds its service identity takes, and which
|
|
53
|
+
address slots you must fill. Facets ship in the provider catalogue (`@wildo-ai/providers`), not in
|
|
54
|
+
the engine, which is why a vendor your application does not depend on costs it nothing.
|
|
55
|
+
|
|
56
|
+
**Prefer a named vendor whenever one exists.** A named facet carries the corrections that vendor
|
|
57
|
+
needs — the header its key travels in, the token endpoint's shape, the query options its API refuses
|
|
58
|
+
— and choosing it means you supply values rather than decisions.
|
|
59
|
+
|
|
60
|
+
**`odata` is the generic one**, and it is the answer for the case an internal tool actually meets
|
|
61
|
+
most: your own OData v4 service, a bespoke middleware, an ERP surface nobody catalogued. It names no
|
|
62
|
+
vendor, so it can narrow nothing, and the consequence is the one thing to know before choosing it —
|
|
63
|
+
**it offers four credential kinds and therefore asks you which**, where a named facet with one kind
|
|
64
|
+
asks you nothing at all.
|
|
65
|
+
|
|
66
|
+
A vendor no facet describes is refused at boot, naming it. That refusal cannot tell a misspelling
|
|
67
|
+
from a package you have not installed, so it says both.
|
|
68
|
+
|
|
69
|
+
### Which vendors have a facet today
|
|
70
|
+
|
|
71
|
+
`odata` (generic v4) · `microsoft-dataverse` · `microsoft-dynamics-365-business-central` ·
|
|
72
|
+
`netsuite` · `odoo` · `salesforce` · `sap-s4hana`.
|
|
73
|
+
|
|
74
|
+
Two things a facet can tell you that are worth reading BEFORE you bind a resource to it:
|
|
75
|
+
|
|
76
|
+
**How it pages.** A vendor that pages by CONTINUATION (Dataverse, Salesforce) cannot be addressed by
|
|
77
|
+
page number — page N costs N requests, and the engine refuses past twenty pages rather than walking
|
|
78
|
+
indefinitely. A collection you expect people to page deeply into wants a filter, not a facet.
|
|
79
|
+
|
|
80
|
+
**What it cannot do.** `sap-s4hana` offers HTTP Basic alone, because its preferred client-certificate
|
|
81
|
+
arrangement is a transport credential the engine has no channel for yet. `salesforce` and `netsuite`
|
|
82
|
+
are REST_JSON, which means **no external-data pipelines and no declared `sortFields`** — they are
|
|
83
|
+
read-through only, and a LIST serves the query's own order. None of that is a defect to report; it is
|
|
84
|
+
what those facets say about themselves.
|
|
85
|
+
|
|
86
|
+
## How the engine proves who it is — the credential kinds
|
|
87
|
+
|
|
88
|
+
A system of record spends the APPLICATION's own service identity. There is never a person, never a
|
|
89
|
+
consent screen and never a refresh token: those belong to the connected-accounts lane, which a system
|
|
90
|
+
of record cannot reach.
|
|
91
|
+
|
|
92
|
+
The kind is usually DERIVED. When the vendor's facet offers exactly one, you declare nothing — being
|
|
93
|
+
asked to choose between one option is being asked a question the mechanism already holds the answer
|
|
94
|
+
to. You name a kind only when your vendor offers several, and boot tells you so by listing them.
|
|
95
|
+
|
|
96
|
+
| kind | what YOU supply | where the credential travels |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| `odoo-api-key-in-args` | `apiKey`, plus the vendor's `database` and `login` | inside the JSON-RPC arguments |
|
|
99
|
+
| `api-key-header` | `apiKey` | a header the VENDOR names — you never choose it |
|
|
100
|
+
| `api-key-query` | `apiKey` | a query parameter the vendor names. Weaker: a URL reaches access logs |
|
|
101
|
+
| `basic` | `username` (address) and `password` (secret) | `Authorization: Basic` |
|
|
102
|
+
| `oauth2-client-credentials-secret` | `clientId`, `tokenUrl`, `clientSecret`, optionally `scope` / `audience` | a minted bearer token |
|
|
103
|
+
| `oauth2-client-credentials-certificate` | the above minus the secret, plus `privateKeyPem` and either `certificateKeyId` or `certificatePem` | a minted bearer token, obtained with a signed assertion |
|
|
104
|
+
| `oauth2-jwt-bearer` | `clientId`, `tokenUrl`, `subject`, `privateKeyPem` | a minted bearer token, obtained with a signed assertion |
|
|
105
|
+
|
|
106
|
+
### Which half goes in which file
|
|
107
|
+
|
|
108
|
+
An **identity** slot is an address — `clientId`, a BASIC `username`, Odoo's `login` — and lives in
|
|
109
|
+
the infra env config, where it is diffable and reviewable. A **proof** slot is a secret and lives in
|
|
110
|
+
`secrets.json`. So a credential's two halves are authored in two files, deliberately and
|
|
111
|
+
consistently: the thing an operator most often needs to check is never the thing that must never be
|
|
112
|
+
printed.
|
|
113
|
+
|
|
114
|
+
A PEM slot always ends in `Pem`, and that is not decoration — the name is what the CI secret
|
|
115
|
+
collector matches to un-escape a multi-line value.
|
|
116
|
+
|
|
117
|
+
### Tokens, and what you do not have to think about
|
|
118
|
+
|
|
119
|
+
For the three OAuth kinds the engine obtains a token on the first read, keeps ONE per instance, and
|
|
120
|
+
re-mints it a minute before it expires. Concurrent first reads share a single mint. A call refused
|
|
121
|
+
with 401 buys exactly one more attempt with a fresh token and then fails — a second 401 means the
|
|
122
|
+
credential itself is wrong, and re-minting cannot fix that.
|
|
123
|
+
|
|
124
|
+
Two backend replicas hold two tokens. Every vendor this was checked against issues a token per
|
|
125
|
+
request rather than invalidating the previous one, so that is ordinary rather than a problem.
|
|
126
|
+
|
|
127
|
+
### Refusals you will meet at BOOT rather than at the first read
|
|
128
|
+
|
|
129
|
+
An encrypted private key (supply an unencrypted one — the secret channel is the protection, and a
|
|
130
|
+
passphrase stored beside the key it protects protects nothing); a certificate outside its validity
|
|
131
|
+
window; a BASIC username containing `:`, which RFC 7617 makes the delimiter, so the credential would
|
|
132
|
+
decode to a different pair than you typed. Each is refused where the material is known, because a
|
|
133
|
+
certificate that expired last week should not first be noticed by one of your users.
|
|
134
|
+
|
|
135
|
+
`wildo config sync` warns thirty days before a certificate expires. That warning is the only thing
|
|
136
|
+
between you and every read of a bound resource failing at once on a morning nobody chose.
|
|
137
|
+
|
|
138
|
+
### The pace
|
|
139
|
+
|
|
140
|
+
An instance may declare `maxRequestsPerMinute`, and every resource bound to it shares that one
|
|
141
|
+
window — because the vendor sees ONE identity per instance however many resources you bind. A
|
|
142
|
+
binding's own `remoteCallSemantics.maxRequestsPerMinute` still applies, as a ceiling UNDER it: that
|
|
143
|
+
is how you stop a pipeline load starving your interactive reads. Declaring neither means no local
|
|
144
|
+
limit, which is the honest default — the framework does not know your contract with the vendor.
|
|
145
|
+
|
|
146
|
+
### mTLS is not available yet
|
|
147
|
+
|
|
148
|
+
A client certificate as the TRANSPORT credential (as opposed to as an assertion signer, above) needs
|
|
149
|
+
the outbound request seam widened and is tracked separately. A vendor that accepts nothing else
|
|
150
|
+
cannot be declared a system of record today, and the refusal says so by name rather than failing at
|
|
151
|
+
the first read.
|
|
152
|
+
|
|
153
|
+
## Import Origins
|
|
154
|
+
|
|
155
|
+
- `@wildo-ai/saas-models`
|
|
156
|
+
|
|
157
|
+
## Source Excerpts
|
|
158
|
+
|
|
159
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
160
|
+
|
|
161
|
+
```typescript
|
|
162
|
+
/**
|
|
163
|
+
* The charset law for an instance name, exported because the environment-variable derivation and
|
|
164
|
+
* every tool that parses a derived name back into a `(name, slot)` pair depend on it: a name may
|
|
165
|
+
* not contain `_`, so the `__` delimiter is unambiguous (#1055 R4).
|
|
166
|
+
*/
|
|
167
|
+
export const SYSTEM_OF_RECORD_NAME_PATTERN = /^[a-z][a-z0-9-]*$/;
|
|
168
|
+
|
|
169
|
+
/** 32 characters, because the name is a stem of an environment-variable name rather than a label. */
|
|
170
|
+
export const SYSTEM_OF_RECORD_NAME_MAX_LENGTH = 32;
|
|
171
|
+
|
|
172
|
+
export const SystemOfRecordNameSchema = z
|
|
173
|
+
.string()
|
|
174
|
+
.regex(SYSTEM_OF_RECORD_NAME_PATTERN, 'A system-of-record name is lower-kebab-case, starting with a letter.')
|
|
175
|
+
.max(SYSTEM_OF_RECORD_NAME_MAX_LENGTH);
|
|
176
|
+
|
|
177
|
+
/** ONE declared instance. */
|
|
178
|
+
export const SystemOfRecordDeclarationSchema = z.strictObject({
|
|
179
|
+
/**
|
|
180
|
+
* Which vendor this is an instance of — the `vendor` of a facet the deployment ships (engine-shipped
|
|
181
|
+
* today, package-shipped once #1057 lands). Refused at boot when no facet answers to it, rather
|
|
182
|
+
* than here, because the facet map is not in scope in `wildo.saas.config.ts`.
|
|
183
|
+
*/
|
|
184
|
+
vendor: z.string().regex(/^[a-z][a-z0-9-]*$/, 'A vendor id is lower-kebab-case.').max(40),
|
|
185
|
+
|
|
186
|
+
/**
|
|
187
|
+
* How this instance is READ. Declared per instance rather than taken from the facet because a
|
|
188
|
+
* vendor may speak several dialects — a service reachable over both OData v4 and a bespoke REST
|
|
189
|
+
* surface is one vendor and two ways in. The facet's `dialects` is the closed set this must belong
|
|
190
|
+
* to, checked at boot.
|
|
191
|
+
*/
|
|
192
|
+
dialect: z.enum(HttpApiTransportDialect),
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* How the engine proves who it is.
|
|
196
|
+
*
|
|
197
|
+
* OPTIONAL, and the absence is DERIVED rather than defaulted: when the instance's facet offers
|
|
198
|
+
* exactly one credential kind there is nothing for an author to decide, so the registry takes it;
|
|
199
|
+
* when a facet offers more than one and the instance names none, boot refuses and lists them.
|
|
200
|
+
* The framework derives before it asks: a declaration with one legal value is a question whose
|
|
201
|
+
* answer the mechanism already holds.
|
|
202
|
+
*
|
|
203
|
+
* This stays additive when #1056 widens the catalogue: an instance that omitted the field is
|
|
204
|
+
* refused on the day its facet gains a second kind, which is exactly the day its author acquires a
|
|
205
|
+
* real decision.
|
|
206
|
+
*/
|
|
207
|
+
credential: z.strictObject({ kind: z.enum(SystemOfRecordCredentialKind) }).optional(),
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* The pace this deployment may call the instance at, across EVERY resource bound to it (#1056 §3).
|
|
211
|
+
*
|
|
212
|
+
* Per INSTANCE because that is the unit the vendor accounts for: two resources bound to one
|
|
213
|
+
* Dataverse are one application user to Dataverse, so two independent per-binding budgets would
|
|
214
|
+
* each believe they were within a limit the pair together exceeds.
|
|
215
|
+
*
|
|
216
|
+
* A binding's own `remoteCallSemantics.maxRequestsPerMinute` stays, and becomes a CEILING UNDER
|
|
217
|
+
* this one: it answers a different question — how much of the shared allowance may ONE resource
|
|
218
|
+
* take — which matters when a pipeline load and an interactive read share an instance. Both are
|
|
219
|
+
* consumed for every call, and a call proceeds only if both have room.
|
|
220
|
+
*
|
|
221
|
+
* Omitted means unlimited HERE, which is the honest default: the framework does not know the
|
|
222
|
+
* vendor's contract, and inventing a number would either throttle a deployment that paid for more
|
|
223
|
+
* or fail to protect one that has less.
|
|
224
|
+
*/
|
|
225
|
+
maxRequestsPerMinute: z.number().int().min(1).max(600_000).optional(),
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* Whether THIS deployment's data is partitioned, and its rows therefore confined to organization
|
|
229
|
+
* units of the owner organization (#1058).
|
|
230
|
+
*
|
|
231
|
+
* ## The reservation this replaces
|
|
232
|
+
*
|
|
233
|
+
* #1055 declared this field `z.never()` and refused it by name, because accepting a declaration the
|
|
234
|
+
* mechanism could not honour would let an author believe their rows were narrowed while every
|
|
235
|
+
* member still saw every row. That refusal did its job and is now lifted.
|
|
236
|
+
*
|
|
237
|
+
* ## Why the VENDOR says how and the INSTANCE says whether
|
|
238
|
+
*
|
|
239
|
+
* How a vendor partitions — which field, what shape, what codec — is a property of the vendor and
|
|
240
|
+
* lives on its facet. Whether a given deployment's data is partitioned is a property of the
|
|
241
|
+
* deployment: a single-company Odoo has a `company_id` on every row and nothing to confine, and
|
|
242
|
+
* asking its operator to restate the field name would be asking a question the facet answers.
|
|
243
|
+
*
|
|
244
|
+
* Opting in against a facet that declares no partitioning is refused at boot, naming the vendor —
|
|
245
|
+
* the alternative is a `true` that does nothing, which is the shape the reservation existed to
|
|
246
|
+
* prevent in the first place.
|
|
247
|
+
*/
|
|
248
|
+
partition: z.boolean().optional(),
|
|
249
|
+
});
|
|
250
|
+
export type SystemOfRecordDeclaration = z.infer<typeof SystemOfRecordDeclarationSchema>;
|
|
251
|
+
|
|
252
|
+
/**
|
|
253
|
+
* Every instance this application declares, keyed by name.
|
|
254
|
+
*
|
|
255
|
+
* Optional as a whole: an application that reads nothing out of another system declares nothing, and
|
|
256
|
+
* declaring this block is what ENABLES the external-data lane (#1055 D3) rather than an engine
|
|
257
|
+
* capability flag — the lane has no meaning without an instance to point at.
|
|
258
|
+
*/
|
|
259
|
+
export const SystemsOfRecordConfigSchema = z
|
|
260
|
+
.record(SystemOfRecordNameSchema, SystemOfRecordDeclarationSchema)
|
|
261
|
+
.superRefine((systemsOfRecord, ctx) => {
|
|
262
|
+
if (Object.keys(systemsOfRecord).length === 0) {
|
|
263
|
+
ctx.addIssue({
|
|
264
|
+
code: 'custom',
|
|
265
|
+
path: [],
|
|
266
|
+
message:
|
|
267
|
+
'An empty `systemsOfRecord` declares nothing and enables nothing. Omit the block entirely, or declare the '
|
|
268
|
+
+ 'instance the application reads.',
|
|
269
|
+
});
|
|
270
|
+
}
|
|
271
|
+
});
|
|
272
|
+
export type SystemsOfRecordConfig = z.infer<typeof SystemsOfRecordConfigSchema>;
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
276
|
+
|
|
277
|
+
```typescript
|
|
278
|
+
/**
|
|
279
|
+
* One input an instance must supply — an address slot (non-secret, authored in the infra env
|
|
280
|
+
* config) or a secret slot (authored in `secrets.json`). Both halves share this shape because both
|
|
281
|
+
* derive an environment-variable name the same way; what differs is WHERE the value is authored and
|
|
282
|
+
* whether it is ever printed.
|
|
283
|
+
*/
|
|
284
|
+
export const SystemOfRecordSlotSchema = z.strictObject({
|
|
285
|
+
/**
|
|
286
|
+
* lowerCamelCase, and nothing else — see the module header. Becomes the `<SLOT>` half of
|
|
287
|
+
* `WILDO_SOR_<NAME>__<SLOT>` by upper-snake-casing.
|
|
288
|
+
*/
|
|
289
|
+
slug: z
|
|
290
|
+
.string()
|
|
291
|
+
.regex(SYSTEM_OF_RECORD_SLOT_SLUG_PATTERN, 'A slot slug is lowerCamelCase with no separators.')
|
|
292
|
+
.max(40)
|
|
293
|
+
.refine((slug) => slug !== SYSTEM_OF_RECORD_ENABLED_SLOT, {
|
|
294
|
+
error:
|
|
295
|
+
`"${SYSTEM_OF_RECORD_ENABLED_SLOT}" is reserved: the environment builder emits `
|
|
296
|
+
+ `${deriveSystemOfRecordEnabledEnvVarName('example')} itself to say an environment has no access to an instance. `
|
|
297
|
+
+ 'A slot of that name would make "declared absent" indistinguishable from an address whose value happens to be false.',
|
|
298
|
+
}),
|
|
299
|
+
/**
|
|
300
|
+
* Whether an instance MUST supply it. A missing required slot refuses at `wildo config sync` and
|
|
301
|
+
* again at boot (#1055 E4) — the remedy is authoring a value, which needs no running companion,
|
|
302
|
+
* so refusing is legitimate there.
|
|
303
|
+
*/
|
|
304
|
+
required: z.boolean(),
|
|
305
|
+
/** What an operator must put in it. Printed by sync and by the secrets report. */
|
|
306
|
+
description: z.string().min(1),
|
|
307
|
+
});
|
|
308
|
+
export type SystemOfRecordSlot = z.infer<typeof SystemOfRecordSlotSchema>;
|
|
309
|
+
|
|
310
|
+
/**
|
|
311
|
+
* A slot list that cannot be order-dependent or ambiguous: sorted by slug, slugs unique.
|
|
312
|
+
*
|
|
313
|
+
* Mirrors `ProviderSecretContractShapeSchema`, and for the same reason — these lists are compared,
|
|
314
|
+
* reported and (once #1057 lands) contributed by independently-versioned packages, so two facets
|
|
315
|
+
* declaring the same slots in different orders must not be two different things.
|
|
316
|
+
*/
|
|
317
|
+
const systemOfRecordSlotListSchema = (label: string) =>
|
|
318
|
+
z.array(SystemOfRecordSlotSchema).superRefine((slots, context) => {
|
|
319
|
+
const seen = new Set<string>();
|
|
320
|
+
for (const [index, slot] of slots.entries()) {
|
|
321
|
+
if (seen.has(slot.slug)) {
|
|
322
|
+
context.addIssue({ code: 'custom', path: [index, 'slug'], message: `Duplicate ${label} slot "${slot.slug}".` });
|
|
323
|
+
}
|
|
324
|
+
seen.add(slot.slug);
|
|
325
|
+
if (index > 0 && slots[index - 1]!.slug.localeCompare(slot.slug) >= 0) {
|
|
326
|
+
context.addIssue({ code: 'custom', path: [index, 'slug'], message: `${label} slots must be sorted by slug.` });
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
});
|
|
330
|
+
|
|
331
|
+
/**
|
|
332
|
+
* What ONE credential kind needs, independent of vendor (#1055 R15).
|
|
333
|
+
*
|
|
334
|
+
* The kind owns its secrets and any address slot that exists only because the kind was chosen — a
|
|
335
|
+
* future `OAUTH2_CLIENT_CREDENTIALS` owns `tokenUrl`, which no vendor would declare if it were
|
|
336
|
+
* reached with a static key. `ODOO_API_KEY_IN_ARGS` needs no address slot of its own, and that is
|
|
337
|
+
* the seam rather than an omission: its `database` and `login` inputs identify WHICH Odoo and WHICH
|
|
338
|
+
* user, so they belong to the vendor and would survive a second Odoo credential kind.
|
|
339
|
+
*/
|
|
340
|
+
export const SystemOfRecordCredentialKindContractSchema = z.strictObject({
|
|
341
|
+
addressSlots: systemOfRecordSlotListSchema('credential address'),
|
|
342
|
+
secretSlots: systemOfRecordSlotListSchema('credential secret'),
|
|
343
|
+
});
|
|
344
|
+
export type SystemOfRecordCredentialKindContract = z.infer<typeof SystemOfRecordCredentialKindContractSchema>;
|
|
345
|
+
|
|
346
|
+
/**
|
|
347
|
+
* Every credential kind's inputs. Engine-owned and CLOSED, keyed by the enum so a member added
|
|
348
|
+
* without a contract is a compile error rather than a boot surprise.
|
|
349
|
+
*
|
|
350
|
+
* ## Which half a slot lands in, since the answer is not "is it secret"
|
|
351
|
+
*
|
|
352
|
+
* The split follows the precedent #1055 set with Odoo's `login`: **an identity slot is an ADDRESS
|
|
353
|
+
* slot and a proof slot is a SECRET slot.** A `clientId` and a BASIC `username` are not
|
|
354
|
+
* confidential — they name WHICH client and WHICH user — and putting them in `secrets.json` would
|
|
355
|
+
* hide, from every diff and every environment review, the one thing an operator most often needs to
|
|
356
|
+
* check. What must never be printed is the half that PROVES the identity.
|
|
357
|
+
*
|
|
358
|
+
* The consequence is that a credential's two halves are authored in two files. That is deliberate
|
|
359
|
+
* and it is the same shape Odoo already has (`login` in the infra config, `apiKey` in the secrets),
|
|
360
|
+
* so an operator meets one convention rather than two.
|
|
361
|
+
*
|
|
362
|
+
* ## Required-ness that a static list cannot express
|
|
363
|
+
*
|
|
364
|
+
* Three slots are declared `required: false` here and are made required by the FACET's offer, which
|
|
365
|
+
* is the only place that knows: `certificateKeyId` when the vendor's assertion header policy is
|
|
366
|
+
* {@link SystemOfRecordAssertionHeaderPolicy.KEY_ID_SUPPLIED}, `certificatePem` when it is
|
|
367
|
+
* `X509_THUMBPRINT_DERIVED`, and `subject` for the JWT-bearer grant's `sub`. The join is performed
|
|
368
|
+
* ONCE, in {@link resolveSystemOfRecordInstanceSlots}, rather than by each of the five readers of
|
|
369
|
+
* "what does this instance need" — which is the enumeration failure
|
|
370
|
+
* `invariant-call-site-enumeration.md` exists to stop.
|
|
371
|
+
*/
|
|
372
|
+
export const SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS: Readonly<Record<SystemOfRecordCredentialKind, SystemOfRecordCredentialKindContract>> = {
|
|
373
|
+
[SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS]: {
|
|
374
|
+
addressSlots: [],
|
|
375
|
+
secretSlots: [
|
|
376
|
+
{
|
|
377
|
+
slug: 'apiKey',
|
|
378
|
+
required: true,
|
|
379
|
+
description:
|
|
380
|
+
'Odoo external-API key (Settings → Users → API Keys). It replaces the password in '
|
|
381
|
+
+ '`common.authenticate` and rides as a positional argument of every `execute_kw` call.',
|
|
382
|
+
},
|
|
383
|
+
],
|
|
384
|
+
},
|
|
385
|
+
|
|
386
|
+
[SystemOfRecordCredentialKind.API_KEY_HEADER]: {
|
|
387
|
+
addressSlots: [],
|
|
388
|
+
secretSlots: [
|
|
389
|
+
{
|
|
390
|
+
slug: 'apiKey',
|
|
391
|
+
required: true,
|
|
392
|
+
description:
|
|
393
|
+
'The static key this deployment presents. It travels in the header the vendor facet names — '
|
|
394
|
+
+ 'the operator never chooses the header, only supplies the key.',
|
|
395
|
+
},
|
|
396
|
+
],
|
|
397
|
+
},
|
|
398
|
+
|
|
399
|
+
[SystemOfRecordCredentialKind.API_KEY_QUERY]: {
|
|
400
|
+
addressSlots: [],
|
|
401
|
+
secretSlots: [
|
|
402
|
+
{
|
|
403
|
+
slug: 'apiKey',
|
|
404
|
+
required: true,
|
|
405
|
+
description:
|
|
406
|
+
'The static key this deployment presents, appended as the query parameter the vendor facet '
|
|
407
|
+
+ 'names. Weaker than a header — a URL reaches access logs and proxy logs — so prefer a '
|
|
408
|
+
+ 'header kind when the vendor offers one.',
|
|
409
|
+
},
|
|
410
|
+
],
|
|
411
|
+
},
|
|
412
|
+
|
|
413
|
+
[SystemOfRecordCredentialKind.BASIC]: {
|
|
414
|
+
addressSlots: [
|
|
415
|
+
{
|
|
416
|
+
slug: 'username',
|
|
417
|
+
required: true,
|
|
418
|
+
description:
|
|
419
|
+
'The user this deployment authenticates as (SAP calls it a communication user). It names an '
|
|
420
|
+
+ 'identity rather than proving one, so it is authored in the environment config beside the '
|
|
421
|
+
+ 'base URL. It may not contain ":" — RFC 7617 makes the colon the delimiter.',
|
|
422
|
+
},
|
|
423
|
+
],
|
|
424
|
+
secretSlots: [
|
|
425
|
+
{ slug: 'password', required: true, description: "That user's password. Half of one credential; rotate it with the username only if the vendor requires." },
|
|
426
|
+
],
|
|
427
|
+
},
|
|
428
|
+
|
|
429
|
+
[SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET]: {
|
|
430
|
+
addressSlots: [
|
|
431
|
+
{ 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).' },
|
|
432
|
+
{ slug: 'clientId', required: true, description: 'The registered application (client) id. Names WHICH client, so it is addressing rather than proof.' },
|
|
433
|
+
{ slug: 'scope', required: false, description: 'Space-delimited scopes to request. Omitted when the vendor derives them from the client registration.' },
|
|
434
|
+
{ 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." },
|
|
435
|
+
],
|
|
436
|
+
secretSlots: [
|
|
437
|
+
{ 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.' },
|
|
438
|
+
],
|
|
439
|
+
},
|
|
440
|
+
|
|
441
|
+
[SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE]: {
|
|
442
|
+
addressSlots: [
|
|
443
|
+
{ slug: 'audience', required: false, description: 'The `audience` / `resource` parameter when the vendor requires one.' },
|
|
444
|
+
{
|
|
445
|
+
slug: 'certificateKeyId',
|
|
446
|
+
required: false,
|
|
447
|
+
description:
|
|
448
|
+
'The key id the vendor assigned to this certificate, placed in the assertion\'s protected '
|
|
449
|
+
+ 'header as `kid` (NetSuite issues one at upload). REQUIRED when the vendor facet declares '
|
|
450
|
+
+ 'the key-id header policy; unused otherwise.',
|
|
451
|
+
},
|
|
452
|
+
{
|
|
453
|
+
slug: 'certificatePem',
|
|
454
|
+
required: false,
|
|
455
|
+
description:
|
|
456
|
+
'The PUBLIC certificate in PEM, used to derive the `x5t` thumbprint the assertion header '
|
|
457
|
+
+ 'carries. REQUIRED when the vendor facet declares the thumbprint header policy; unused '
|
|
458
|
+
+ 'otherwise. Public material, so it is an address slot rather than a secret.',
|
|
459
|
+
},
|
|
460
|
+
{ slug: 'clientId', required: true, description: 'The registered application (client) id — the assertion\'s `iss` and `sub`.' },
|
|
461
|
+
{ slug: 'scope', required: false, description: 'Space-delimited scopes to request.' },
|
|
462
|
+
{ slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL, and the assertion's `aud`." },
|
|
463
|
+
],
|
|
464
|
+
secretSlots: [
|
|
465
|
+
{
|
|
466
|
+
slug: 'privateKeyPem',
|
|
467
|
+
required: true,
|
|
468
|
+
description:
|
|
469
|
+
'The UNENCRYPTED PKCS#8 private key, in PEM, that signs the client assertion. An '
|
|
470
|
+
+ 'encrypted key is refused by name: the secret channel is the protection, and a passphrase '
|
|
471
|
+
+ 'stored beside the key it protects protects nothing.',
|
|
472
|
+
},
|
|
473
|
+
],
|
|
474
|
+
},
|
|
475
|
+
|
|
476
|
+
[SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER]: {
|
|
477
|
+
addressSlots: [
|
|
478
|
+
{ slug: 'audience', required: false, description: 'The assertion\'s `aud`, when it differs from the token endpoint (Salesforce wants the login host).' },
|
|
479
|
+
{ slug: 'clientId', required: true, description: 'The connected app\'s consumer key — the assertion\'s `iss`.' },
|
|
480
|
+
{ slug: 'scope', required: false, description: 'Space-delimited scopes to request.' },
|
|
481
|
+
{
|
|
482
|
+
slug: 'subject',
|
|
483
|
+
required: false,
|
|
484
|
+
description:
|
|
485
|
+
'The user the assertion is made FOR — its `sub`. REQUIRED for this grant and declared '
|
|
486
|
+
+ 'optional here only because the facet\'s offer is what asserts it; a service account\'s '
|
|
487
|
+
+ 'username on the vendor side.',
|
|
488
|
+
},
|
|
489
|
+
{ slug: 'tokenUrl', required: true, description: "The token endpoint's absolute URL." },
|
|
490
|
+
],
|
|
491
|
+
secretSlots: [
|
|
492
|
+
{ slug: 'privateKeyPem', required: true, description: 'The UNENCRYPTED PKCS#8 private key, in PEM, that signs the assertion. An encrypted key is refused by name.' },
|
|
493
|
+
],
|
|
494
|
+
},
|
|
495
|
+
};
|
|
496
|
+
|
|
497
|
+
/**
|
|
498
|
+
* How a vendor wants a client assertion's PROTECTED HEADER built (#1056 R2).
|
|
499
|
+
*
|
|
500
|
+
* A generic "sign it with the private key" is rejected by both vendors that want an assertion, and
|
|
501
|
+
* they want DIFFERENT things — which is why this is a facet policy rather than an engine constant.
|
|
502
|
+
*/
|
|
503
|
+
export enum SystemOfRecordAssertionHeaderPolicy {
|
|
504
|
+
/** `kid` carries a key id the VENDOR assigned when the certificate was uploaded (NetSuite). */
|
|
505
|
+
KEY_ID_SUPPLIED = 'key-id-supplied',
|
|
506
|
+
/**
|
|
507
|
+
* `x5t` carries the base64url SHA-1 thumbprint of the certificate, DERIVED by the engine from the
|
|
508
|
+
* supplied `certificatePem` (Microsoft Entra's certificate credential).
|
|
509
|
+
*
|
|
510
|
+
* SHA-1 is not a security choice here: `x5t` is defined as a SHA-1 thumbprint (RFC 7515 §4.1.7)
|
|
511
|
+
* and is an identifier for locating a key, never an integrity proof.
|
|
512
|
+
* spec-cite: RFC 7515 §4.1.7 ("x5t" (X.509 Certificate SHA-1 Thumbprint) Header Parameter).
|
|
513
|
+
*/
|
|
514
|
+
X509_THUMBPRINT_DERIVED = 'x509-thumbprint-derived',
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
/**
|
|
518
|
+
* Where a client's id and secret travel on a client-credentials token request.
|
|
519
|
+
*
|
|
520
|
+
* RFC 6749 §2.3.1 permits BOTH and says a server MUST support the Basic header while it MAY support
|
|
521
|
+
* the body form — and real vendors differ, so the choice cannot be an engine default.
|
|
522
|
+
* spec-cite: RFC 6749 §2.3.1 (Client Password).
|
|
523
|
+
*/
|
|
524
|
+
export enum SystemOfRecordClientAuthenticationPlacement {
|
|
525
|
+
/** `client_id` and `client_secret` as form fields in the request body. */
|
|
526
|
+
REQUEST_BODY = 'request-body',
|
|
527
|
+
/** `Authorization: Basic base64(client_id ":" client_secret)`. */
|
|
528
|
+
BASIC_HEADER = 'basic-header',
|
|
529
|
+
}
|
|
530
|
+
|
|
531
|
+
/**
|
|
532
|
+
* The algorithms an assertion may be signed with. Asymmetric ONLY, and that is the point: a
|
|
533
|
+
* symmetric `HS*` assertion is signed with a shared secret, which makes the assertion no stronger
|
|
534
|
+
* than the secret it was supposed to replace, and `none` is not an algorithm.
|
|
535
|
+
*/
|
|
536
|
+
export enum SystemOfRecordAssertionSigningAlgorithm {
|
|
537
|
+
RS256 = 'RS256',
|
|
538
|
+
RS384 = 'RS384',
|
|
539
|
+
RS512 = 'RS512',
|
|
540
|
+
PS256 = 'PS256',
|
|
541
|
+
ES256 = 'ES256',
|
|
542
|
+
ES384 = 'ES384',
|
|
543
|
+
ES512 = 'ES512',
|
|
544
|
+
}
|
|
545
|
+
|
|
546
|
+
/**
|
|
547
|
+
* How long to treat a token as valid when the answer carries no `expires_in` (#1056 R3).
|
|
548
|
+
*
|
|
549
|
+
* A FACET property rather than a per-kind engine constant, because two vendors of the SAME kind
|
|
550
|
+
* disagree: NetSuite's answer states `expires_in` is always 3600, while Salesforce's
|
|
551
|
+
* client-credentials answer is reported to omit it. A per-kind constant would have to be wrong for
|
|
552
|
+
* one of them.
|
|
553
|
+
*/
|
|
554
|
+
const tokenLifetimeFallbackSecondsSchema = z.number().int().min(30).max(86_400);
|
|
555
|
+
|
|
556
|
+
/**
|
|
557
|
+
* ONE credential kind as ONE vendor offers it — the kind, plus everything about it that varies by
|
|
558
|
+
* VENDOR and not by deployment.
|
|
559
|
+
*
|
|
560
|
+
* A discriminated union rather than a kind list beside a policy map, so a policy cannot exist
|
|
561
|
+
* without its kind and a kind cannot be offered without the policy it needs. `API_KEY_HEADER` with
|
|
562
|
+
* no header name is unrepresentable here; under a parallel map it would parse and fail at the first
|
|
563
|
+
* read.
|
|
564
|
+
*/
|
|
565
|
+
export const SystemOfRecordCredentialOfferSchema = z.discriminatedUnion('kind', [
|
|
566
|
+
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.ODOO_API_KEY_IN_ARGS).systemEnum('SystemOfRecordCredentialKind') }),
|
|
567
|
+
|
|
568
|
+
z.strictObject({
|
|
569
|
+
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_HEADER).systemEnum('SystemOfRecordCredentialKind'),
|
|
570
|
+
/** The header the key travels in — `Authorization`, `X-API-Key`, `apikey`, whatever the vendor reads. */
|
|
571
|
+
headerName: z.string().regex(/^[A-Za-z0-9!#$%&'*+.^_`|~-]+$/, 'A header name is an RFC 9110 token.').max(64),
|
|
572
|
+
/** What precedes the key in the header value, INCLUDING its trailing space (`"Bearer "`). Omitted when the key stands alone. */
|
|
573
|
+
valuePrefix: z.string().max(32).optional(),
|
|
574
|
+
}),
|
|
575
|
+
|
|
576
|
+
z.strictObject({
|
|
577
|
+
kind: z.literal(SystemOfRecordCredentialKind.API_KEY_QUERY).systemEnum('SystemOfRecordCredentialKind'),
|
|
578
|
+
/** The query parameter the key is appended as. */
|
|
579
|
+
parameterName: z.string().regex(/^[A-Za-z0-9_.-]+$/, 'A query parameter name is alphanumeric with -._').max(64),
|
|
580
|
+
}),
|
|
581
|
+
|
|
582
|
+
z.strictObject({ kind: z.literal(SystemOfRecordCredentialKind.BASIC).systemEnum('SystemOfRecordCredentialKind') }),
|
|
583
|
+
|
|
584
|
+
z.strictObject({
|
|
585
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_SECRET).systemEnum('SystemOfRecordCredentialKind'),
|
|
586
|
+
clientAuthentication: z.enum(SystemOfRecordClientAuthenticationPlacement),
|
|
587
|
+
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
588
|
+
}),
|
|
589
|
+
|
|
590
|
+
z.strictObject({
|
|
591
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_CLIENT_CREDENTIALS_CERTIFICATE).systemEnum('SystemOfRecordCredentialKind'),
|
|
592
|
+
assertionHeaderPolicy: z.enum(SystemOfRecordAssertionHeaderPolicy),
|
|
593
|
+
assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
|
|
594
|
+
/** How long the ASSERTION is valid — minutes, not hours; it is consumed once at the token endpoint. */
|
|
595
|
+
assertionLifetimeSeconds: z.number().int().min(30).max(600),
|
|
596
|
+
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
597
|
+
}),
|
|
598
|
+
|
|
599
|
+
z.strictObject({
|
|
600
|
+
kind: z.literal(SystemOfRecordCredentialKind.OAUTH2_JWT_BEARER).systemEnum('SystemOfRecordCredentialKind'),
|
|
601
|
+
assertionSigningAlgorithm: z.enum(SystemOfRecordAssertionSigningAlgorithm),
|
|
602
|
+
assertionLifetimeSeconds: z.number().int().min(30).max(600),
|
|
603
|
+
tokenLifetimeFallbackSeconds: tokenLifetimeFallbackSecondsSchema,
|
|
604
|
+
}),
|
|
605
|
+
]);
|
|
606
|
+
export type SystemOfRecordCredentialOffer = z.infer<typeof SystemOfRecordCredentialOfferSchema>;
|
|
607
|
+
|
|
608
|
+
/**
|
|
609
|
+
* How a vendor's OData service pages a COLLECTION READ (#1292).
|
|
610
|
+
*
|
|
611
|
+
* A vendor property rather than a dialect constant, and the reason is one large implementation: the
|
|
612
|
+
* Microsoft Dataverse Web API refuses `$skip` outright, while OData v4 defines it and a conformant
|
|
613
|
+
* service serves it. A per-dialect default would have to be wrong for one of them — the same
|
|
614
|
+
* argument #1056 R3 settled for the token-lifetime fallback.
|
|
615
|
+
*
|
|
616
|
+
* spec-cite: OData Version 4.01 Part 1: Protocol §11.2.6 ("$top and $skip") for the default; Microsoft
|
|
617
|
+
* Learn, "Query data using the Web API"
|
|
618
|
+
* (https://learn.microsoft.com/en-us/power-apps/developer/data-platform/webapi/query-data-web-api) for
|
|
619
|
+
* the refusal — that page enumerates the query options the Web API does not support.
|
|
620
|
+
*/
|
|
621
|
+
export enum SystemOfRecordODataListPaging {
|
|
622
|
+
/**
|
|
623
|
+
* `$top` + `$skip` — one request for any page, which is what a page-numbered contract wants.
|
|
624
|
+
*
|
|
625
|
+
* The default, because it is what OData v4 defines and what an uncatalogued service serves.
|
|
626
|
+
*/
|
|
627
|
+
SKIP = 'skip',
|
|
628
|
+
/**
|
|
629
|
+
* `@odata.nextLink` only: the service hands back a continuation URL and refuses to be addressed by
|
|
630
|
+
* offset.
|
|
631
|
+
*
|
|
632
|
+
* The consequence is structural rather than a detail — a cursor has no page NUMBER, so page N costs
|
|
633
|
+
* N requests. The engine walks forward and refuses past a bound rather than pretending otherwise.
|
|
634
|
+
*/
|
|
635
|
+
NEXT_LINK_ONLY = 'next-link-only',
|
|
636
|
+
}
|
|
637
|
+
|
|
638
|
+
/**
|
|
639
|
+
* HOW a vendor partitions the data one deployment holds (#1058).
|
|
640
|
+
*
|
|
641
|
+
* Inside ONE corporate, a system of record usually holds several partitions — Odoo companies, SAP
|
|
642
|
+
* company codes, Dynamics business units, NetSuite subsidiaries. They are not tenants: they all
|
|
643
|
+
* belong to the operator, which is why they map onto ORGANIZATION UNITS of the owner organization
|
|
644
|
+
* rather than onto organizations (#1049 Q3).
|
|
645
|
+
*/
|
|
646
|
+
export enum SystemOfRecordPartitionKind {
|
|
647
|
+
/**
|
|
648
|
+
* A FIELD on every row carries the partition (Odoo `company_id`, NetSuite `subsidiary`). The only
|
|
649
|
+
* kind supported today: it is filterable, so the confinement can be PUSHED DOWN and a caller never
|
|
650
|
+
* receives rows of a partition they may not see.
|
|
651
|
+
*/
|
|
652
|
+
FIELD = 'field',
|
|
653
|
+
/**
|
|
654
|
+
* The partition is a PATH SEGMENT of the request (Business Central's `/companies({id})/customers`).
|
|
655
|
+
*
|
|
656
|
+
* Declared so a facet can be HONEST about a vendor this engine cannot confine yet, and refused by
|
|
657
|
+
* name where a partition is opted into. A path segment is chosen before the request is built, so it
|
|
658
|
+
* cannot express "these three companies" in one read — the confinement would have to fan out into
|
|
659
|
+
* one request per unit, which is a different mechanism rather than a different predicate.
|
|
660
|
+
*/
|
|
661
|
+
PATH_SEGMENT = 'path-segment',
|
|
662
|
+
}
|
|
663
|
+
|
|
664
|
+
/**
|
|
665
|
+
* The SHAPE a partition value arrives in — the difference between a number and a pair.
|
|
666
|
+
*
|
|
667
|
+
* Odoo answers a many2one as `[id, display_name]`: `company_id: [10, "Acme"]` on a read, and `false`
|
|
668
|
+
* when unset. A reader that took the whole array as the key would match nothing, and one that took
|
|
669
|
+
* `row.company_id` as a scalar would stamp `"10,Acme"`. The shape is declared because the engine
|
|
670
|
+
* cannot tell a pair from a two-element list by looking.
|
|
671
|
+
*
|
|
672
|
+
* spec-cite: Odoo 18.0 developer documentation, "External API" — a many2one is returned as an
|
|
673
|
+
* `[id, display_name]` pair under both *Read records* and *Search and read*.
|
|
674
|
+
*/
|
|
675
|
+
export enum SystemOfRecordPartitionValueShape {
|
|
676
|
+
/** The field holds the key directly (an integer, a GUID, a string). */
|
|
677
|
+
SCALAR = 'scalar',
|
|
678
|
+
/** Odoo's many2one: `[id, label]`, and `false` when unset. The id is the key. */
|
|
679
|
+
MANY2ONE_PAIR = 'many2one-pair',
|
|
680
|
+
}
|
|
681
|
+
|
|
682
|
+
/**
|
|
683
|
+
* What a vendor's partitioning IS — declared by the FACET, opted into by the INSTANCE.
|
|
684
|
+
*
|
|
685
|
+
* The split is the same one every other vendor fact takes: how a vendor partitions is a property of
|
|
686
|
+
* the vendor, and WHETHER this deployment's data is partitioned is a property of the deployment. A
|
|
687
|
+
* single-company Odoo has a `company_id` on every row and nothing to confine.
|
|
688
|
+
*/
|
|
689
|
+
export const SystemOfRecordPartitionSupportSchema = z.strictObject({
|
|
690
|
+
kind: z.enum(SystemOfRecordPartitionKind),
|
|
691
|
+
/** The remote field carrying the partition key (`company_id`, `subsidiary`, `CompanyCode`). */
|
|
692
|
+
remoteField: z.string().min(1).max(120),
|
|
693
|
+
/**
|
|
694
|
+
* How a key is spelled on the wire. Reused from the KEY component vocabulary rather than given its
|
|
695
|
+
* own: a partition key is addressed exactly as a key component is — decoded from an operator's
|
|
696
|
+
* authored string, compiled into a remote predicate — and two vocabularies for one job would drift.
|
|
697
|
+
*/
|
|
698
|
+
codec: z.enum(HttpApiKeyComponentCodec),
|
|
699
|
+
valueShape: z.enum(SystemOfRecordPartitionValueShape),
|
|
700
|
+
});
|
|
701
|
+
export type SystemOfRecordPartitionSupport = z.infer<typeof SystemOfRecordPartitionSupportSchema>;
|
|
702
|
+
|
|
703
|
+
/**
|
|
704
|
+
* What a vendor is, as a system of record. Parsed rather than trusted because #1057 lets a PACKAGE
|
|
705
|
+
* ship one — a record produced by one package version and read by another.
|
|
706
|
+
*/
|
|
707
|
+
export const SystemOfRecordVendorFacetSchema = z.strictObject({
|
|
708
|
+
/** The vendor's stable identifier, named by an instance's `vendor`. Same charset law as an instance name. */
|
|
709
|
+
vendor: z.string().regex(/^[a-z][a-z0-9-]*$/, 'A vendor id is lower-kebab-case.').max(40),
|
|
710
|
+
/**
|
|
711
|
+
* The dialects this vendor can be READ through. An instance's `dialect` must be one of them, and
|
|
712
|
+
* a binding's `dialect` must equal its instance's — both refused at boot registration, where the
|
|
713
|
+
* declaration and the facet are finally in the same scope.
|
|
714
|
+
*/
|
|
715
|
+
dialects: z.array(z.enum(HttpApiTransportDialect)).min(1),
|
|
716
|
+
/**
|
|
717
|
+
* The vendor's own address slots — non-secret, authored per instance in the infra env config. The
|
|
718
|
+
* base URL is registration-scoped and is never credential material.
|
|
719
|
+
*/
|
|
720
|
+
addressSlots: systemOfRecordSlotListSchema('vendor address'),
|
|
721
|
+
/**
|
|
722
|
+
* The credential kinds this vendor offers, each carrying THIS vendor's policy for it. The instance
|
|
723
|
+
* chooses one kind; a kind no offer names is refused.
|
|
724
|
+
*
|
|
725
|
+
* Reshaped from a bare `credentialKinds: Kind[]` in #1056. A list of kinds could say that a vendor
|
|
726
|
+
* accepts a header-borne API key and could not say WHICH header — so either the operator was asked
|
|
727
|
+
* (a question the vendor already answers, `derive-before-you-ask.md`) or the engine guessed. An
|
|
728
|
+
* offer is the kind and its vendor policy as one indivisible thing.
|
|
729
|
+
*/
|
|
730
|
+
credentialOffers: z.array(SystemOfRecordCredentialOfferSchema).min(1),
|
|
731
|
+
/**
|
|
732
|
+
* How a COLLECTION READ pages against this vendor (#1292). Meaningful only for the OData dialects.
|
|
733
|
+
*
|
|
734
|
+
* OPTIONAL rather than defaulted, and the difference is not cosmetic: `.default()` would make the
|
|
735
|
+
* field REQUIRED on the parsed type, so every facet — Odoo's JSON-RPC included — would have to
|
|
736
|
+
* state an answer to a question about a dialect it does not speak. Absent means "not an OData
|
|
737
|
+
* concern, or the conformant default", and {@link resolveSystemOfRecordODataListPaging} is the one
|
|
738
|
+
* place that turns absence into `SKIP`.
|
|
739
|
+
*/
|
|
740
|
+
odataListPaging: z.enum(SystemOfRecordODataListPaging).optional(),
|
|
741
|
+
/**
|
|
742
|
+
* How this vendor partitions one deployment's data (#1058), when it does.
|
|
743
|
+
*
|
|
744
|
+
* ABSENT means the vendor has no partition concept the engine can confine on — which is a real
|
|
745
|
+
* answer rather than an unfinished one, and the reason an instance opting into `partition` against
|
|
746
|
+
* such a facet is refused by name rather than silently doing nothing.
|
|
747
|
+
*/
|
|
748
|
+
partition: SystemOfRecordPartitionSupportSchema.optional(),
|
|
749
|
+
}).superRefine((facet, context) => {
|
|
750
|
+
const seenDialects = new Set<string>();
|
|
751
|
+
for (const [index, dialect] of facet.dialects.entries()) {
|
|
752
|
+
if (seenDialects.has(dialect)) {
|
|
753
|
+
context.addIssue({ code: 'custom', path: ['dialects', index], message: `Duplicate dialects member "${dialect}".` });
|
|
754
|
+
}
|
|
755
|
+
seenDialects.add(dialect);
|
|
756
|
+
}
|
|
757
|
+
|
|
758
|
+
// One vendor may not offer the same kind twice: the instance names a KIND, so two offers of one
|
|
759
|
+
// kind would make the policy the engine reads depend on array order.
|
|
760
|
+
const seenKinds = new Set<string>();
|
|
761
|
+
for (const [index, offer] of facet.credentialOffers.entries()) {
|
|
762
|
+
if (seenKinds.has(offer.kind)) {
|
|
763
|
+
context.addIssue({ code: 'custom', path: ['credentialOffers', index], message: `Duplicate credentialOffers member "${offer.kind}".` });
|
|
764
|
+
}
|
|
765
|
+
seenKinds.add(offer.kind);
|
|
766
|
+
}
|
|
767
|
+
|
|
768
|
+
// A vendor address slug that a kind also declares would make the derived environment variable
|
|
769
|
+
// ambiguous about who owns the value, so the two namespaces are checked against each other here
|
|
770
|
+
// rather than at the instance, where the failure would read as an authoring mistake.
|
|
771
|
+
const vendorSlugs = new Set(facet.addressSlots.map((slot) => slot.slug));
|
|
772
|
+
for (const offer of facet.credentialOffers) {
|
|
773
|
+
for (const slot of SYSTEM_OF_RECORD_CREDENTIAL_KIND_CONTRACTS[offer.kind].addressSlots) {
|
|
774
|
+
if (vendorSlugs.has(slot.slug)) {
|
|
775
|
+
context.addIssue({
|
|
776
|
+
code: 'custom',
|
|
777
|
+
path: ['addressSlots'],
|
|
778
|
+
message: `Address slot "${slot.slug}" is declared by this vendor AND by credential kind "${offer.kind}" — one slot has one owner.`,
|
|
779
|
+
});
|
|
780
|
+
}
|
|
781
|
+
}
|
|
782
|
+
}
|
|
783
|
+
});
|
|
784
|
+
export type SystemOfRecordVendorFacet = z.infer<typeof SystemOfRecordVendorFacetSchema>;
|
|
785
|
+
```
|