@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
|
@@ -122,6 +122,8 @@ export type DecoratedMoneySchema = z.ZodObject<{
|
|
|
122
122
|
decimals: z.ZodNumber;
|
|
123
123
|
}> & {
|
|
124
124
|
[ZodDecorator.IS_DB_INDEXED](): DecoratedMoneySchema;
|
|
125
|
+
/** Installed at runtime with the other chainable methods; declared here so an authored `.moneyUI(…)` typechecks. */
|
|
126
|
+
[ZodDecorator.MONEY_UI](params?: ZodDecorator_ParamsType[ZodDecorator.MONEY_UI]): DecoratedMoneySchema;
|
|
125
127
|
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedMoneySchema;
|
|
126
128
|
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedMoneySchema;
|
|
127
129
|
// Resource-level decorators (applicable to all types including ZodObject)
|
|
@@ -562,6 +564,8 @@ export type DecoratedDurationSchema = z.ZodObject<{
|
|
|
562
564
|
unit: z.ZodTypeAny;
|
|
563
565
|
}> & {
|
|
564
566
|
[ZodDecorator.IS_DB_INDEXED](): DecoratedDurationSchema;
|
|
567
|
+
/** Installed at runtime with the other chainable methods; declared here so an authored `.durationUI(…)` typechecks. */
|
|
568
|
+
[ZodDecorator.DURATION_UI](params?: ZodDecorator_ParamsType[ZodDecorator.DURATION_UI]): DecoratedDurationSchema;
|
|
565
569
|
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedDurationSchema;
|
|
566
570
|
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedDurationSchema;
|
|
567
571
|
[ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedDurationSchema;
|
|
@@ -645,7 +649,12 @@ export function createPhoneSchema(options: PhoneSchemaOptions = {}): DecoratedPh
|
|
|
645
649
|
phoneConfig: phoneMetadata,
|
|
646
650
|
};
|
|
647
651
|
|
|
648
|
-
|
|
652
|
+
// 'ZodString' rather than the instance's own constructor, which is `ZodPipe` because of the
|
|
653
|
+
// `.pipe(z.string())` above. A phone IS a string for every decorator purpose — the pipe exists to
|
|
654
|
+
// normalize to E.164, not to change what the field is — and without this the applyable-type
|
|
655
|
+
// lookup matches nothing and the schema carries NO decorators at all, including the eight
|
|
656
|
+
// `DecoratedPhoneSchema` declares.
|
|
657
|
+
addChainableMethods(phoneSchema, 'ZodString');
|
|
649
658
|
|
|
650
659
|
return phoneSchema as unknown as DecoratedPhoneSchema;
|
|
651
660
|
}
|
|
@@ -662,6 +671,14 @@ export type DecoratedPhoneSchema = z.ZodString & {
|
|
|
662
671
|
[ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedPhoneSchema;
|
|
663
672
|
[ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedPhoneSchema;
|
|
664
673
|
[ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedPhoneSchema;
|
|
674
|
+
/**
|
|
675
|
+
* Declared here, as the sibling factories declare theirs (`DecoratedMoneySchema.moneyUI`,
|
|
676
|
+
* `DecoratedCodeSchema.codeUI`, …), because a phone's display and edit policy is authored on the
|
|
677
|
+
* factory's output and nowhere else. The applyable-type map admits `phoneUI` on `ZodString`, but
|
|
678
|
+
* a bare `z.string()` is not a phone, so the base prototype deliberately does not carry it.
|
|
679
|
+
*/
|
|
680
|
+
[ZodDecorator.PHONE_UI](params?: ZodDecorator_ParamsType[ZodDecorator.PHONE_UI]): DecoratedPhoneSchema;
|
|
681
|
+
[ZodDecorator.PHONE_SPEC](params?: ZodDecorator_ParamsType[ZodDecorator.PHONE_SPEC]): DecoratedPhoneSchema;
|
|
665
682
|
addDecorators(decorators: DecoratorInput[]): DecoratedPhoneSchema;
|
|
666
683
|
};
|
|
667
684
|
|
|
@@ -681,6 +698,125 @@ export function z_phone(options?: PhoneSchemaOptions): DecoratedPhoneSchema {
|
|
|
681
698
|
}
|
|
682
699
|
```
|
|
683
700
|
|
|
701
|
+
## Address
|
|
702
|
+
|
|
703
|
+
## Import Origins
|
|
704
|
+
|
|
705
|
+
- `@wildo-ai/zod-decorators`
|
|
706
|
+
|
|
707
|
+
## Source Excerpts
|
|
708
|
+
|
|
709
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
710
|
+
|
|
711
|
+
```typescript
|
|
712
|
+
*
|
|
713
|
+
* z_address() - Creates a structured postal address field.
|
|
714
|
+
*
|
|
715
|
+
* The value is `{ line1, line2?, city, state?, postalCode?, country, coordinates? }`: a parsed,
|
|
716
|
+
* country-aware value the framework renders with its own form and display fields, instead of an
|
|
717
|
+
* opaque `z.string()` nothing can validate, normalise or compare.
|
|
718
|
+
*
|
|
719
|
+
* - Free-text parts are normalised on parse (trimmed, inner whitespace collapsed).
|
|
720
|
+
* - `country` is an ISO 3166-1 alpha-2 code, uppercased on parse; `countriesAllowed` restricts it.
|
|
721
|
+
* - `coordinates` is an optional `{ latitude, longitude }` pair; `withCoordinates` offers it in the form.
|
|
722
|
+
* - `addressComparisonKey` / `isSameAddress` (same package) tell whether two values are one place
|
|
723
|
+
* spelled differently.
|
|
724
|
+
*
|
|
725
|
+
* An address is personal data. Declare its data category and erasure treatment on the field like any
|
|
726
|
+
* other personal field: this factory does not decide either for you.
|
|
727
|
+
*
|
|
728
|
+
* @example
|
|
729
|
+
* ```typescript
|
|
730
|
+
* import { z_address } from '@wildo-ai/zod-decorators';
|
|
731
|
+
*
|
|
732
|
+
* const shippingAddress = z_address();
|
|
733
|
+
* const siteAddress = z_address({ withCoordinates: true, countriesAllowed: ['FR', 'BE'], defaultCountry: 'FR' });
|
|
734
|
+
* ```
|
|
735
|
+
*/
|
|
736
|
+
export function createAddressSchema(options: AddressSchemaOptions = {}): DecoratedAddressSchema {
|
|
737
|
+
const countriesAllowed = options.countriesAllowed?.map(normalizeAddressCountry);
|
|
738
|
+
for (const code of countriesAllowed ?? []) {
|
|
739
|
+
if (!ISO_COUNTRY_CODE_PATTERN.test(code)) {
|
|
740
|
+
throw new Error(`[z_address] countriesAllowed contains "${code}", which is not an ISO 3166-1 alpha-2 code.`);
|
|
741
|
+
}
|
|
742
|
+
}
|
|
743
|
+
const defaultCountry = options.defaultCountry === undefined ? undefined : normalizeAddressCountry(options.defaultCountry);
|
|
744
|
+
if (defaultCountry !== undefined) {
|
|
745
|
+
// Refused at DECLARATION, not at first render: a form pre-selecting a country the value may not
|
|
746
|
+
// name would be an error the author could only discover by filling the form.
|
|
747
|
+
if (!ISO_COUNTRY_CODE_PATTERN.test(defaultCountry)) {
|
|
748
|
+
throw new Error(`[z_address] defaultCountry "${options.defaultCountry}" is not an ISO 3166-1 alpha-2 code.`);
|
|
749
|
+
}
|
|
750
|
+
if (countriesAllowed && countriesAllowed.length > 0 && !countriesAllowed.includes(defaultCountry)) {
|
|
751
|
+
throw new Error(`[z_address] defaultCountry "${defaultCountry}" is not among countriesAllowed (${countriesAllowed.join(', ')}).`);
|
|
752
|
+
}
|
|
753
|
+
}
|
|
754
|
+
|
|
755
|
+
const text = (): z.ZodString => z.string().overwrite(normalizeAddressText);
|
|
756
|
+
let country: z.ZodString = z.string()
|
|
757
|
+
.overwrite(normalizeAddressCountry)
|
|
758
|
+
.regex(ISO_COUNTRY_CODE_PATTERN, { error: 'Country must be an ISO 3166-1 alpha-2 code' });
|
|
759
|
+
if (countriesAllowed && countriesAllowed.length > 0) {
|
|
760
|
+
country = country.refine((code) => countriesAllowed.includes(code), {
|
|
761
|
+
error: `Country must be one of: ${countriesAllowed.join(', ')}`,
|
|
762
|
+
});
|
|
763
|
+
}
|
|
764
|
+
|
|
765
|
+
const addressSchema = z.object({
|
|
766
|
+
line1: text().min(1, { error: 'Address line 1 is required' }).max(100),
|
|
767
|
+
line2: text().max(100).optional(),
|
|
768
|
+
city: text().min(1, { error: 'City is required' }).max(50),
|
|
769
|
+
state: text().max(50).optional(),
|
|
770
|
+
postalCode: text().max(20).optional(),
|
|
771
|
+
country,
|
|
772
|
+
coordinates: AddressCoordinatesSchema.optional(),
|
|
773
|
+
});
|
|
774
|
+
|
|
775
|
+
const addressMetadata: AddressSchemaMetadata = {
|
|
776
|
+
isAddress: true,
|
|
777
|
+
withCoordinates: options.withCoordinates === true,
|
|
778
|
+
...(countriesAllowed && countriesAllowed.length > 0 && { countriesAllowed }),
|
|
779
|
+
...(defaultCountry !== undefined && { defaultCountry }),
|
|
780
|
+
};
|
|
781
|
+
|
|
782
|
+
const existingMetadata: CustomFieldMetadata = (addressSchema as any)[SCHEMA_METADATA] || {};
|
|
783
|
+
(addressSchema as any)[SCHEMA_METADATA] = {
|
|
784
|
+
...existingMetadata,
|
|
785
|
+
addressConfig: addressMetadata,
|
|
786
|
+
};
|
|
787
|
+
|
|
788
|
+
addChainableMethods(addressSchema);
|
|
789
|
+
|
|
790
|
+
return addressSchema as DecoratedAddressSchema;
|
|
791
|
+
}
|
|
792
|
+
|
|
793
|
+
/**
|
|
794
|
+
* Return type for address schemas — includes the decorators applicable to a `ZodObject`.
|
|
795
|
+
*
|
|
796
|
+
* No address-specific UI or SPEC decorator exists yet: the form and display fields render from the
|
|
797
|
+
* metadata alone. Adding one later is additive.
|
|
798
|
+
*/
|
|
799
|
+
export type DecoratedAddressSchema = z.ZodObject<AddressSchemaShape> & {
|
|
800
|
+
[ZodDecorator.IS_DB_INDEXED](): DecoratedAddressSchema;
|
|
801
|
+
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedAddressSchema;
|
|
802
|
+
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedAddressSchema;
|
|
803
|
+
[ZodDecorator.IS_SUMMARY_FIELD](params?: SummaryFieldParams): DecoratedAddressSchema;
|
|
804
|
+
[ZodDecorator.IS_BACKEND_ONLY](params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedAddressSchema;
|
|
805
|
+
[ZodDecorator.IS_WRITE_ONLY_SECRET](params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedAddressSchema;
|
|
806
|
+
[ZodDecorator.EXCLUDE_FROM_CREATE](): DecoratedAddressSchema;
|
|
807
|
+
[ZodDecorator.EXCLUDE_FROM_UPDATE](): DecoratedAddressSchema;
|
|
808
|
+
addDecorators(decorators: DecoratorInput[]): DecoratedAddressSchema;
|
|
809
|
+
};
|
|
810
|
+
|
|
811
|
+
/**
|
|
812
|
+
* Creates a structured postal address schema. Named z_address to indicate it is a Zod helper exported
|
|
813
|
+
* standalone, like `z_money` and `z_phone`.
|
|
814
|
+
*/
|
|
815
|
+
export function z_address(options?: AddressSchemaOptions): DecoratedAddressSchema {
|
|
816
|
+
return createAddressSchema(options);
|
|
817
|
+
}
|
|
818
|
+
```
|
|
819
|
+
|
|
684
820
|
## Code
|
|
685
821
|
|
|
686
822
|
## Import Origins
|
|
@@ -775,6 +911,8 @@ export type DecoratedCodeSchema = z.ZodObject<{
|
|
|
775
911
|
language: z.ZodString;
|
|
776
912
|
}> & {
|
|
777
913
|
[ZodDecorator.IS_DB_INDEXED](): DecoratedCodeSchema;
|
|
914
|
+
/** Installed at runtime with the other chainable methods; declared here so an authored `.codeUI(…)` typechecks. */
|
|
915
|
+
[ZodDecorator.CODE_UI](params?: ZodDecorator_ParamsType[ZodDecorator.CODE_UI]): DecoratedCodeSchema;
|
|
778
916
|
[ZodDecorator.IS_HIDDEN](params?: ZodDecorator_ParamsType[ZodDecorator.IS_HIDDEN]): DecoratedCodeSchema;
|
|
779
917
|
[ZodDecorator.IS_NOT_EDITABLE](params?: ZodDecorator_ParamsType[ZodDecorator.IS_NOT_EDITABLE]): DecoratedCodeSchema;
|
|
780
918
|
addDecorators(decorators: DecoratorInput[]): DecoratedCodeSchema;
|
|
@@ -1032,9 +1170,16 @@ export interface FileSchemaMetadata {
|
|
|
1032
1170
|
textExtraction?: FileTextExtractionOptions;
|
|
1033
1171
|
/**
|
|
1034
1172
|
* Antivirus scan policy for this file field.
|
|
1035
|
-
* - 'required': always scan after upload,
|
|
1036
|
-
*
|
|
1037
|
-
* -
|
|
1173
|
+
* - 'required': always scan after upload, whatever the application-wide default says. If no scanner
|
|
1174
|
+
* is reachable the upload is FAILED rather than passed — a demanded scan that cannot run refuses.
|
|
1175
|
+
* - 'skip': never scan this field, even when the application has a scanner.
|
|
1176
|
+
* - undefined: inherit the application-wide default, which is DERIVED from whether a scanner is
|
|
1177
|
+
* reachable at all (a ClamAV host, or YARA both enabled and reachable). Provisioning the sidecar IS
|
|
1178
|
+
* the application-level opt-in; there is no separate on/off flag to set.
|
|
1179
|
+
*
|
|
1180
|
+
* That last line named `appConfig.files.scanning.enabled` until 2026-09-09. No configuration schema
|
|
1181
|
+
* has ever declared a `files` section, so the value an undeclared field inherited was `false` in every
|
|
1182
|
+
* application — this text described a switch that could not be turned on.
|
|
1038
1183
|
*/
|
|
1039
1184
|
scanPolicy?: 'required' | 'skip';
|
|
1040
1185
|
/** Behavior when parent resource is deleted (default: CASCADE) */
|
|
@@ -1067,6 +1212,36 @@ export interface FileSchemaMetadata {
|
|
|
1067
1212
|
*
|
|
1068
1213
|
* Creates a file schema with metadata for detection and form component rendering.
|
|
1069
1214
|
*
|
|
1215
|
+
* ## Where a file field may be declared
|
|
1216
|
+
*
|
|
1217
|
+
* **The resource's primary scope must be application, organization or user.** A resource scoped to
|
|
1218
|
+
* an ANONYMOUS visitor cannot carry a file field — a file's own scope is one of those three, so
|
|
1219
|
+
* there is nothing to attribute the bytes to, and the upload refuses that scope by name rather than
|
|
1220
|
+
* pretending to support it.
|
|
1221
|
+
*
|
|
1222
|
+
* **Within the schema, a file field may nest inside objects, arrays and DISCRIMINATED unions.** It
|
|
1223
|
+
* may NOT sit inside a record, a map, a set, a tuple, or a plain (non-discriminated) union — the
|
|
1224
|
+
* walker that finds file fields refuses those shapes. Where variants are needed, use a discriminated
|
|
1225
|
+
* union.
|
|
1226
|
+
*
|
|
1227
|
+
* **A field carried on several branches of a discriminated union must declare IDENTICAL options on
|
|
1228
|
+
* every branch.** Differing options at one path are a conflict the framework refuses rather than
|
|
1229
|
+
* choosing between, so a branch that quietly widens `maxSize` or changes `allowedMimeTypes` fails
|
|
1230
|
+
* the schema instead of silently winning.
|
|
1231
|
+
*
|
|
1232
|
+
* ## Uploading is not attaching
|
|
1233
|
+
*
|
|
1234
|
+
* The generated upload route creates a FILE ROW. Attaching it to a business record is that record's
|
|
1235
|
+
* own write, with its own authority. So an uploaded-but-never-submitted file is a real state a
|
|
1236
|
+
* caller can produce; the cleanup sweep is what handles it.
|
|
1237
|
+
*
|
|
1238
|
+
* ## Declaring `imageConstraints.aspectRatio` turns the cropper on
|
|
1239
|
+
*
|
|
1240
|
+
* That option is the switch for the browser-side crop step — nothing else is wired. It applies to
|
|
1241
|
+
* single-file fields only: a `multiple` field keeps the plain upload path. Vector images and
|
|
1242
|
+
* formats the browser cannot decode bypass the cropper and upload the original, so the server-side
|
|
1243
|
+
* constraint stays the authority.
|
|
1244
|
+
*
|
|
1070
1245
|
* @param options - Configuration options for file field
|
|
1071
1246
|
* @returns A Zod object schema with metadata for file detection
|
|
1072
1247
|
*/
|
|
@@ -1096,17 +1271,24 @@ export function createFileSchema(
|
|
|
1096
1271
|
sharableDefaults,
|
|
1097
1272
|
} = options;
|
|
1098
1273
|
|
|
1099
|
-
// Warn at schema creation
|
|
1274
|
+
// Warn at schema creation for a storage no provider serves yet — a declared vocabulary member with no implementation
|
|
1100
1275
|
// Uses deduplication to avoid console spam during tests or HMR
|
|
1101
1276
|
if (storageAccepted && storageAccepted.some(s => !_supportedProviders.has(s))) {
|
|
1102
1277
|
const unsupported = storageAccepted.filter(s => !_supportedProviders.has(s));
|
|
1103
1278
|
const warnKey = unsupported.sort().join(',');
|
|
1104
1279
|
if (!_warnedStorageProviders.has(warnKey)) {
|
|
1105
1280
|
_warnedStorageProviders.add(warnKey);
|
|
1281
|
+
// The two cases are NOT the same outcome, and saying only "skipped" understates the second
|
|
1282
|
+
// badly enough to be misleading: alongside an implemented storage the declaration really is
|
|
1283
|
+
// ignored, but as the ONLY declared storage it stops the application booting. That is the
|
|
1284
|
+
// split #460 records, stated here at the moment an author writes the declaration — earlier
|
|
1285
|
+
// than the startup validator and the storage router, which draw the same distinction.
|
|
1106
1286
|
console.warn(
|
|
1107
|
-
`[z_file] storageAccepted
|
|
1108
|
-
`
|
|
1109
|
-
`
|
|
1287
|
+
`[z_file] storageAccepted names storage(s) no provider serves yet: ${unsupported.join(', ')}. ` +
|
|
1288
|
+
`Implemented: ${[..._supportedProviders].map((s) => `'${s}'`).join(', ')}. ` +
|
|
1289
|
+
`Declared ALONGSIDE an implemented storage it is skipped by the storage router; declared as the ONLY ` +
|
|
1290
|
+
`storage the application refuses to boot and every upload to this field is refused. There is no ` +
|
|
1291
|
+
`environment variable that would enable it — a storage with no provider cannot be configured into existence.`
|
|
1110
1292
|
);
|
|
1111
1293
|
}
|
|
1112
1294
|
}
|
|
@@ -1124,12 +1306,16 @@ export function createFileSchema(
|
|
|
1124
1306
|
'Use filePathBinding.multipleFilePolicy.fileNameTemplate instead.'
|
|
1125
1307
|
);
|
|
1126
1308
|
}
|
|
1127
|
-
|
|
1128
|
-
|
|
1129
|
-
|
|
1309
|
+
// Warned for EVERY provider, not only WILDO_MANAGED. The condition used to exempt a field that
|
|
1310
|
+
// named LOCAL_DIRECTORY, because that provider defaulted to `false` anyway and the warning would
|
|
1311
|
+
// have fired on its own default. Both providers now default to `true` and both honour `false`
|
|
1312
|
+
// identically, so `false` is an explicit opt-out of the tenant-scoped key shape wherever it is
|
|
1313
|
+
// authored — and that is the thing worth saying out loud.
|
|
1314
|
+
if (filePathBinding.includeApplicationId === false) {
|
|
1130
1315
|
console.warn(
|
|
1131
|
-
'[z_file] filePathBinding.includeApplicationId is false
|
|
1132
|
-
'
|
|
1316
|
+
'[z_file] filePathBinding.includeApplicationId is false. Storage keys for this field will carry ' +
|
|
1317
|
+
'NO applications/<appId>/files/<resource>/<scope>/<scopeId>/ prefix, so per-tenant listing, ' +
|
|
1318
|
+
'erasure sweeps and prefix-confined credentials cannot address them — ensure that is intended.'
|
|
1133
1319
|
);
|
|
1134
1320
|
}
|
|
1135
1321
|
}
|
|
@@ -1226,7 +1412,21 @@ export function createFileSchema(
|
|
|
1226
1412
|
export interface DecoratedFileSchema extends z.ZodObject<{
|
|
1227
1413
|
fileId: z.ZodString;
|
|
1228
1414
|
updatedAt: z.ZodDate;
|
|
1229
|
-
}> {
|
|
1415
|
+
}> {
|
|
1416
|
+
/**
|
|
1417
|
+
* Declared here, as the sibling factories declare theirs (`DecoratedMoneySchema.moneyUI`,
|
|
1418
|
+
* `DecoratedPhoneSchema.phoneUI`, …), because a file's display and edit policy is authored on
|
|
1419
|
+
* the factory's output and nowhere else. The applyable-type map admits `fileUI` on `ZodObject`,
|
|
1420
|
+
* but a bare `z.object({...})` is not a file, so the base prototype deliberately does not carry
|
|
1421
|
+
* it — the per-instance install `createFileSchema` performs is what makes it reachable.
|
|
1422
|
+
*
|
|
1423
|
+
* Not a RE-declaration: `fileUI` is absent from the `ZodObject` module augmentation, so this adds
|
|
1424
|
+
* a member rather than conflicting with one. That distinction is what the TS2320 note above is
|
|
1425
|
+
* about — re-declaring a member the augmentation already carries is what broke here before.
|
|
1426
|
+
*/
|
|
1427
|
+
[ZodDecorator.FILE_UI](params?: ZodDecorator_ParamsType[ZodDecorator.FILE_UI]): DecoratedFileSchema;
|
|
1428
|
+
[ZodDecorator.FILE_SPEC](params?: ZodDecorator_ParamsType[ZodDecorator.FILE_SPEC]): DecoratedFileSchema;
|
|
1429
|
+
}
|
|
1230
1430
|
|
|
1231
1431
|
/**
|
|
1232
1432
|
* Return type for multiple file schemas - includes decorator methods.
|
|
@@ -1237,7 +1437,21 @@ export interface DecoratedFileSchema extends z.ZodObject<{
|
|
|
1237
1437
|
export interface DecoratedMultipleFileSchema extends z.ZodObject<{
|
|
1238
1438
|
fileIds: z.ZodArray<z.ZodString>;
|
|
1239
1439
|
updatedAt: z.ZodDate;
|
|
1240
|
-
}> {
|
|
1440
|
+
}> {
|
|
1441
|
+
/**
|
|
1442
|
+
* Declared here, as the sibling factories declare theirs (`DecoratedMoneySchema.moneyUI`,
|
|
1443
|
+
* `DecoratedPhoneSchema.phoneUI`, …), because a file's display and edit policy is authored on
|
|
1444
|
+
* the factory's output and nowhere else. The applyable-type map admits `fileUI` on `ZodObject`,
|
|
1445
|
+
* but a bare `z.object({...})` is not a file, so the base prototype deliberately does not carry
|
|
1446
|
+
* it — the per-instance install `createFileSchema` performs is what makes it reachable. Mirrors the single-file interface above.
|
|
1447
|
+
*
|
|
1448
|
+
* Not a RE-declaration: `fileUI` is absent from the `ZodObject` module augmentation, so this adds
|
|
1449
|
+
* a member rather than conflicting with one. That distinction is what the TS2320 note above is
|
|
1450
|
+
* about — re-declaring a member the augmentation already carries is what broke here before.
|
|
1451
|
+
*/
|
|
1452
|
+
[ZodDecorator.FILE_UI](params?: ZodDecorator_ParamsType[ZodDecorator.FILE_UI]): DecoratedMultipleFileSchema;
|
|
1453
|
+
[ZodDecorator.FILE_SPEC](params?: ZodDecorator_ParamsType[ZodDecorator.FILE_SPEC]): DecoratedMultipleFileSchema;
|
|
1454
|
+
}
|
|
1241
1455
|
|
|
1242
1456
|
/**
|
|
1243
1457
|
* Creates a file schema for file uploads with reference storage.
|
|
@@ -1284,3 +1498,254 @@ export function z_file(options?: FileSchemaOptions): DecoratedFileSchema | Decor
|
|
|
1284
1498
|
return createFileSchema(options);
|
|
1285
1499
|
}
|
|
1286
1500
|
```
|
|
1501
|
+
|
|
1502
|
+
## Per-Nature File Constraints
|
|
1503
|
+
|
|
1504
|
+
`z_file({ nature, imageConstraints, videoConstraints, audioConstraints, documentConstraints })` —
|
|
1505
|
+
what each bag may carry. The option bag itself is above; these are its nested types, which is where
|
|
1506
|
+
`maxWidth`, `aspectRatio` and the opt-OUT `generateThumbnails` live.
|
|
1507
|
+
|
|
1508
|
+
## Import Origins
|
|
1509
|
+
|
|
1510
|
+
- `@wildo-ai/zod-decorators`
|
|
1511
|
+
|
|
1512
|
+
## Source Excerpts
|
|
1513
|
+
|
|
1514
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1515
|
+
|
|
1516
|
+
```typescript
|
|
1517
|
+
*
|
|
1518
|
+
* The per-NATURE constraint bags a `z_file()` field may carry — one per media kind, selected by the
|
|
1519
|
+
* field's `nature`. `imageConstraints`, `videoConstraints`, `audioConstraints` and
|
|
1520
|
+
* `documentConstraints` on the `z_file()` options each take the matching interface below.
|
|
1521
|
+
*
|
|
1522
|
+
* Image geometry declared with `nature: FileNature.IMAGE` is enforced on multipart uploads by the
|
|
1523
|
+
* default backend image analyzer. Bounds are inclusive positive integer pixels; aspect ratio
|
|
1524
|
+
* permits a 1% relative difference. Measurements use EXIF-oriented, per-frame dimensions from
|
|
1525
|
+
* image headers. Invalid declarations or unavailable/failed analysis refuse the upload.
|
|
1526
|
+
* Metadata-only remote links cannot establish geometry and are refused for these fields; upload
|
|
1527
|
+
* the image bytes instead. Browser cropping prepares an image but cannot authorize its admission.
|
|
1528
|
+
*
|
|
1529
|
+
* Type/extension checks still use the upload's declared MIME type and filename. Header geometry
|
|
1530
|
+
* does not prove complete pixel integrity, content-type authenticity or malware safety. Other
|
|
1531
|
+
* media analyzers retain their optional policies; serving headers and scanning remain separate.
|
|
1532
|
+
*
|
|
1533
|
+
* ⚠️ **`generateThumbnails` (image, PLURAL) and `generateThumbnail` (video, SINGULAR) are different
|
|
1534
|
+
* options on different bags.** The names differ by one letter and do not behave alike; read each
|
|
1535
|
+
* one's own note below rather than assuming the image semantics carry over.
|
|
1536
|
+
*
|
|
1537
|
+
* Image-specific constraints for file validation.
|
|
1538
|
+
*/
|
|
1539
|
+
export interface FileNatureConstraints_Image {
|
|
1540
|
+
minWidth?: number;
|
|
1541
|
+
maxWidth?: number;
|
|
1542
|
+
minHeight?: number;
|
|
1543
|
+
maxHeight?: number;
|
|
1544
|
+
aspectRatio?: { width: number; height: number };
|
|
1545
|
+
allowedFormats?: ImageFormat[];
|
|
1546
|
+
/**
|
|
1547
|
+
* May the serve path derive a downscaled preview rendition of this image?
|
|
1548
|
+
*
|
|
1549
|
+
* **Opt-OUT, and absence means PERMIT.** Omitting it, or setting `true`, lets `?variant=thumbnail`
|
|
1550
|
+
* return a rendition. Setting it **`false` REFUSES** that request — it does not quietly serve the
|
|
1551
|
+
* original bytes, which is what every other ineligible case does and what an author suppressing
|
|
1552
|
+
* renditions for cost or privacy is trying to avoid. A caller wanting the image anyway asks for
|
|
1553
|
+
* the original variant explicitly.
|
|
1554
|
+
*
|
|
1555
|
+
* The `{ sizes: [...] }` form reads as permission and **its sizes are not honoured**: the
|
|
1556
|
+
* derivation has one fixed longest edge. Do not author sizes expecting them to reach the renderer.
|
|
1557
|
+
*
|
|
1558
|
+
* Wired 2026-09-08 (#477's sibling, #478). Before that this flag was declared, set on the
|
|
1559
|
+
* framework's own user-avatar field, and read by nothing — so it degraded permissively: an author
|
|
1560
|
+
* who set it `false` still got thumbnails, and got no error saying so.
|
|
1561
|
+
*/
|
|
1562
|
+
generateThumbnails?: boolean | { sizes: { width: number; height: number }[] };
|
|
1563
|
+
}
|
|
1564
|
+
|
|
1565
|
+
/**
|
|
1566
|
+
* Video-specific constraints for file validation.
|
|
1567
|
+
*/
|
|
1568
|
+
export interface FileNatureConstraints_Video {
|
|
1569
|
+
maxDuration?: number; // seconds
|
|
1570
|
+
minDuration?: number;
|
|
1571
|
+
allowedFormats?: VideoFormat[];
|
|
1572
|
+
generateThumbnail?: boolean;
|
|
1573
|
+
}
|
|
1574
|
+
|
|
1575
|
+
/**
|
|
1576
|
+
* Audio-specific constraints for file validation.
|
|
1577
|
+
*/
|
|
1578
|
+
export interface FileNatureConstraints_Audio {
|
|
1579
|
+
maxDuration?: number;
|
|
1580
|
+
minDuration?: number;
|
|
1581
|
+
allowedFormats?: AudioFormat[];
|
|
1582
|
+
}
|
|
1583
|
+
|
|
1584
|
+
/**
|
|
1585
|
+
* Document-specific constraints for file validation.
|
|
1586
|
+
*/
|
|
1587
|
+
export interface FileNatureConstraints_Document {
|
|
1588
|
+
maxPages?: number;
|
|
1589
|
+
minPages?: number;
|
|
1590
|
+
}
|
|
1591
|
+
```
|
|
1592
|
+
|
|
1593
|
+
## File Vocabularies
|
|
1594
|
+
|
|
1595
|
+
The VALUES a `z_file()` field selects: which media kind (`nature`), where the bytes go
|
|
1596
|
+
(`storageAccepted`) and what a parent delete does (`onParentDelete`). Read this before choosing any
|
|
1597
|
+
of the three — three of the five storage targets have no provider, and one `onParentDelete` member
|
|
1598
|
+
does not yet behave differently from the default.
|
|
1599
|
+
|
|
1600
|
+
## Import Origins
|
|
1601
|
+
|
|
1602
|
+
- `@wildo-ai/zod-decorators`
|
|
1603
|
+
|
|
1604
|
+
## Source Excerpts
|
|
1605
|
+
|
|
1606
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1607
|
+
|
|
1608
|
+
```typescript
|
|
1609
|
+
*
|
|
1610
|
+
* The vocabularies a `z_file()` field selects from. Pick a member of each; the option bag names the
|
|
1611
|
+
* type, and these are the values.
|
|
1612
|
+
*
|
|
1613
|
+
* File nature classification, chosen with `z_file({ nature })`. It selects which per-nature
|
|
1614
|
+
* constraint bag applies and how the form control and display surface behave. `ALL` accepts any
|
|
1615
|
+
* kind and is the right answer for a generic attachment field.
|
|
1616
|
+
*/
|
|
1617
|
+
export enum FileNature {
|
|
1618
|
+
IMAGE = 'image',
|
|
1619
|
+
VIDEO = 'video',
|
|
1620
|
+
AUDIO = 'audio',
|
|
1621
|
+
PDF = 'pdf',
|
|
1622
|
+
OFFICE = 'office',
|
|
1623
|
+
ARCHIVE = 'archive',
|
|
1624
|
+
ALL = 'all',
|
|
1625
|
+
}
|
|
1626
|
+
```
|
|
1627
|
+
|
|
1628
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1629
|
+
|
|
1630
|
+
```typescript
|
|
1631
|
+
*
|
|
1632
|
+
* Where a field's bytes may be stored, chosen with `z_file({ storageAccepted: [...] })`. ORDER
|
|
1633
|
+
* EXPRESSES PREFERENCE: list several and the first CONFIGURED one is used. Omit the option entirely
|
|
1634
|
+
* and the field resolves to managed storage.
|
|
1635
|
+
*
|
|
1636
|
+
* ⚠️ **`WILDO_MANAGED`, `LOCAL_DIRECTORY` and `GOOGLE_DRIVE` have a provider behind them.** `ONEDRIVE`
|
|
1637
|
+
* and `DROPBOX` are declared vocabulary with no implementation — a field naming only those has no
|
|
1638
|
+
* configured provider, and startup configuration validation refuses the application rather than
|
|
1639
|
+
* letting it serve a field that could never accept an upload.
|
|
1640
|
+
*
|
|
1641
|
+
* `GOOGLE_DRIVE` is a VENDOR storage: the bytes live in a person's Drive and are reached through the
|
|
1642
|
+
* delegated grant of whoever linked (via the Drive picker) or uploaded them, never through an
|
|
1643
|
+
* application credential. It is "configured" when the `google-drive` provider admits a user-owned
|
|
1644
|
+
* connection. A field that accepts it is offered the Drive picker; a local pick on such a field is
|
|
1645
|
+
* uploaded INTO that person's Drive when Drive is the first configured storage in the list.
|
|
1646
|
+
*
|
|
1647
|
+
* ⚠️ **The target is decided once, when the file is created, and the object never moves.** Changing
|
|
1648
|
+
* a field's declared target changes where NEW files go; it does not relocate what is already stored.
|
|
1649
|
+
*/
|
|
1650
|
+
export enum FileStorageAccepted {
|
|
1651
|
+
WILDO_MANAGED = 'wildo_managed',
|
|
1652
|
+
LOCAL_DIRECTORY = 'local_directory',
|
|
1653
|
+
ONEDRIVE = 'onedrive',
|
|
1654
|
+
GOOGLE_DRIVE = 'google_drive',
|
|
1655
|
+
DROPBOX = 'dropbox',
|
|
1656
|
+
}
|
|
1657
|
+
```
|
|
1658
|
+
|
|
1659
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1660
|
+
|
|
1661
|
+
```typescript
|
|
1662
|
+
*
|
|
1663
|
+
* What happens to the file when its parent record is deleted, chosen with
|
|
1664
|
+
* `z_file({ onParentDelete })`. Defaults to `CASCADE`.
|
|
1665
|
+
*
|
|
1666
|
+
* ⚠️ `SOFT_DELETE` behaves IDENTICALLY to `CASCADE` at runtime today. It exists as an explicit
|
|
1667
|
+
* semantic marker for consumers that want to model a softer intent — choosing it does not currently
|
|
1668
|
+
* change what happens to the file.
|
|
1669
|
+
*
|
|
1670
|
+
* File behavior when parent resource is deleted.
|
|
1671
|
+
* - CASCADE: Mark the file deleted as part of parent removal; physical storage cleanup is deferred to the cleanup batch
|
|
1672
|
+
* - SOFT_DELETE: Same current runtime behavior as CASCADE, but keeps an explicit semantic marker for consumers that want to model softer intent
|
|
1673
|
+
* - ORPHAN: Keep file, remove association with parent
|
|
1674
|
+
*/
|
|
1675
|
+
export const FileOnParentDelete = {
|
|
1676
|
+
CASCADE: 'cascade',
|
|
1677
|
+
SOFT_DELETE: 'soft-delete',
|
|
1678
|
+
ORPHAN: 'orphan',
|
|
1679
|
+
} as const;
|
|
1680
|
+
export type FileOnParentDelete = typeof FileOnParentDelete[keyof typeof FileOnParentDelete];
|
|
1681
|
+
```
|
|
1682
|
+
|
|
1683
|
+
## File metadata and attachment readiness
|
|
1684
|
+
|
|
1685
|
+
The standard file control handles pending uploads and blocks form submission while readiness is unresolved. Custom upload controls must wait for `READY` before setting a new file reference, refresh `PROCESSING` using the metadata endpoint, and show failures without installing the rejected reference. `ATTACHED` permits retaining an existing value; it does not authorize attachment to another record. Server authorization and link checks remain authoritative.
|
|
1686
|
+
|
|
1687
|
+
## Import Origins
|
|
1688
|
+
|
|
1689
|
+
- `@wildo-ai/zod-decorators`
|
|
1690
|
+
|
|
1691
|
+
## Source Excerpts
|
|
1692
|
+
|
|
1693
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
1694
|
+
|
|
1695
|
+
```typescript
|
|
1696
|
+
*
|
|
1697
|
+
* Import FileReadiness and FileMetadata from @wildo-ai/zod-decorators.
|
|
1698
|
+
* Standard file fields wait for READY before publishing new references to forms/autosave.
|
|
1699
|
+
* Custom upload clients must inspect the returned metadata, refresh PROCESSING through
|
|
1700
|
+
* the authorized metadata endpoint, and refuse unknown or UNAVAILABLE results.
|
|
1701
|
+
* An HTTP upload success is not evidence that asynchronous scanning finished.
|
|
1702
|
+
*
|
|
1703
|
+
* Attachment readiness, distinct from storage lifecycle and download authorization.
|
|
1704
|
+
* READY may be attached; ATTACHED may be retained by its current parent, not reused elsewhere.
|
|
1705
|
+
* PROCESSING must be refreshed; UNAVAILABLE cannot be newly attached. A downloadable orphan
|
|
1706
|
+
* can still be UNAVAILABLE here. Server authorization remains authoritative for every operation.
|
|
1707
|
+
*/
|
|
1708
|
+
export enum FileReadiness {
|
|
1709
|
+
READY = 'ready',
|
|
1710
|
+
PROCESSING = 'processing',
|
|
1711
|
+
ATTACHED = 'attached',
|
|
1712
|
+
UNAVAILABLE = 'unavailable',
|
|
1713
|
+
}
|
|
1714
|
+
|
|
1715
|
+
/**
|
|
1716
|
+
* File metadata returned by the getMetadata endpoint.
|
|
1717
|
+
* This describes the uploaded file's properties.
|
|
1718
|
+
*/
|
|
1719
|
+
export type FileMetadata = {
|
|
1720
|
+
/** Server-derived attachment readiness; never infer this from an upload HTTP success. */
|
|
1721
|
+
readiness: FileReadiness;
|
|
1722
|
+
/** Unique file identifier */
|
|
1723
|
+
fileId: string;
|
|
1724
|
+
/** Original filename */
|
|
1725
|
+
filename: string;
|
|
1726
|
+
/** File size in bytes */
|
|
1727
|
+
size: number;
|
|
1728
|
+
/** MIME type */
|
|
1729
|
+
mimeType: string;
|
|
1730
|
+
/** File extension (without dot) */
|
|
1731
|
+
extension?: string;
|
|
1732
|
+
/** File checksum/hash for integrity */
|
|
1733
|
+
checksum?: string;
|
|
1734
|
+
/** URL to access/download the file */
|
|
1735
|
+
url?: string;
|
|
1736
|
+
/** URL to thumbnail (for images/videos) */
|
|
1737
|
+
thumbnailUrl?: string;
|
|
1738
|
+
/** Display nature category (image, video, audio, document, generic) */
|
|
1739
|
+
nature?: FileDisplayNature;
|
|
1740
|
+
/** Image width in pixels (for images) */
|
|
1741
|
+
width?: number;
|
|
1742
|
+
/** Image height in pixels (for images) */
|
|
1743
|
+
height?: number;
|
|
1744
|
+
/** Duration in seconds (for video/audio) */
|
|
1745
|
+
duration?: number;
|
|
1746
|
+
/** Page count (for documents) */
|
|
1747
|
+
pageCount?: number;
|
|
1748
|
+
/** Upload timestamp */
|
|
1749
|
+
uploadedAt: Date;
|
|
1750
|
+
} & FileUploaderOwnership;
|
|
1751
|
+
```
|
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# Framework System-Managed Fields API
|
|
2
|
+
|
|
3
|
+
This file exposes the field names the **framework owns** — the ones removed from every generated
|
|
4
|
+
CREATE and UPDATE contract, for every resource.
|
|
5
|
+
|
|
6
|
+
Read it before you declare a field whose name is `_id`, `createdAt`, `updatedAt`, `deletedAt`,
|
|
7
|
+
`createdByUserId` or `_version_db_doc`, and before you put any of them on a form.
|
|
8
|
+
|
|
9
|
+
Declaring one is fine and often necessary; the framework maintains the value and reads depend on it.
|
|
10
|
+
What you cannot do is accept it from a client. The field is stripped before validation runs, so:
|
|
11
|
+
|
|
12
|
+
- a create form that collects it submits a value that is silently discarded;
|
|
13
|
+
- a schema that makes it **required** rejects every create with `expected string, received
|
|
14
|
+
undefined`, and the error points at the form rather than at the rule.
|
|
15
|
+
|
|
16
|
+
That second failure is the one that costs time, because the schema looks correct while it happens.
|
|
17
|
+
The exclusion does not depend on you remembering `.excludeFromCreate()` — it is unconditional.
|
|
18
|
+
|
|
19
|
+
## Two sets, and the difference matters once
|
|
20
|
+
|
|
21
|
+
| set | members | what it means |
|
|
22
|
+
|---|---|---|
|
|
23
|
+
| system-managed | the six below | never accepted from a client, on any resource |
|
|
24
|
+
| mandatory-discard | those six **minus** `createdByUserId` | not even a trusted in-process system write can re-attach them |
|
|
25
|
+
|
|
26
|
+
`createdByUserId` sits outside the narrower set deliberately: an engine flow creating a row on
|
|
27
|
+
somebody's behalf legitimately needs to stamp it, and `preserveServerInjectedFields` is how.
|
|
28
|
+
|
|
29
|
+
## System-Managed Fields
|
|
30
|
+
|
|
31
|
+
## Import Origins
|
|
32
|
+
|
|
33
|
+
- `@wildo-ai/saas-models`
|
|
34
|
+
|
|
35
|
+
## Source Excerpts
|
|
36
|
+
|
|
37
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
38
|
+
|
|
39
|
+
```typescript
|
|
40
|
+
*
|
|
41
|
+
* The field names the framework owns. They are removed from every generated CREATE and UPDATE
|
|
42
|
+
* request contract, for every resource, whatever your schema declares and whatever a caller sends.
|
|
43
|
+
*
|
|
44
|
+
* Declaring one of these in a resource schema is fine and often necessary — the framework maintains
|
|
45
|
+
* the value. What you cannot do is accept it from a client, default it in a form, or require it on a
|
|
46
|
+
* create: the field is stripped before validation runs, so a form that collects it submits a value
|
|
47
|
+
* that is discarded, and a schema that requires it rejects every request.
|
|
48
|
+
*
|
|
49
|
+
* | field | who writes it |
|
|
50
|
+
* |---|---|
|
|
51
|
+
* | `_id` | the persistence layer (or your own `.isPrimaryKey()` field, stored beneath it) |
|
|
52
|
+
* | `createdAt` / `updatedAt` / `deletedAt` | the repository, on write |
|
|
53
|
+
* | `createdByUserId` | the repository, stamped from the execution context on CREATE, immutable afterwards |
|
|
54
|
+
* | `_version_db_doc` | the framework's optimistic-concurrency marker |
|
|
55
|
+
*
|
|
56
|
+
* The failure this prevents is quiet and was paid for once: a create form validating against a
|
|
57
|
+
* reserved field that no form collects fails every submit with `expected string, received undefined`,
|
|
58
|
+
* and the schema looks correct while it does. So the exclusion is unconditional and does not depend
|
|
59
|
+
* on the resource author remembering `.excludeFromCreate()`.
|
|
60
|
+
*
|
|
61
|
+
* ⚠️ A NARROWER set — `_id`, `createdAt`, `updatedAt`, `deletedAt`, `_version_db_doc` — is
|
|
62
|
+
* additionally *mandatory-discard*: even a trusted in-process system write cannot re-attach those
|
|
63
|
+
* through `preserveServerInjectedFields`. `createdByUserId` is deliberately not in that set, because
|
|
64
|
+
* an engine flow creating a row on somebody's behalf legitimately needs to stamp it.
|
|
65
|
+
*/
|
|
66
|
+
const SYSTEM_MANAGED_FIELDS = ['_id', 'createdAt', 'updatedAt', 'deletedAt', 'createdByUserId', '_version_db_doc'] as const;
|
|
67
|
+
```
|