@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,40 @@
|
|
|
1
|
+
# saas.models.email.template-type
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* ⚠️ **A template's `type` decides WHICH VENDOR ships it.** It is not a label: each member maps to a
|
|
14
|
+
* distinct engine capability, and the sender resolves the provider configured against THAT
|
|
15
|
+
* capability. A newsletter left at the default is dispatched through the transactional vendor, on
|
|
16
|
+
* the transactional reputation and quota, and nothing reports it.
|
|
17
|
+
*
|
|
18
|
+
* Declare it on the file-based `EmailTemplateDefinition<L>.type` slot, or inside the system template
|
|
19
|
+
* registry definition.
|
|
20
|
+
*
|
|
21
|
+
* Setting `MARKETING` therefore requires a vendor declared against the marketing capability and named
|
|
22
|
+
* as its primary — otherwise the send has no provider to resolve. Nothing else in the send path
|
|
23
|
+
* changes.
|
|
24
|
+
*
|
|
25
|
+
* Dispatch class for an email template — maps 1:1 with `EngineCapability`
|
|
26
|
+
* for provider routing inside `EmailBackendService`.
|
|
27
|
+
*
|
|
28
|
+
* Templates declare their dispatch class on the file-based
|
|
29
|
+
* `EmailTemplateDefinition<L>.type?` slot or inside the
|
|
30
|
+
* `SystemEmailTemplateRegistry` definition; the runtime sender uses
|
|
31
|
+
* {@link EmailTemplateType_ToEngineCapability} to resolve which configured
|
|
32
|
+
* provider should ship the message.
|
|
33
|
+
*/
|
|
34
|
+
export enum EmailTemplateType {
|
|
35
|
+
/** Transactional emails — password resets, receipts, notifications. */
|
|
36
|
+
TRANSACTIONAL = EngineCapability.EMAIL_TRANSACTIONAL,
|
|
37
|
+
/** Marketing emails — newsletters, promotions, campaigns. */
|
|
38
|
+
MARKETING = EngineCapability.EMAIL_MARKETING,
|
|
39
|
+
}
|
|
40
|
+
```
|
|
@@ -23,8 +23,32 @@
|
|
|
23
23
|
export enum EngineCapability {
|
|
24
24
|
ORGANIZATIONS = 'ORGANIZATIONS',
|
|
25
25
|
BILLING = 'BILLING',
|
|
26
|
-
BILLING_PAYMENTS = 'BILLING_PAYMENTS',
|
|
27
26
|
MULTI_LANGUAGE = 'MULTI_LANGUAGE',
|
|
27
|
+
/**
|
|
28
|
+
* Durable, provider-backed audit trail: every audit event the application records is ALSO sent to
|
|
29
|
+
* each configured audit provider (an immutable ledger, a SIEM).
|
|
30
|
+
*
|
|
31
|
+
* Whether to enable it is a question of where the trail must live, not of what the application may
|
|
32
|
+
* claim. The assurance surface attests roughly half its control objectives through audit rows, and
|
|
33
|
+
* those rows are read from the application's OWN audit store, which exists whether or not this
|
|
34
|
+
* capability is on. So leaving it out removes no control objective an application can claim. Until
|
|
35
|
+
* 2026-09-14 the assurance basis wrongly treated this capability as the precondition for those
|
|
36
|
+
* claims, and this comment said leaving it out left about a third of them unclaimable.
|
|
37
|
+
*
|
|
38
|
+
* Two things this does NOT mean, because both are easy to assume:
|
|
39
|
+
*
|
|
40
|
+
* - It is not what makes security events happen. Authentication, authorization, privilege and
|
|
41
|
+
* credential events are recorded in the application's own database regardless. What this
|
|
42
|
+
* capability adds is the provider-backed fan-out — the durable, external, tamper-evident
|
|
43
|
+
* destination an assurance reader can be pointed at.
|
|
44
|
+
* - It is not retroactive. Turning it on later starts a trail from that moment; it does not
|
|
45
|
+
* furnish evidence for the period it was off, and a control's evidence cannot begin before its
|
|
46
|
+
* evidence store does.
|
|
47
|
+
*
|
|
48
|
+
* So decide it with the compliance posture rather than as an infrastructure detail: enable it when
|
|
49
|
+
* the trail must also exist OUTSIDE the application — a store its own operators cannot rewrite, or a
|
|
50
|
+
* security team's SIEM. The application's own store stays the authoritative record either way.
|
|
51
|
+
*/
|
|
28
52
|
COMPLIANCE_AUDIT_TRAIL = 'COMPLIANCE_AUDIT_TRAIL',
|
|
29
53
|
|
|
30
54
|
EMAIL_TRANSACTIONAL = 'EMAIL_TRANSACTIONAL',
|
|
@@ -55,11 +79,13 @@ export enum EngineCapability {
|
|
|
55
79
|
* extraction into `AI_LLM` would have made one `selection[AI_LLM].primary` decide all three,
|
|
56
80
|
* which is exactly the defect that split `AI_EMBEDDINGS` out of `AI_LLM`.
|
|
57
81
|
*
|
|
58
|
-
* ## Not to be confused with
|
|
82
|
+
* ## Not to be confused with PDF GENERATION
|
|
59
83
|
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
* unrelated
|
|
84
|
+
* PDF generation — templates and data become bytes — is the `pdfTemplates` surface, done
|
|
85
|
+
* in-process and with no provider slot of its own. This is the opposite direction: bytes become
|
|
86
|
+
* text. The two are unrelated and nothing routes between them. (There WAS an
|
|
87
|
+
* `EngineCapability.DOCUMENT_GENERATION` that this paragraph used to name; it was withdrawn
|
|
88
|
+
* because no provider capability could ever fill it.)
|
|
63
89
|
*
|
|
64
90
|
* ## Absence is benign, and that is load-bearing
|
|
65
91
|
*
|
|
@@ -86,8 +112,60 @@ export enum EngineCapability {
|
|
|
86
112
|
*/
|
|
87
113
|
AI_CODING_AGENT = 'AI_CODING_AGENT',
|
|
88
114
|
|
|
89
|
-
|
|
90
|
-
|
|
115
|
+
/*
|
|
116
|
+
* WITHDRAWN 2026-09-03: `DOCUMENT_GENERATION` and `ANTIVIRUS_SCANNING` were members here and are
|
|
117
|
+
* not any more. Neither could ever be filled — `PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY` had no
|
|
118
|
+
* entry pointing at either, so no provider capability token could claim the slot — while both were
|
|
119
|
+
* classified `SELECT_ONE`, which asserts that exactly one provider must be selected. Selecting one
|
|
120
|
+
* of zero candidates is not a resolution mode.
|
|
121
|
+
*
|
|
122
|
+
* Both capabilities are real and both are delivered elsewhere, which is why withdrawing the slots
|
|
123
|
+
* costs nothing: antivirus scanning is `InfraCapability.ANTIVIRUS_SCANNING`, fulfilled by ClamAV
|
|
124
|
+
* and consumed by `FileScanningBackendService`; PDF generation is the in-process `pdfTemplates`
|
|
125
|
+
* surface, rendered by `@react-pdf/renderer` inside the backend. Neither has an external
|
|
126
|
+
* provider, and neither is planned to.
|
|
127
|
+
*
|
|
128
|
+
* `InfraCapability.DOCUMENT_RENDERING` (Gotenberg) was provisioned beside the PDF surface and
|
|
129
|
+
* consumed by nothing; it was withdrawn on 2026-09-08 (#477) because in-process rendering had
|
|
130
|
+
* superseded it. Note the two are not interchangeable if it is ever reconsidered:
|
|
131
|
+
* `@react-pdf/renderer` composes a document from React primitives, while Gotenberg converts
|
|
132
|
+
* EXISTING HTML and Office documents — that is a different capability, not a second
|
|
133
|
+
* implementation of this one.
|
|
134
|
+
*
|
|
135
|
+
* Removing `ANTIVIRUS_SCANNING` also removes a collision: the identical spelling named an engine
|
|
136
|
+
* slot nothing could fill AND a live infra capability, in two packages, so a reader grepping the
|
|
137
|
+
* word landed in whichever they searched first.
|
|
138
|
+
*
|
|
139
|
+
* If a hosted AV or document-rendering vendor is ever adopted, the member comes back WITH its
|
|
140
|
+
* `PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY` entry and its own JSDoc in the same change.
|
|
141
|
+
*
|
|
142
|
+
* WITHDRAWN 2026-09-09: `BILLING_PAYMENTS`, the third member of exactly that shape, and the one
|
|
143
|
+
* this paragraph's own closing rule should have caught. It was never withdrawn with the other two
|
|
144
|
+
* because it had been left behind DELIBERATELY — as a "reserved slot" — which reads as a decision
|
|
145
|
+
* and is why nobody re-examined it. Measured before removing, across the whole repository outside
|
|
146
|
+
* `node_modules` / `dist`: it appeared in live source at exactly THREE sites, and none of them was
|
|
147
|
+
* a use — the enum declaration itself, its row in the compile-forced
|
|
148
|
+
* `ENGINE_CAPABILITY_RESOLUTION_MODE` record, and a comment in a test naming it as a slot the
|
|
149
|
+
* billing provider must NOT be registered under. Zero applications enabled it, zero scaffolds
|
|
150
|
+
* wrote it, zero consumers queried it, and no provider capability token mapped to it.
|
|
151
|
+
*
|
|
152
|
+
* The capability it names is real and is already delivered: a billing provider (Stripe) declares
|
|
153
|
+
* `BUILTIN_PROVIDER_CAPABILITY.BILLING` and fills `EngineCapability.BILLING`, which is the slot
|
|
154
|
+
* applications enable and `getProvidersForEngineCapability` gates on. Payment EXECUTION is served
|
|
155
|
+
* through that same provider's `BILLING_PROVIDER` protocol; splitting it into a second engine slot
|
|
156
|
+
* was a plan-era intention (`provider-registry-materialization-workflow.md`) that the shipped
|
|
157
|
+
* model settled the other way. So the withdrawal removes a name, not a capability.
|
|
158
|
+
*
|
|
159
|
+
* The reason a reserved slot is worse than no slot is `EngineCapabilityResolutionMode`: every
|
|
160
|
+
* member must be classified, `BILLING_PAYMENTS` was classified `SELECT_ONE`, and `SELECT_ONE`
|
|
161
|
+
* asserts that exactly one provider is selected from the candidates. There were zero candidates
|
|
162
|
+
* and there could never be one. A vocabulary member that no configuration can satisfy is not a
|
|
163
|
+
* reservation, it is a false statement the compiler is forced to carry.
|
|
164
|
+
*
|
|
165
|
+
* If a payments vendor is ever selected independently of the billing vendor, the member comes back
|
|
166
|
+
* with its provider-capability token and its map entry in the same change — the same rule as
|
|
167
|
+
* above, now with three instances behind it.
|
|
168
|
+
*/
|
|
91
169
|
|
|
92
170
|
FRONTEND_ERROR_MONITORING = 'FRONTEND_ERROR_MONITORING',
|
|
93
171
|
FRONTEND_PRODUCT_ANALYTICS = 'FRONTEND_PRODUCT_ANALYTICS',
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# saas.models.engine-capabilities.required-provider-floor
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Engine capabilities that REQUIRE a resolved provider the moment an
|
|
14
|
+
* application ENABLES them — the engine-level MAIN floor (#328).
|
|
15
|
+
*
|
|
16
|
+
* The asymmetry is the thing to carry away: **enabling a capability with nothing serving it fails at
|
|
17
|
+
* BOOT for these three and at the point of USE for every other slot.** So an author who tries one
|
|
18
|
+
* unserved slot, sees the application come up, and concludes that an unserved capability degrades
|
|
19
|
+
* gracefully has learned the wrong rule from the larger half of the vocabulary.
|
|
20
|
+
*
|
|
21
|
+
* `EngineCapabilityActivation.required` is the application's decision;
|
|
22
|
+
* this set is the ENGINE's: for each member, an enabled capability with no
|
|
23
|
+
* provider is not a degraded mode but a boot-time misconfiguration, because
|
|
24
|
+
* an engine flow the application already relies on fails at first use:
|
|
25
|
+
*
|
|
26
|
+
* - `EMAIL_TRANSACTIONAL` — invitations, address verification and password
|
|
27
|
+
* reset are engine flows that send mail; with no provider they fail
|
|
28
|
+
* silently at the moment a user needs them.
|
|
29
|
+
* - `BILLING` — `initializeBillingServices` already fails loud with no
|
|
30
|
+
* provider; the floor names it in the same place as the others.
|
|
31
|
+
* - `SMS` — phone verification and MFA-by-SMS are engine flows.
|
|
32
|
+
*
|
|
33
|
+
* DELIBERATELY ABSENT, with the reason each would need to overturn:
|
|
34
|
+
* - the `AI_*` slots — consumed per feature (an agent, the logo generator)
|
|
35
|
+
* and legitimately served on a DIFFERENT host (the companion reaches image
|
|
36
|
+
* generation; the backend need not), so "enabled with no backend provider"
|
|
37
|
+
* is a normal topology, not a fault. A feature that needs one refuses at
|
|
38
|
+
* its own site.
|
|
39
|
+
* - the sinks (`COMPLIANCE_AUDIT_TRAIL`, `LLM_OBSERVABILITY`,
|
|
40
|
+
* `OBSERVABILITY_TELEMETRY`) — fail-OPEN by design (the G4 reconcile
|
|
41
|
+
* warns), because Layer-1 persistence is unaffected.
|
|
42
|
+
* - `EMAIL_MARKETING` — a campaign feature, not an engine flow.
|
|
43
|
+
* - the `FRONTEND_*` slots — resolved by the frontend facet, invisible to
|
|
44
|
+
* the backend registry that evaluates this floor.
|
|
45
|
+
* - `ORGANIZATIONS` and `MULTI_LANGUAGE` — no provider token maps to them,
|
|
46
|
+
* deliberately and by declaration; see
|
|
47
|
+
* `ENGINE_CAPABILITIES_WITH_NO_PROVIDER_CAPABILITY`. A floor requiring a
|
|
48
|
+
* resolved provider for a slot nothing can fill would refuse every boot that
|
|
49
|
+
* enabled them. (`BILLING_PAYMENTS` was named here too until it was withdrawn
|
|
50
|
+
* from the enum on 2026-09-09.)
|
|
51
|
+
*
|
|
52
|
+
* The floor runs only on a host expected to SERVE these slots (see
|
|
53
|
+
* `ApplicationRuntimeProfileBootAssertions.assertsEngineCapabilityProviderFloor`);
|
|
54
|
+
* a minion's scope-filtered registry legitimately resolves none of them.
|
|
55
|
+
*/
|
|
56
|
+
export const ENGINE_CAPABILITIES_REQUIRING_A_PROVIDER_WHEN_ENABLED: ReadonlySet<EngineCapability> = new Set([
|
|
57
|
+
EngineCapability.EMAIL_TRANSACTIONAL,
|
|
58
|
+
EngineCapability.BILLING,
|
|
59
|
+
EngineCapability.SMS,
|
|
60
|
+
]);
|
|
61
|
+
```
|
|
@@ -110,10 +110,14 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
110
110
|
direction: z.enum(ExternalDataPipelineDirection).default(ExternalDataPipelineDirection.INBOUND),
|
|
111
111
|
|
|
112
112
|
/**
|
|
113
|
-
* The source half — the SAME binding declaration the VIRTUAL mode uses (
|
|
114
|
-
* dialect, key fields + codecs, remote-call semantics, erasure stance
|
|
115
|
-
*
|
|
116
|
-
*
|
|
113
|
+
* The source half — the SAME binding declaration the VIRTUAL mode uses (the system of record it
|
|
114
|
+
* reads, entity, dialect, key fields + codecs, remote-call semantics, erasure stance).
|
|
115
|
+
*
|
|
116
|
+
* Every source is a SYSTEM OF RECORD: a deployment the OPERATOR runs, read with the application's
|
|
117
|
+
* own service identity, with ONE owner organization. There is no per-tenant variant to confine
|
|
118
|
+
* (that was `tenancy`, removed in #1055 — a customer's own connected account is a CONNECTOR, a
|
|
119
|
+
* different thing that no binding names), so a pipeline extracts the operator's rows and the
|
|
120
|
+
* destination's own scope declaration decides who may then read them.
|
|
117
121
|
*
|
|
118
122
|
* ⚠ OPERATIONAL HAZARD (PR-16): changing `keyFields` or a component CODEC after rows exist
|
|
119
123
|
* re-keys EVERY business key — the whole destination population orphans and re-creates on the
|
|
@@ -133,6 +137,41 @@ export const ExternalDataPipelineDeclarationSchema = z.object({
|
|
|
133
137
|
*/
|
|
134
138
|
remoteKeyLocalField: z.string().trim().min(1),
|
|
135
139
|
|
|
140
|
+
/**
|
|
141
|
+
* Where a row's remote PARTITION lands, when the source instance is partitioned (#1058 E4).
|
|
142
|
+
*
|
|
143
|
+
* Declared TOGETHER or not at all, and only for a partitioned source. The resources registry —
|
|
144
|
+
* which is the first place the pipeline declaration and the systems-of-record registry are both
|
|
145
|
+
* in scope — refuses a partitioned source that declares neither, and refuses either field on an
|
|
146
|
+
* unpartitioned one.
|
|
147
|
+
*
|
|
148
|
+
* ## Why TWO fields rather than one
|
|
149
|
+
*
|
|
150
|
+
* They hold different things, and collapsing them is the mistake #1058 R5 was written to record.
|
|
151
|
+
*
|
|
152
|
+
* `partitionUnitLocalField` carries the Wildo ORGANIZATION UNIT that owns the row's partition. It
|
|
153
|
+
* is what organization-unit narrowing filters on, so it is what confines a member of one
|
|
154
|
+
* subsidiary to their own company's rows. Declare the destination narrowable on this field.
|
|
155
|
+
*
|
|
156
|
+
* `partitionKeyLocalField` carries the REMOTE key verbatim — Odoo's `company_id`, NetSuite's
|
|
157
|
+
* `subsidiary`. It exists because the unit id CANNOT answer the question the orphan walk asks.
|
|
158
|
+
* When an operator unassigns a partition, the unit still exists and other rows still point at it;
|
|
159
|
+
* only the partition→unit edge is gone. A row loaded before the unassignment therefore still
|
|
160
|
+
* carries a perfectly valid unit id, and nothing about it says "this row's partition is no longer
|
|
161
|
+
* mapped". Without the remote key stored per row, the next pass sees those rows absent from the
|
|
162
|
+
* extraction and an orphan policy of DELETE erases them — an operator's unassignment becoming a
|
|
163
|
+
* mass delete.
|
|
164
|
+
*
|
|
165
|
+
* Both are ENGINE-WRITTEN: the transform stamps them from the assignment map, so a mapping entry
|
|
166
|
+
* targeting either is refused, as is a caller write (the factory requires both
|
|
167
|
+
* `.excludeFromCreate()` and `.excludeFromUpdate()`).
|
|
168
|
+
*
|
|
169
|
+
* Both must ACCEPT ABSENCE. A row whose partition field is unset is SHARED (E2 — an Odoo product
|
|
170
|
+
* belonging to no company); it belongs to every caller and to no unit, and both fields land null.
|
|
171
|
+
*/
|
|
172
|
+
partitionUnitLocalField: z.string().trim().min(1).optional(),
|
|
173
|
+
partitionKeyLocalField: z.string().trim().min(1).optional(),
|
|
174
|
+
|
|
136
175
|
/** The declared T — at least one entry; targets validated against `mainSchema` by the factory. */
|
|
137
176
|
mapping: z.array(ExternalDataFieldMappingEntrySchema).min(1),
|
|
138
177
|
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
# saas.models.features.definition-builders
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Declaring what an application can SELL or gate on. Two builders, from `@wildo-ai/saas-models`:
|
|
14
|
+
* `defineFeature` for a boolean capability, `defineLimitFeature` for a numeric allowance.
|
|
15
|
+
*
|
|
16
|
+
* A product in the billing catalogue then grants them through `grantedFeatures` / `grantedLimits`,
|
|
17
|
+
* and any surface gates on the identifier with `requiredFeatures` — a resource operation, a view, a
|
|
18
|
+
* chart, a navigation item, a settings section.
|
|
19
|
+
*
|
|
20
|
+
* ## Two things that decide whether the gate actually fires
|
|
21
|
+
*
|
|
22
|
+
* (`limitSemantic` is the third and is covered by the product-definitions skill's own guidance —
|
|
23
|
+
* the default `FLOOR` is an entitlement the tenant is ALLOWED, and a consumption CAP needs `CEILING`.)
|
|
24
|
+
*
|
|
25
|
+
* - **`countResource` is the one-call form.** It registers a limit check on that resource's CREATE
|
|
26
|
+
* automatically, so "at most ten projects per organisation" is one declaration rather than a
|
|
27
|
+
* definition plus a hand-written gate. A limit declared WITHOUT counting cannot be checked
|
|
28
|
+
* automatically: `checkLimit` REFUSES rather than guessing at a remaining quota, and the caller
|
|
29
|
+
* must pass a counting override or measure consumption itself. That is the right answer for a
|
|
30
|
+
* quantity that is not a row count — a sum of tokens, for instance.
|
|
31
|
+
* - **`rateLimit` on a definition is RESERVED and ignored by the gate.** A time-windowed allowance
|
|
32
|
+
* like "one hundred calls an hour" is not expressible here at all; abuse throttling is a separate
|
|
33
|
+
* mechanism with its own declaration.
|
|
34
|
+
*
|
|
35
|
+
* ## Granting a capability does not configure it
|
|
36
|
+
*
|
|
37
|
+
* An entitlement says the tenant MAY have the thing. Single sign-on entitles an organisation to
|
|
38
|
+
* register an identity provider; somebody still has to register one. The same holds for provisioning
|
|
39
|
+
* tokens, export destinations and webhook endpoints — so a plan that grants one of these still needs
|
|
40
|
+
* an onboarding step behind it.
|
|
41
|
+
*
|
|
42
|
+
* Simple boolean feature builder.
|
|
43
|
+
*
|
|
44
|
+
* @example
|
|
45
|
+
* defineFeature('AI_ASSISTANT', { scope: ResourcePrimaryScope.ORGANIZATIONS })
|
|
46
|
+
*
|
|
47
|
+
* @example
|
|
48
|
+
* defineFeature('PREMIUM_THEMES', {
|
|
49
|
+
* scope: ResourcePrimaryScope.USER_SELF,
|
|
50
|
+
* unavailability: {
|
|
51
|
+
* behavior: FeatureUnavailabilityBehavior.UPGRADE_PROMPT,
|
|
52
|
+
* },
|
|
53
|
+
* })
|
|
54
|
+
*/
|
|
55
|
+
export function defineFeature(
|
|
56
|
+
identifier: string,
|
|
57
|
+
options: {
|
|
58
|
+
scope: ResourcePrimaryScope | ResourcePrimaryScope[];
|
|
59
|
+
defaultEnabled?: boolean;
|
|
60
|
+
dependencies?: string[];
|
|
61
|
+
unavailability?: FeatureUnavailabilityOverride;
|
|
62
|
+
}
|
|
63
|
+
): FeatureDefinition {
|
|
64
|
+
return {
|
|
65
|
+
identifier,
|
|
66
|
+
valueType: FeatureValueType.BOOLEAN,
|
|
67
|
+
applicableScopes: normalizeScopes(options.scope),
|
|
68
|
+
defaultValue: options.defaultEnabled ?? false,
|
|
69
|
+
dependencies: options.dependencies ?? [],
|
|
70
|
+
unavailability: options.unavailability,
|
|
71
|
+
};
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
// =====================================================
|
|
75
|
+
// defineLimitFeature() — Limit Feature Builder
|
|
76
|
+
// =====================================================
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* Limit feature builder with auto-wiring support.
|
|
80
|
+
*
|
|
81
|
+
* Key DX improvement: when `countResource` is provided, the engine
|
|
82
|
+
* auto-registers a `limitChecks` entry on the CREATE operation of the
|
|
83
|
+
* referenced resource at startup (via FeatureDefinitionRegistryBackendService).
|
|
84
|
+
*
|
|
85
|
+
* This means: to add "max 10 projects per org", write ONE call and the
|
|
86
|
+
* gate is automatically enforced. No need to manually add limitChecks on
|
|
87
|
+
* the resource's operation variant.
|
|
88
|
+
*
|
|
89
|
+
* @example
|
|
90
|
+
* defineLimitFeature('MAX_PROJECTS', {
|
|
91
|
+
* scope: ResourcePrimaryScope.ORGANIZATIONS,
|
|
92
|
+
* default: 5,
|
|
93
|
+
* countResource: CustomShared_ResourceType.PROJECTS,
|
|
94
|
+
* })
|
|
95
|
+
* // Equivalent to manually defining:
|
|
96
|
+
* // { identifier: 'MAX_PROJECTS', valueType: LIMIT, applicableScopes: [ORGANIZATIONS],
|
|
97
|
+
* // defaultValue: 5, counting: { resourceType: 'PROJECTS' } }
|
|
98
|
+
* // + adding limitChecks: [{ featureId: 'MAX_PROJECTS' }] on PROJECTS.CREATE variant
|
|
99
|
+
*
|
|
100
|
+
* @example
|
|
101
|
+
* defineLimitFeature('MAX_STORAGE_GB', {
|
|
102
|
+
* scope: ResourcePrimaryScope.ORGANIZATIONS,
|
|
103
|
+
* default: 10,
|
|
104
|
+
* counting: {
|
|
105
|
+
* resourceType: 'FILES',
|
|
106
|
+
* aggregate: { field: 'sizeBytes', operation: AggregationOperation.SUM },
|
|
107
|
+
* },
|
|
108
|
+
* })
|
|
109
|
+
*/
|
|
110
|
+
export function defineLimitFeature(
|
|
111
|
+
identifier: string,
|
|
112
|
+
options: {
|
|
113
|
+
scope: ResourcePrimaryScope | ResourcePrimaryScope[];
|
|
114
|
+
default: number;
|
|
115
|
+
/**
|
|
116
|
+
* How this limit COMPOSES when several sources supply a value (see {@link FeatureLimitSemantic}).
|
|
117
|
+
* Omit for the default `FLOOR` — an entitlement the tenant is ALLOWED, where most-permissive
|
|
118
|
+
* wins and add-ons stack upward (`MAX_MEMBERS`, `MAX_API_KEYS`).
|
|
119
|
+
*
|
|
120
|
+
* Pass `CEILING` for a consumption CAP the tenant may not exceed: most-RESTRICTIVE wins, and
|
|
121
|
+
* `FEATURES_UNLIMITED` means "no ceiling" so it yields to any finite grant. Without it a cap is
|
|
122
|
+
* inexpressible — under FLOOR an unlimited default absorbs every finite plan grant, so the cap
|
|
123
|
+
* silently never engages.
|
|
124
|
+
*/
|
|
125
|
+
limitSemantic?: FeatureLimitSemantic;
|
|
126
|
+
/** Resource to count. Auto-registers a limitCheck on CREATE for this resource. */
|
|
127
|
+
countResource?: string;
|
|
128
|
+
/** Advanced: filter + aggregation for counting (overrides simple resource count) */
|
|
129
|
+
counting?: LimitCountingConfig;
|
|
130
|
+
/** If true, skip auto-registration of limitChecks on the resource's CREATE operation */
|
|
131
|
+
skipAutoRegister?: boolean;
|
|
132
|
+
dependencies?: string[];
|
|
133
|
+
unavailability?: FeatureUnavailabilityOverride;
|
|
134
|
+
}
|
|
135
|
+
): FeatureDefinitionWithAutoRegister {
|
|
136
|
+
// Build counting config: explicit counting takes precedence, then countResource, then nothing
|
|
137
|
+
const counting: LimitCountingConfig | undefined =
|
|
138
|
+
options.counting ??
|
|
139
|
+
(options.countResource ? { resourceType: options.countResource } : undefined);
|
|
140
|
+
|
|
141
|
+
const definition: FeatureDefinitionWithAutoRegister = {
|
|
142
|
+
identifier,
|
|
143
|
+
valueType: FeatureValueType.LIMIT,
|
|
144
|
+
applicableScopes: normalizeScopes(options.scope),
|
|
145
|
+
defaultValue: options.default,
|
|
146
|
+
dependencies: options.dependencies ?? [],
|
|
147
|
+
// Omitted ⇒ absent on the definition ⇒ read as FLOOR, so every existing caller is unchanged.
|
|
148
|
+
...(options.limitSemantic ? { limitSemantic: options.limitSemantic } : {}),
|
|
149
|
+
counting,
|
|
150
|
+
unavailability: options.unavailability,
|
|
151
|
+
};
|
|
152
|
+
|
|
153
|
+
// Add auto-register marker for limit features with countResource (unless skipped)
|
|
154
|
+
if (options.countResource && !options.skipAutoRegister) {
|
|
155
|
+
definition[AUTO_REGISTER_LIMIT_CHECK] = {
|
|
156
|
+
countResource: options.countResource,
|
|
157
|
+
};
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
return definition;
|
|
161
|
+
}
|
|
162
|
+
```
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
# saas.models.file-upload-grant
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Lifetime bounds of an upload grant, in minutes. The ceiling is fixed by the framework and enforced
|
|
14
|
+
* when the grant is minted — a request above it is REFUSED, never clamped, so a caller that asked for
|
|
15
|
+
* two hours learns from an error that the bound is sixty minutes rather than from an expiry it did not
|
|
16
|
+
* expect. The bound is the framework's to own because the grant is designed to leave the trust
|
|
17
|
+
* boundary: it lands in an AI agent's transcript, a model provider's logs, a shell history.
|
|
18
|
+
*/
|
|
19
|
+
export const FILE_UPLOAD_GRANT_DEFAULT_MINUTES = 15;
|
|
20
|
+
export const FILE_UPLOAD_GRANT_ABSOLUTE_MAX_MINUTES = 60;
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Which write the grant is for. A grant minted on the CREATE upload route uploads a file that a
|
|
24
|
+
* later CREATE will reference; one minted on the UPDATE route (`…/{resourceId}/files/<field>`) is
|
|
25
|
+
* bound to that row. The two routes authorize differently, so a grant may not cross from one to the
|
|
26
|
+
* other — the upload middleware checks this against the route it is presented on.
|
|
27
|
+
*/
|
|
28
|
+
export const FILE_UPLOAD_GRANT_OPERATIONS = [CoreResourceOperation.CREATE, CoreResourceOperation.UPDATE] as const;
|
|
29
|
+
export type FileUploadGrantOperation = (typeof FILE_UPLOAD_GRANT_OPERATIONS)[number];
|
|
30
|
+
/** Derived from `CoreResourceOperation` — the named source — rather than a second enum spelling the same two words. */
|
|
31
|
+
export const FileUploadGrantOperationSchema: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }> = z.enum(FILE_UPLOAD_GRANT_OPERATIONS);
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* Lifecycle of a grant as the status read reports it. Derived from the token row — `isConsumed`,
|
|
35
|
+
* `expiresAt`, `revokedAt` — never stored, so it cannot drift from the row.
|
|
36
|
+
*/
|
|
37
|
+
export enum FileUploadGrantState {
|
|
38
|
+
/** Minted, unexpired, unrevoked, not yet redeemed: an upload will be accepted. */
|
|
39
|
+
PENDING = 'pending',
|
|
40
|
+
/** Redeemed by exactly one upload. `file` names what it produced when the write-back succeeded. */
|
|
41
|
+
REDEEMED = 'redeemed',
|
|
42
|
+
/** Past `expiresAt` without being redeemed. Mint a new one. */
|
|
43
|
+
EXPIRED = 'expired',
|
|
44
|
+
/** Revoked by the minter or an administrator before redemption. */
|
|
45
|
+
REVOKED = 'revoked',
|
|
46
|
+
}
|
|
47
|
+
export const FileUploadGrantStateSchema: z.ZodEnum<typeof FileUploadGrantState> = z.enum(FileUploadGrantState);
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* The `metadata` a FILE_UPLOAD_GRANT token carries — the ROUTE binding, as opposed to the identity
|
|
51
|
+
* the typed token fields carry. The upload middleware reads this; the execution-context creator
|
|
52
|
+
* deliberately does not.
|
|
53
|
+
*/
|
|
54
|
+
export const FileUploadGrantMetadataSchema: z.ZodObject<{
|
|
55
|
+
fieldName: z.ZodString;
|
|
56
|
+
operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
|
|
57
|
+
minter: z.ZodObject<{ entityType: z.ZodEnum<typeof FileUploaderEntityType>; id: z.ZodString }>;
|
|
58
|
+
uploadUrl: z.ZodString;
|
|
59
|
+
producedFileId: z.ZodOptional<z.ZodString>;
|
|
60
|
+
}> = z.object({
|
|
61
|
+
/** The `z_file()` field the upload lands on, as authored (dotted for nested fields). */
|
|
62
|
+
fieldName: z.string().min(1),
|
|
63
|
+
operation: FileUploadGrantOperationSchema,
|
|
64
|
+
/**
|
|
65
|
+
* Who minted — recorded so the uploaded file is attributed to a PERSON or MACHINE, not to the
|
|
66
|
+
* grant.
|
|
67
|
+
*
|
|
68
|
+
* `entityType` is the ENUM, not a string. It was `z.string().min(1)` until 2026-09-08, with the
|
|
69
|
+
* stated reason that "the uploader enum lives in `zod-decorators`, upstream of this package" —
|
|
70
|
+
* which is exactly backwards: upstream is what a package MAY import, and this one already does.
|
|
71
|
+
* `files.shared.schemas.ts` in this very directory imports `FileUploaderEntityType` from
|
|
72
|
+
* `@wildo-ai/zod-decorators`, re-exports it, and writes `z.enum(FileUploaderEntityType)` on the
|
|
73
|
+
* FILES row's own `uploadedByEntityType`. So the vocabulary was one import away the whole time and
|
|
74
|
+
* the metadata's copy of the same field was the only one left open.
|
|
75
|
+
*
|
|
76
|
+
* What the enum buys: `metadata` is an UNTYPED bag on the token row, so nothing between the write
|
|
77
|
+
* and the read guarantees its shape — the read is the only place that can. Every reader here goes
|
|
78
|
+
* through `FileUploadGrantMetadataSchema.safeParse`, so an out-of-vocabulary entity type now makes
|
|
79
|
+
* the whole metadata unparseable and the redemption path refuses the grant instead of casting the
|
|
80
|
+
* value into `FileUploaderPrincipal` and carrying it three layers to `validateUploadedByEntityType`.
|
|
81
|
+
*
|
|
82
|
+
* NOT narrowed to the three values `mint` can actually produce (mint refuses an anonymous and a
|
|
83
|
+
* token-borne minter, so `ANONYMOUS_USER` is unreachable): that refusal is a MINT policy, enforced
|
|
84
|
+
* and explained at mint, and re-encoding it here would put half a policy in a schema that cannot
|
|
85
|
+
* say why. The vocabulary of this field is the vocabulary of the principal it names.
|
|
86
|
+
*/
|
|
87
|
+
minter: z.object({ entityType: z.enum(FileUploaderEntityType), id: z.string().min(1) }),
|
|
88
|
+
/**
|
|
89
|
+
* The concrete upload URL the grant was minted for. Two jobs, and the second one is why it must be
|
|
90
|
+
* absolute: the status read hands it to the drop page, AND the redemption path compares its PATH
|
|
91
|
+
* against the route the token is presented on (`assertGrantMatchesRoute`). Until 2026-09-08 it was
|
|
92
|
+
* recorded and never read back, so a grant bound to one concrete route could be redeemed on any
|
|
93
|
+
* other route reaching the same (resource, field, operation, row).
|
|
94
|
+
*/
|
|
95
|
+
uploadUrl: z.string().url(),
|
|
96
|
+
/** Written after a successful redemption; absent until then. */
|
|
97
|
+
producedFileId: z.string().min(1).optional(),
|
|
98
|
+
});
|
|
99
|
+
export type FileUploadGrantMetadata = z.infer<typeof FileUploadGrantMetadataSchema>;
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* What a mint returns — identical on the REST door and the MCP tool. Two affordances for one
|
|
103
|
+
* token: `uploadCommand` for a caller that can execute, `uploadPageUrl` for one that must hand a
|
|
104
|
+
* human a link. The token appears in `uploadHeader.value` and inside both commands and the page URL;
|
|
105
|
+
* it is the credential and cannot be omitted. It never appears in any audit row.
|
|
106
|
+
*/
|
|
107
|
+
export const FileUploadGrantSchema: z.ZodObject<{
|
|
108
|
+
grantId: z.ZodString;
|
|
109
|
+
state: z.ZodEnum<typeof FileUploadGrantState>;
|
|
110
|
+
expiresAt: z.ZodString;
|
|
111
|
+
singleUse: z.ZodLiteral<true>;
|
|
112
|
+
target: z.ZodObject<{
|
|
113
|
+
resourceType: z.ZodString;
|
|
114
|
+
fieldName: z.ZodString;
|
|
115
|
+
operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
|
|
116
|
+
resourceId: z.ZodNullable<z.ZodString>;
|
|
117
|
+
}>;
|
|
118
|
+
constraints: z.ZodObject<{
|
|
119
|
+
maxBytes: z.ZodNumber;
|
|
120
|
+
allowedMimeTypes: z.ZodArray<z.ZodString>;
|
|
121
|
+
}>;
|
|
122
|
+
uploadUrl: z.ZodString;
|
|
123
|
+
uploadHeader: z.ZodObject<{ name: z.ZodString; value: z.ZodString }>;
|
|
124
|
+
uploadCommand: z.ZodString;
|
|
125
|
+
uploadCommandPowerShell: z.ZodString;
|
|
126
|
+
uploadPageUrl: z.ZodNullable<z.ZodString>;
|
|
127
|
+
statusUrl: z.ZodString;
|
|
128
|
+
note: z.ZodString;
|
|
129
|
+
}> = z.object({
|
|
130
|
+
grantId: z.string().min(1),
|
|
131
|
+
state: FileUploadGrantStateSchema,
|
|
132
|
+
expiresAt: z.string().datetime(),
|
|
133
|
+
singleUse: z.literal(true),
|
|
134
|
+
target: z.object({
|
|
135
|
+
resourceType: z.string().min(1),
|
|
136
|
+
fieldName: z.string().min(1),
|
|
137
|
+
operation: FileUploadGrantOperationSchema,
|
|
138
|
+
resourceId: z.string().min(1).nullable(),
|
|
139
|
+
}),
|
|
140
|
+
/** From the field's own constraint resolver — the same one the upload enforces, so the two cannot disagree. */
|
|
141
|
+
constraints: z.object({
|
|
142
|
+
maxBytes: z.number().int().positive(),
|
|
143
|
+
/** Empty means every type is accepted. */
|
|
144
|
+
allowedMimeTypes: z.array(z.string()),
|
|
145
|
+
}),
|
|
146
|
+
uploadUrl: z.string().url(),
|
|
147
|
+
/** The credential travels in a HEADER on the curl form: paths are logged by every proxy, headers are not. */
|
|
148
|
+
uploadHeader: z.object({ name: z.string().min(1), value: z.string().min(1) }),
|
|
149
|
+
/** No `-f`: on a refusal the JSON error body is the only thing that tells the caller why. */
|
|
150
|
+
uploadCommand: z.string().min(1),
|
|
151
|
+
/** In PowerShell `curl` aliases Invoke-WebRequest, which does not understand `-F`; the real binary is `curl.exe`. */
|
|
152
|
+
uploadCommandPowerShell: z.string().min(1),
|
|
153
|
+
/** `null` when the application declares no frontend service — a headless API has no page to hand a human. */
|
|
154
|
+
uploadPageUrl: z.string().url().nullable(),
|
|
155
|
+
statusUrl: z.string().url(),
|
|
156
|
+
note: z.string().min(1),
|
|
157
|
+
});
|
|
158
|
+
export type FileUploadGrant = z.infer<typeof FileUploadGrantSchema>;
|
|
159
|
+
|
|
160
|
+
/**
|
|
161
|
+
* What the public status read returns. The token is the credential, so the read is unauthenticated
|
|
162
|
+
* and returns only what the drop page needs to render and the agent needs to learn the `fileId`:
|
|
163
|
+
* never the file's name (the status URL may be pasted around).
|
|
164
|
+
*/
|
|
165
|
+
export const FileUploadGrantStatusSchema: z.ZodObject<{
|
|
166
|
+
grantId: z.ZodString;
|
|
167
|
+
state: z.ZodEnum<typeof FileUploadGrantState>;
|
|
168
|
+
expiresAt: z.ZodString;
|
|
169
|
+
target: z.ZodObject<{
|
|
170
|
+
resourceType: z.ZodString;
|
|
171
|
+
fieldName: z.ZodString;
|
|
172
|
+
operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
|
|
173
|
+
resourceId: z.ZodNullable<z.ZodString>;
|
|
174
|
+
}>;
|
|
175
|
+
constraints: z.ZodObject<{ maxBytes: z.ZodNumber; allowedMimeTypes: z.ZodArray<z.ZodString> }>;
|
|
176
|
+
uploadUrl: z.ZodString;
|
|
177
|
+
uploadHeaderName: z.ZodString;
|
|
178
|
+
file: z.ZodNullable<z.ZodObject<{ fileId: z.ZodString; status: z.ZodEnum<typeof FileStatus> }>>;
|
|
179
|
+
}> = z.object({
|
|
180
|
+
grantId: z.string().min(1),
|
|
181
|
+
state: FileUploadGrantStateSchema,
|
|
182
|
+
expiresAt: z.string().datetime(),
|
|
183
|
+
target: z.object({
|
|
184
|
+
resourceType: z.string().min(1),
|
|
185
|
+
fieldName: z.string().min(1),
|
|
186
|
+
operation: FileUploadGrantOperationSchema,
|
|
187
|
+
resourceId: z.string().min(1).nullable(),
|
|
188
|
+
}),
|
|
189
|
+
constraints: z.object({ maxBytes: z.number().int().positive(), allowedMimeTypes: z.array(z.string()) }),
|
|
190
|
+
uploadUrl: z.string().url(),
|
|
191
|
+
/** The page sets this header itself; the token it already holds is the value. */
|
|
192
|
+
uploadHeaderName: z.string().min(1),
|
|
193
|
+
/** `null` until redeemed, or when the post-redemption write-back failed (re-read the resource instead). */
|
|
194
|
+
file: z.object({ fileId: z.string().min(1), status: z.enum(FileStatus) }).nullable(),
|
|
195
|
+
});
|
|
196
|
+
export type FileUploadGrantStatus = z.infer<typeof FileUploadGrantStatusSchema>;
|
|
197
|
+
|
|
198
|
+
/**
|
|
199
|
+
* Body accepted by both mint doors.
|
|
200
|
+
*
|
|
201
|
+
* The three optional file facts mirror what the MCP File Objects proposal has a client declare when
|
|
202
|
+
* it asks to upload (`name`, `mimeType`, `size`): declaring them lets the server refuse a file the
|
|
203
|
+
* field would never accept BEFORE handing out a link, instead of at redemption when the link is
|
|
204
|
+
* already spent. They are advisory for the upload itself — the bytes are validated on receipt
|
|
205
|
+
* regardless — and a declaration that later disagrees with the bytes is refused on receipt too.
|
|
206
|
+
*/
|
|
207
|
+
export const FileUploadGrantMintRequestSchema: z.ZodObject<{
|
|
208
|
+
expiresInMinutes: z.ZodOptional<z.ZodNumber>;
|
|
209
|
+
name: z.ZodOptional<z.ZodString>;
|
|
210
|
+
mimeType: z.ZodOptional<z.ZodString>;
|
|
211
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
212
|
+
}> = z.object({
|
|
213
|
+
expiresInMinutes: z.number().int().min(1).max(FILE_UPLOAD_GRANT_ABSOLUTE_MAX_MINUTES).optional(),
|
|
214
|
+
/** The file name the caller intends to upload; used for the curl example and checked against nothing else. */
|
|
215
|
+
name: z.string().min(1).max(255).optional(),
|
|
216
|
+
/** Declared MIME type; refused at mint when the field does not accept it. */
|
|
217
|
+
mimeType: z.string().min(1).max(255).optional(),
|
|
218
|
+
/** Declared size in bytes; refused at mint when above the field's maximum. */
|
|
219
|
+
size: z.number().int().positive().optional(),
|
|
220
|
+
}).strict();
|
|
221
|
+
export type FileUploadGrantMintRequest = z.infer<typeof FileUploadGrantMintRequestSchema>;
|
|
222
|
+
```
|