@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
|
@@ -21,70 +21,122 @@ Read this when deciding WHERE a constraint belongs (field schema vs provider
|
|
|
21
21
|
```typescript
|
|
22
22
|
/**
|
|
23
23
|
* Constraints the framework's file form fields apply to the picker UI.
|
|
24
|
-
* `maxSize` is BYTES
|
|
24
|
+
* `maxSize` is BYTES; a provider's `maxFileSizeMb` is converted into it by
|
|
25
|
+
* `layerProviderFilePickerConstraints`, where the provider half is applied.
|
|
26
|
+
*
|
|
27
|
+
* An ALIAS of the contract a provider's picker component receives, not a
|
|
28
|
+
* separate interface, so the two cannot drift. They were separate for one
|
|
29
|
+
* session and the size field was spelled differently on each side — both
|
|
30
|
+
* optional, both bytes — which TypeScript accepts, because the weak-type check
|
|
31
|
+
* is satisfied by the two names that DO match. Wiring the resolver into a picker
|
|
32
|
+
* would have compiled and dropped the size cap, and a picker that accepts a file
|
|
33
|
+
* the field rejects tells the user after they have chosen it.
|
|
25
34
|
*/
|
|
26
|
-
export
|
|
27
|
-
allowedMimeTypes?: string[];
|
|
28
|
-
maxSize?: number;
|
|
29
|
-
maxFiles?: number;
|
|
30
|
-
}
|
|
35
|
+
export type ResolvedFormFieldFileProviderConstraints = ProviderFilePickerConstraints;
|
|
31
36
|
|
|
32
37
|
/**
|
|
33
|
-
*
|
|
38
|
+
* The file constraints one field declares, read from its own Zod metadata.
|
|
39
|
+
*
|
|
40
|
+
* ## It reads the SCHEMA and nothing else, since #380
|
|
34
41
|
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
42
|
+
* It used to also find a `FRONTEND_FILE_PICKER` provider — the FIRST one the
|
|
43
|
+
* registry returned — and fill the schema's gaps from that provider's
|
|
44
|
+
* `publicConfig`. That was wrong twice over once a second picker could exist:
|
|
45
|
+
* one vendor's limit governed every other vendor's picker, decided by registry
|
|
46
|
+
* order; and a vendor's picker limit also narrowed the field's own native
|
|
47
|
+
* upload, which goes to the field's own storage and has nothing to do with that
|
|
48
|
+
* vendor.
|
|
38
49
|
*
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
* fields; a single-file field never inherits a selection count.
|
|
50
|
+
* A provider's half is now laid under the field's at the picker, per provider,
|
|
51
|
+
* by `layerProviderFilePickerConstraints` in `ProviderFilePickerHost`. The
|
|
52
|
+
* precedence itself did not change: schema always wins.
|
|
43
53
|
*
|
|
44
|
-
* Templatable file fields
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
* to schema-only constraints — nothing throws.
|
|
54
|
+
* Templatable file fields are not special-cased any more either — their files
|
|
55
|
+
* are framework-materialized rather than user-picked, and with no provider half
|
|
56
|
+
* left here there is nothing to short-circuit past.
|
|
48
57
|
*/
|
|
49
58
|
export function resolveFormFieldFileProviderConstraints(input: {
|
|
50
59
|
schema: z.ZodTypeAny;
|
|
51
|
-
frontendProviderRegistry?: FrontendProviderRegistryLike;
|
|
52
60
|
}): ResolvedFormFieldFileProviderConstraints {
|
|
53
61
|
const fileMetadata = getFileMetadata(input.schema);
|
|
54
62
|
if (!fileMetadata) {
|
|
55
63
|
return {};
|
|
56
64
|
}
|
|
57
65
|
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
66
|
+
return {
|
|
67
|
+
allowedMimeTypes: fileMetadata.allowedMimeTypes,
|
|
68
|
+
maxSize: fileMetadata.maxSize,
|
|
69
|
+
maxFiles: fileMetadata.maxFiles,
|
|
70
|
+
};
|
|
71
|
+
}
|
|
72
|
+
```
|
|
65
73
|
|
|
66
|
-
|
|
67
|
-
input.frontendProviderRegistry?.findByProviderCapabilityAndProtocol?.(
|
|
68
|
-
BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER,
|
|
69
|
-
BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK,
|
|
70
|
-
) ??
|
|
71
|
-
input.frontendProviderRegistry
|
|
72
|
-
?.listByProviderCapability?.(BUILTIN_PROVIDER_CAPABILITY.FRONTEND_FILE_PICKER)
|
|
73
|
-
.find((entry) => entry.protocols.includes(BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK));
|
|
74
|
+
## File metadata and attachment readiness
|
|
74
75
|
|
|
75
|
-
|
|
76
|
-
const providerAllowedMimeTypes = readStringArray(providerConfig.acceptedMimeTypes);
|
|
77
|
-
const providerMaxSizeMb = readOptionalNumber(providerConfig.maxFileSizeMb);
|
|
78
|
-
const providerMaxSelectionCount = readOptionalNumber(providerConfig.maxSelectionCount);
|
|
76
|
+
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.
|
|
79
77
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
78
|
+
## Import Origins
|
|
79
|
+
|
|
80
|
+
- `@wildo-ai/zod-decorators`
|
|
81
|
+
|
|
82
|
+
## Source Excerpts
|
|
83
|
+
|
|
84
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
85
|
+
|
|
86
|
+
```typescript
|
|
87
|
+
*
|
|
88
|
+
* Import FileReadiness and FileMetadata from @wildo-ai/zod-decorators.
|
|
89
|
+
* Standard file fields wait for READY before publishing new references to forms/autosave.
|
|
90
|
+
* Custom upload clients must inspect the returned metadata, refresh PROCESSING through
|
|
91
|
+
* the authorized metadata endpoint, and refuse unknown or UNAVAILABLE results.
|
|
92
|
+
* An HTTP upload success is not evidence that asynchronous scanning finished.
|
|
93
|
+
*
|
|
94
|
+
* Attachment readiness, distinct from storage lifecycle and download authorization.
|
|
95
|
+
* READY may be attached; ATTACHED may be retained by its current parent, not reused elsewhere.
|
|
96
|
+
* PROCESSING must be refreshed; UNAVAILABLE cannot be newly attached. A downloadable orphan
|
|
97
|
+
* can still be UNAVAILABLE here. Server authorization remains authoritative for every operation.
|
|
98
|
+
*/
|
|
99
|
+
export enum FileReadiness {
|
|
100
|
+
READY = 'ready',
|
|
101
|
+
PROCESSING = 'processing',
|
|
102
|
+
ATTACHED = 'attached',
|
|
103
|
+
UNAVAILABLE = 'unavailable',
|
|
89
104
|
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* File metadata returned by the getMetadata endpoint.
|
|
108
|
+
* This describes the uploaded file's properties.
|
|
109
|
+
*/
|
|
110
|
+
export type FileMetadata = {
|
|
111
|
+
/** Server-derived attachment readiness; never infer this from an upload HTTP success. */
|
|
112
|
+
readiness: FileReadiness;
|
|
113
|
+
/** Unique file identifier */
|
|
114
|
+
fileId: string;
|
|
115
|
+
/** Original filename */
|
|
116
|
+
filename: string;
|
|
117
|
+
/** File size in bytes */
|
|
118
|
+
size: number;
|
|
119
|
+
/** MIME type */
|
|
120
|
+
mimeType: string;
|
|
121
|
+
/** File extension (without dot) */
|
|
122
|
+
extension?: string;
|
|
123
|
+
/** File checksum/hash for integrity */
|
|
124
|
+
checksum?: string;
|
|
125
|
+
/** URL to access/download the file */
|
|
126
|
+
url?: string;
|
|
127
|
+
/** URL to thumbnail (for images/videos) */
|
|
128
|
+
thumbnailUrl?: string;
|
|
129
|
+
/** Display nature category (image, video, audio, document, generic) */
|
|
130
|
+
nature?: FileDisplayNature;
|
|
131
|
+
/** Image width in pixels (for images) */
|
|
132
|
+
width?: number;
|
|
133
|
+
/** Image height in pixels (for images) */
|
|
134
|
+
height?: number;
|
|
135
|
+
/** Duration in seconds (for video/audio) */
|
|
136
|
+
duration?: number;
|
|
137
|
+
/** Page count (for documents) */
|
|
138
|
+
pageCount?: number;
|
|
139
|
+
/** Upload timestamp */
|
|
140
|
+
uploadedAt: Date;
|
|
141
|
+
} & FileUploaderOwnership;
|
|
90
142
|
```
|
|
@@ -24,16 +24,37 @@ Read this when authoring or editing a provider module under
|
|
|
24
24
|
* Import from `@wildo-ai/external-connectors-public/app`. The module is a
|
|
25
25
|
* plain object — no class, no registration call: the app re-exports it
|
|
26
26
|
* through its `./frontend-providers` package entry and appends a matching
|
|
27
|
-
* companion contribution; the framework
|
|
28
|
-
*
|
|
27
|
+
* companion contribution; the framework joins it with the provider's hydrated
|
|
28
|
+
* entry on first paint.
|
|
29
29
|
*
|
|
30
30
|
* NEVER put a secret in this object — it ships to the browser. `publicConfig`
|
|
31
31
|
* is the only channel for public runtime configuration (publishable keys,
|
|
32
|
-
* client IDs, picker constraints)
|
|
33
|
-
*
|
|
34
|
-
* translation-ready
|
|
35
|
-
*
|
|
36
|
-
*
|
|
32
|
+
* client IDs, picker constraints). Author `metadata` ONLY through
|
|
33
|
+
* `defineProviderMetadata({ ref, packageName, tier, origin })` (#328): it
|
|
34
|
+
* derives the translation-ready display-name key and records the provider's
|
|
35
|
+
* identity — package, tier (an application-owned file picker is CATALOGUE: it
|
|
36
|
+
* binds no engine slot), vendor and origin. Never a frozen localized string,
|
|
37
|
+
* never a hand-written identity.
|
|
38
|
+
*
|
|
39
|
+
* ## Two channels, and which fields ride which
|
|
40
|
+
*
|
|
41
|
+
* `metadata`, `providerCapabilities`, `protocols`, `publicConfig`, `csp` and
|
|
42
|
+
* `scripts` are DATA: they are projected onto the provider's entry, travel as
|
|
43
|
+
* JSON, and are what the CLI reads when it composes the service's
|
|
44
|
+
* Content-Security-Policy — it cannot execute this module, because it is a Node
|
|
45
|
+
* process and this module is browser-bound.
|
|
46
|
+
*
|
|
47
|
+
* `sdk.activate` and `publicConfigSchema` are CODE. They reach a bundle only
|
|
48
|
+
* because the bundle imports this module, through the generated
|
|
49
|
+
* `frontend-providers.generated.ts` that `wildo config sync` writes for each
|
|
50
|
+
* frontend service. They are never serialized; a JSON channel would drop them
|
|
51
|
+
* without a word.
|
|
52
|
+
*
|
|
53
|
+
* A worked module declaring every field is in
|
|
54
|
+
* `frontend-app-provider.example.ts`, beside this file. It lives there rather
|
|
55
|
+
* than in an `@example` block here because the package's typecheck compiles it:
|
|
56
|
+
* the inline version shipped for a session showing three of the CSP footprint's
|
|
57
|
+
* six buckets while the type required all six, and nothing caught it.
|
|
37
58
|
*/
|
|
38
59
|
export interface FrontendAppProviderModule {
|
|
39
60
|
metadata: ProviderMetadata;
|
|
@@ -42,9 +63,220 @@ export interface FrontendAppProviderModule {
|
|
|
42
63
|
/**
|
|
43
64
|
* Public configuration the frontend needs at runtime. Strongly typed
|
|
44
65
|
* via per-providerCapability shapes downstream — the registry stores
|
|
45
|
-
* them as `unknown` so the registry shape stays
|
|
46
|
-
*
|
|
66
|
+
* them as `unknown` so the registry shape stays independent of any one
|
|
67
|
+
* provider's config shape. Declare `publicConfigSchema`
|
|
68
|
+
* beside it to have the framework validate it once, at hydration,
|
|
69
|
+
* instead of each use site coercing it by hand.
|
|
47
70
|
*/
|
|
48
71
|
publicConfig?: Readonly<Record<string, unknown>>;
|
|
72
|
+
/**
|
|
73
|
+
* Origins this provider needs the SaaS app's composed CSP to admit.
|
|
74
|
+
*
|
|
75
|
+
* DATA: projected onto the provider entry and read by `resolveCspPolicy`'s
|
|
76
|
+
* provider layer, per service and per environment. Declaring it here is what
|
|
77
|
+
* removes the alternative — hand-editing script / frame / connect origins in
|
|
78
|
+
* every application's config, for every environment.
|
|
79
|
+
*
|
|
80
|
+
* Name only the buckets you reach; the framework fills in the rest. For an
|
|
81
|
+
* endpoint you CANNOT know — one the application configures, such as a
|
|
82
|
+
* monitoring DSN, an analytics host, a self-hosted deployment — declare where
|
|
83
|
+
* it lives instead of guessing what it is:
|
|
84
|
+
*
|
|
85
|
+
* ```ts
|
|
86
|
+
* csp: {
|
|
87
|
+
* derivedOrigins: [
|
|
88
|
+
* { publicConfigKey: 'dsn', bucket: ProviderFrontendCspOriginBucket.CONNECT },
|
|
89
|
+
* ],
|
|
90
|
+
* }
|
|
91
|
+
* ```
|
|
92
|
+
*
|
|
93
|
+
* The framework reads that key out of your own `publicConfig` and takes its
|
|
94
|
+
* URL origin. That is what stops an application authoring the same host twice
|
|
95
|
+
* — once as your configuration, once in its CSP — where the copy that drifts
|
|
96
|
+
* fails only in production, because development is report-only.
|
|
97
|
+
*/
|
|
98
|
+
csp?: ProviderFrontendCspFootprintDeclaration;
|
|
99
|
+
/**
|
|
100
|
+
* Third-party `<script>` tags the surface must add for this provider — the
|
|
101
|
+
* case a dynamic `import()` cannot serve, because the vendor ships a
|
|
102
|
+
* global-installing tag rather than an npm module.
|
|
103
|
+
*
|
|
104
|
+
* DATA. Each declared `src`'s origin MUST also appear in `csp.scriptOrigins`
|
|
105
|
+
* — `projectFrontendProviderContribution` refuses the provider otherwise,
|
|
106
|
+
* because the policy it contributes to would block its own script, and only
|
|
107
|
+
* where CSP enforces, so the failure would first appear in production.
|
|
108
|
+
*/
|
|
109
|
+
scripts?: ReadonlyArray<ProviderFrontendScriptDeclaration>;
|
|
110
|
+
/**
|
|
111
|
+
* The provider's vendor SDK: which package (DATA) and how to load and start
|
|
112
|
+
* it (CODE).
|
|
113
|
+
*
|
|
114
|
+
* `activate` must reach its package through a DYNAMIC `import()`, so the SDK
|
|
115
|
+
* is a separate chunk and no page pays for a provider it does not use.
|
|
116
|
+
*/
|
|
117
|
+
sdk?: ProviderFrontendSdk;
|
|
118
|
+
/**
|
|
119
|
+
* Components this provider contributes, keyed by the capability each fills
|
|
120
|
+
* and loaded on demand. CODE: it reaches a bundle only through the generated
|
|
121
|
+
* `frontend-providers.generated.ts`, never through the JSON entry.
|
|
122
|
+
*
|
|
123
|
+
* Several providers may offer a component for ONE capability — two file
|
|
124
|
+
* pickers, two meeting embeds — and that is the point: the surface presents
|
|
125
|
+
* the choice rather than silently taking whichever the registry happened to
|
|
126
|
+
* index first.
|
|
127
|
+
*/
|
|
128
|
+
components?: ProviderFrontendComponents;
|
|
129
|
+
/**
|
|
130
|
+
* The `z_file` storage this provider's file picker fronts (#394 P5). Declare
|
|
131
|
+
* it when the picker delivers a `REMOTE_REFERENCE`: the bytes stay at the
|
|
132
|
+
* vendor, so the FILES row lands in this storage and only a field whose
|
|
133
|
+
* `storageAccepted` names it may receive the link. Leave it undeclared for a
|
|
134
|
+
* picker that delivers bytes — those are ingested into the field's own
|
|
135
|
+
* storage and offered to every field.
|
|
136
|
+
*
|
|
137
|
+
* The backend serves the same storage through an `IFileStorageProvider`
|
|
138
|
+
* keyed by this member that names this provider back as its
|
|
139
|
+
* `connectedProviderRef`; the framework pins the two declarations equal.
|
|
140
|
+
*/
|
|
141
|
+
fileStorage?: FileStorageAccepted;
|
|
142
|
+
/**
|
|
143
|
+
* Validator for this provider's own `publicConfig`, as a Standard Schema v1
|
|
144
|
+
* value (a Zod 4 schema satisfies it as-is).
|
|
145
|
+
*
|
|
146
|
+
* CODE, and the answer to a real defect: `publicConfig` is
|
|
147
|
+
* `Record<string, unknown>`, and each consuming site was coercing it by hand,
|
|
148
|
+
* so a renamed key yielded `undefined` and a silently wrong provider. With a
|
|
149
|
+
* schema declared, the framework validates once at hydration and a mismatch
|
|
150
|
+
* says which key and why.
|
|
151
|
+
*/
|
|
152
|
+
publicConfigSchema?: ProviderFrontendPublicConfigSchema;
|
|
153
|
+
/**
|
|
154
|
+
* The vendor's deployment model, processing regions and legal entity — the primitives a
|
|
155
|
+
* processor register and a transfer statement are derived from.
|
|
156
|
+
*
|
|
157
|
+
* OPTIONAL, matching the backend contract, because a provider whose author has not stated them
|
|
158
|
+
* must still load. Absent means the APPLICATION has to declare them on its own register entry,
|
|
159
|
+
* where its contract with the vendor makes them checkable.
|
|
160
|
+
*
|
|
161
|
+
* Why a FRONTEND provider needs this at least as much as a backend one (#345): this module
|
|
162
|
+
* executes in the DATA SUBJECT'S BROWSER. It loads third-party script, may set storage, and
|
|
163
|
+
* talks to the vendor directly — the application's backend never sees the call. Product
|
|
164
|
+
* analytics, error monitoring, a captcha and a payment element are precisely the third-party
|
|
165
|
+
* recipients a privacy notice has to name, and the operator controls them LESS than a backend
|
|
166
|
+
* provider routed through their own infrastructure.
|
|
167
|
+
*
|
|
168
|
+
* See `ProviderComplianceProfileSchema` for each field's meaning and for the refusal that a
|
|
169
|
+
* `VENDOR_HOSTED` provider declaring no region cannot support a transfer statement.
|
|
170
|
+
*/
|
|
171
|
+
complianceProfile?: ProviderComplianceProfile;
|
|
49
172
|
}
|
|
50
173
|
```
|
|
174
|
+
|
|
175
|
+
## A worked module, compiled
|
|
176
|
+
|
|
177
|
+
Every field above on one provider — the partial CSP footprint, a vendor script
|
|
178
|
+
tag with its subresource-integrity hash, and an SDK whose `activate` owns both
|
|
179
|
+
the dynamic import and the vendor's own start-up call. It is a compiled source
|
|
180
|
+
file, not prose, so it cannot describe a shape the contract no longer accepts.
|
|
181
|
+
|
|
182
|
+
|
|
183
|
+
## Usage Example
|
|
184
|
+
|
|
185
|
+
```typescript
|
|
186
|
+
/**
|
|
187
|
+
* A file-picker provider for the main SaaS-app frontend.
|
|
188
|
+
*
|
|
189
|
+
* Everything here is DATA except `sdk.activate`, and that split is the contract:
|
|
190
|
+
* the CLI composes this service's Content-Security-Policy from the declaration
|
|
191
|
+
* below WITHOUT executing any of it — it is a Node process and this module is
|
|
192
|
+
* browser-bound — while `activate` runs only in a browser, only when the
|
|
193
|
+
* provider is used.
|
|
194
|
+
*/
|
|
195
|
+
export const AcmePickerFrontendAppProvider: FrontendAppProviderModule = {
|
|
196
|
+
// Never a hand-written identity and never a frozen localized string:
|
|
197
|
+
// `defineProviderMetadata` derives the display-name label key and records the
|
|
198
|
+
// tier. An application-owned picker is CATALOGUE — it binds no engine slot.
|
|
199
|
+
metadata: defineProviderMetadata({
|
|
200
|
+
ref: 'acme-picker',
|
|
201
|
+
packageName: '@wildo-ai/provider-acme-picker',
|
|
202
|
+
tier: ProviderTier.CATALOGUE,
|
|
203
|
+
origin: ENGINE_PROVIDER_ORIGIN,
|
|
204
|
+
}),
|
|
205
|
+
providerCapabilities: ['FRONTEND_FILE_PICKER'],
|
|
206
|
+
protocols: [BUILTIN_PROVIDER_PROTOCOL.FRONTEND_SDK],
|
|
207
|
+
|
|
208
|
+
// Public configuration only — this object ships to the browser. A publishable
|
|
209
|
+
// key or a client id belongs here; a secret never does.
|
|
210
|
+
publicConfig: { clientId: 'acme-public-client-id' },
|
|
211
|
+
|
|
212
|
+
// Name only the buckets this provider reaches; the framework fills in the
|
|
213
|
+
// rest. Which CSP directive grades which bucket is framework knowledge, so a
|
|
214
|
+
// provider author never has to learn the directive taxonomy — and declaring
|
|
215
|
+
// it here is what removes the alternative: hand-editing origins in every
|
|
216
|
+
// application's config, for every environment, where a mistake is invisible
|
|
217
|
+
// until production because development is report-only.
|
|
218
|
+
csp: {
|
|
219
|
+
scriptOrigins: ['https://js.acme.com'],
|
|
220
|
+
frameOrigins: ['https://picker.acme.com'],
|
|
221
|
+
connectOrigins: ['https://api.acme.com'],
|
|
222
|
+
},
|
|
223
|
+
|
|
224
|
+
// For a vendor that installs a global through a tag rather than shipping an
|
|
225
|
+
// npm module. `integrity` requires `crossOrigin` beside it, or the browser
|
|
226
|
+
// skips the check and the hash protects nothing.
|
|
227
|
+
scripts: [
|
|
228
|
+
{
|
|
229
|
+
src: 'https://js.acme.com/picker-tag.js',
|
|
230
|
+
integrity: 'sha384-EXAMPLE-REPLACE-WITH-THE-VENDOR-PUBLISHED-HASH',
|
|
231
|
+
crossOrigin: ProviderFrontendScriptCrossOrigin.ANONYMOUS,
|
|
232
|
+
},
|
|
233
|
+
],
|
|
234
|
+
|
|
235
|
+
sdk: {
|
|
236
|
+
// The DATA half: which package. Read by tooling, by the bundle-isolation
|
|
237
|
+
// policy, and by anyone asking why a bundle grew.
|
|
238
|
+
descriptor: { packageName: '@acme/picker-web' },
|
|
239
|
+
|
|
240
|
+
// The CODE half. It owns BOTH the load and the vendor's own start-up call,
|
|
241
|
+
// as one function — otherwise every surface would grow a switch over
|
|
242
|
+
// vendors.
|
|
243
|
+
async activate({ publicConfig }) {
|
|
244
|
+
// A real provider writes `const { createPicker } = await import('@acme/picker-web');`
|
|
245
|
+
// — a DYNAMIC import, which is what makes the SDK a separate chunk in all
|
|
246
|
+
// three bundlers and what lets the bundle-isolation policy tell a declared
|
|
247
|
+
// optional dependency from a static one. This example cannot name a
|
|
248
|
+
// package it does not depend on, so only that line is stood in for;
|
|
249
|
+
// everything around it is verbatim.
|
|
250
|
+
const createPicker = (options: { clientId: string }) => ({
|
|
251
|
+
options,
|
|
252
|
+
destroy: (): void => undefined,
|
|
253
|
+
});
|
|
254
|
+
|
|
255
|
+
const picker = createPicker({ clientId: String(publicConfig.clientId) });
|
|
256
|
+
|
|
257
|
+
// Declare `deactivate` whenever the vendor offers a teardown: an SDK that
|
|
258
|
+
// can be started and never stopped cannot honour a consent withdrawal,
|
|
259
|
+
// and accumulates one live client per hot reload.
|
|
260
|
+
return { handle: picker, deactivate: () => picker.destroy() };
|
|
261
|
+
},
|
|
262
|
+
},
|
|
263
|
+
|
|
264
|
+
// A frontend provider runs in the DATA SUBJECT'S BROWSER and reaches the vendor
|
|
265
|
+
// directly, so it is a third-party recipient the application's processor register
|
|
266
|
+
// and privacy notice must name. Declaring the profile is what makes a transfer
|
|
267
|
+
// statement derivable instead of hand-written.
|
|
268
|
+
//
|
|
269
|
+
// `vendorLegalEntityName` is optional, and absent is a real answer: it means the
|
|
270
|
+
// APPLICATION states the entity on its own register entry, where its contract with
|
|
271
|
+
// the vendor makes it checkable. Prefer absent over a guess — a stale entity
|
|
272
|
+
// published as current is worse than a missing one.
|
|
273
|
+
//
|
|
274
|
+
// A VENDOR_HOSTED provider MUST name at least one processing region; the schema
|
|
275
|
+
// refuses otherwise, because without one no transfer statement about it exists.
|
|
276
|
+
complianceProfile: {
|
|
277
|
+
deploymentModels: [ProviderDeploymentModel.VENDOR_HOSTED],
|
|
278
|
+
processingRegions: ['eu-west-1', 'us-east-1'],
|
|
279
|
+
vendorLegalEntityName: 'Acme Corporation',
|
|
280
|
+
},
|
|
281
|
+
};
|
|
282
|
+
```
|
|
@@ -0,0 +1,196 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: provider-operation-calls
|
|
3
|
+
description: Call a connected third-party provider's operation — from a backend service through the provider's generated typed client, or from a frontend component through the authenticated browser door that only opens for operations the application declares in `providers.browserOperations`. Use when the user says "call the Slack API from my service", "post to a vendor from the backend", "use the generated provider client", "call a provider operation from a component", "my component needs data from a third-party API", "let the user pick a workspace", "load the choices for a provider input", "PROVIDER_OPERATION_REFUSED", or "not_browser_reachable".
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Calling Provider Operations
|
|
7
|
+
|
|
8
|
+
### Target Application Framing
|
|
9
|
+
|
|
10
|
+
This knowledge is for configuring behavior in the target application.
|
|
11
|
+
Wildo is the framework surface being used, not the product being built.
|
|
12
|
+
|
|
13
|
+
Read and apply these patterns from the application-developer point of view:
|
|
14
|
+
|
|
15
|
+
- how the application should configure the relevant app-level file
|
|
16
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
17
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
18
|
+
|
|
19
|
+
|
|
20
|
+
## Overview
|
|
21
|
+
|
|
22
|
+
An installed, scoped provider (see `provider-backend-package`) exposes OPERATIONS — `createContact`,
|
|
23
|
+
`sendMessage` — that always run on the BACKEND, so the credential never leaves it. There are two ways
|
|
24
|
+
in, and they answer different callers:
|
|
25
|
+
|
|
26
|
+
1. **A backend service** calls the provider's generated typed client, fed by the executor's
|
|
27
|
+
`forExecution(executionContext)`. The compiler checks the arguments.
|
|
28
|
+
2. **A frontend component** calls `executeProviderOperation`, which reaches an authenticated backend
|
|
29
|
+
route. It runs ONLY operations the application lists in `providers.browserOperations`, for the
|
|
30
|
+
connections and roles listed there. Everything else is refused, and the refusal is audited.
|
|
31
|
+
|
|
32
|
+
Both paths record every executed call against the real initiating user, and both name WHOSE account
|
|
33
|
+
is spent: the application's own (the default), an organization's, or the person's own.
|
|
34
|
+
|
|
35
|
+
## App Paths
|
|
36
|
+
|
|
37
|
+
| Surface | Glob (relative to app root) |
|
|
38
|
+
|---|---|
|
|
39
|
+
| Backend service calling a provider | `backend-api/src/**/*.backend.service.ts` |
|
|
40
|
+
| Generated client import | the vendor's subpath of `@wildo-ai/providers` — `@wildo-ai/providers/slack` exports `createSlackClient` |
|
|
41
|
+
| Browser reachability policy | `wildo.saas.config.ts` → `providers.browserOperations.<ref>.<operationId>` |
|
|
42
|
+
| Which connections the product offers | `wildo.saas.config.ts` → `providers.connections.<ref>` |
|
|
43
|
+
| Component calling the browser door | `frontend/src/**/*.tsx` |
|
|
44
|
+
|
|
45
|
+
## When to Use
|
|
46
|
+
|
|
47
|
+
- A backend service needs to read from or write to a connected vendor.
|
|
48
|
+
- A component needs a vendor's answer and must not hold the vendor credential.
|
|
49
|
+
- A component receives `403 PROVIDER_OPERATION_REFUSED` and you need to know why.
|
|
50
|
+
- An operation answers CSV/XML or nothing, or uploads raw bytes.
|
|
51
|
+
|
|
52
|
+
## When NOT to Use
|
|
53
|
+
|
|
54
|
+
- Installing or scoping the provider in the first place — `provider-backend-package`.
|
|
55
|
+
- Reading a vendor's records INTO a resource (listing, syncing) — `resource-external-data`.
|
|
56
|
+
- A browser-side SDK or picker that must run in the browser — `provider-frontend-file-picker`.
|
|
57
|
+
|
|
58
|
+
## Workflow
|
|
59
|
+
|
|
60
|
+
### Step 1 — Choose the caller
|
|
61
|
+
|
|
62
|
+
Logic that runs in the backend (a hook, a batch, a custom operation): **typed client**, Step 2. A
|
|
63
|
+
component that needs the answer on screen: **browser door**, Steps 3–4. Prefer the backend when the
|
|
64
|
+
call is a side effect of something the backend already does — it needs no policy and exposes nothing.
|
|
65
|
+
|
|
66
|
+
### Step 2 — Backend: call through the typed client
|
|
67
|
+
|
|
68
|
+
Inject `SAAS_SERVICE_TYPES.ProviderOperationExecutorService`, build the client with
|
|
69
|
+
`create<Vendor>Client(executor.forExecution(executionContext))`, and pass the connection as the
|
|
70
|
+
second argument. Read `references/framework-provider-operation-executor-api.md`. Use the context of
|
|
71
|
+
the request being served — never a synthesised one — or the call is attributed to nobody.
|
|
72
|
+
|
|
73
|
+
### Step 3 — Browser: declare the operation
|
|
74
|
+
|
|
75
|
+
Add `providers.browserOperations.<ref>.<operationId>` to `wildo.saas.config.ts`, listing the
|
|
76
|
+
`connections` a browser may spend and, where it matters, `allowedRoles`. Declaring an
|
|
77
|
+
application-owned connection REQUIRES roles. Read `references/framework-browser-operation-policy-api.md`,
|
|
78
|
+
then run `wildo config sync`.
|
|
79
|
+
|
|
80
|
+
### Step 4 — Browser: call it from the component
|
|
81
|
+
|
|
82
|
+
`getManualCallsHttpClient().executeProviderOperation<TOutput>(ref, operationId, { connection, input })`
|
|
83
|
+
returns `{ status, output }`. Handle a 403 by its `reason` — `references/browser-door-answers.md`
|
|
84
|
+
lists every answer and its fix. Read `references/framework-frontend-execute-operation-api.md`.
|
|
85
|
+
|
|
86
|
+
### Step 4b — Browser: let a person pick an input from its account's choices
|
|
87
|
+
|
|
88
|
+
An input such as a workspace or a project is a choice WITHIN the connected account, so it is picked per
|
|
89
|
+
call from what that account can see — never stored on the connection. An operation declares where each
|
|
90
|
+
such input's choices come from (`inputOptions` on the operation, see
|
|
91
|
+
`references/framework-rest-operation-contract-api.md`). Declare the OPTIONS operation in
|
|
92
|
+
`providers.browserOperations` too, with the same connections, then call
|
|
93
|
+
`getManualCallsHttpClient().loadProviderOperationInputOptions(ref, operationId, inputField, { connection, input })`,
|
|
94
|
+
which returns `{ optionsOperationId, options: [{ value, label }] }`. Pass a choice the list depends on
|
|
95
|
+
(Asana's projects depend on the workspace) in `input`; without it the answer is a 400 naming it.
|
|
96
|
+
|
|
97
|
+
### Step 5 — Non-JSON answers and binary bodies
|
|
98
|
+
|
|
99
|
+
A hand-authored operation declares `responseDecoding: TEXT` for CSV/XML or `NONE` for a 204, and
|
|
100
|
+
`requestBody.encoding: BINARY` with a `contentType` for bytes. Read
|
|
101
|
+
`references/framework-rest-operation-contract-api.md`. Then stop — or hand back to the task that needed
|
|
102
|
+
the call.
|
|
103
|
+
|
|
104
|
+
## Worked Example
|
|
105
|
+
|
|
106
|
+
A backend service searching an organization's own connected Slack workspace:
|
|
107
|
+
|
|
108
|
+
|
|
109
|
+
## Usage Example
|
|
110
|
+
|
|
111
|
+
```typescript
|
|
112
|
+
// import { createSlackClient } from '@wildo-ai/providers/slack';
|
|
113
|
+
//
|
|
114
|
+
// Inject the executor with `@inject(SAAS_SERVICE_TYPES.ProviderOperationExecutorService)`.
|
|
115
|
+
export async function findDealMentions(
|
|
116
|
+
providerOperations: ProviderOperationExecutorBackendService,
|
|
117
|
+
executionContext: ExecutionContext<any>,
|
|
118
|
+
organizationId: string,
|
|
119
|
+
dealName: string,
|
|
120
|
+
): Promise<unknown> {
|
|
121
|
+
// `forExecution` binds the caller's execution context: the call is authorized and audited as THEM.
|
|
122
|
+
const slack = createSlackClient(providerOperations.forExecution(executionContext));
|
|
123
|
+
|
|
124
|
+
// The second argument names WHOSE ACCOUNT is spent. Omitted, it is the application's own; here it is
|
|
125
|
+
// the organization's own connected workspace, which the caller must belong to organization-wide.
|
|
126
|
+
return slack.searchMessages(
|
|
127
|
+
{ query: dealName },
|
|
128
|
+
{
|
|
129
|
+
ownerScope: ExternalProvider_Connection_OwnerScope.ORGANIZATION,
|
|
130
|
+
ownerId: organizationId,
|
|
131
|
+
delegation: ExternalProvider_Connection_DelegationMode.SERVICE,
|
|
132
|
+
},
|
|
133
|
+
);
|
|
134
|
+
}
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
- `forExecution(executionContext)` is the whole of the wiring: authorization, the per-provider rate
|
|
138
|
+
budget and the audit row all follow from it.
|
|
139
|
+
- The connection names the ORGANIZATION'S account. The executor checks the caller belongs to that
|
|
140
|
+
organization organization-wide before spending anything.
|
|
141
|
+
- The return type follows what the operation's source described: a declared answer is typed with every
|
|
142
|
+
field optional (a vendor adding a field never breaks the call), and an undescribed one — like this
|
|
143
|
+
one — is `unknown`, which is honest rather than a guess.
|
|
144
|
+
|
|
145
|
+
## References
|
|
146
|
+
|
|
147
|
+
- `references/framework-provider-operation-executor-api.md` — the executor, `forExecution`, `execute` (source-backed)
|
|
148
|
+
- `references/framework-browser-operation-policy-api.md` — `providers.browserOperations` (source-backed)
|
|
149
|
+
- `references/framework-rest-operation-contract-api.md` — the operation declaration, decodings, encodings (source-backed)
|
|
150
|
+
- `references/framework-frontend-execute-operation-api.md` — the component-side call (source-backed)
|
|
151
|
+
- `references/browser-door-answers.md` — every refusal and failure status, and what to do about each
|
|
152
|
+
|
|
153
|
+
## Verification
|
|
154
|
+
|
|
155
|
+
- [ ] Backend calls use `forExecution` with the request's own execution context
|
|
156
|
+
- [ ] No vendor credential, token or API key is read or passed by application code
|
|
157
|
+
- [ ] Every browser-called operation is listed in `providers.browserOperations`
|
|
158
|
+
- [ ] A policy admitting an `application` connection declares `allowedRoles`
|
|
159
|
+
- [ ] Components handle a 403 by `reason`, not by message text
|
|
160
|
+
- [ ] `wildo config sync` ran after changing `providers.browserOperations`
|
|
161
|
+
- [ ] Every options operation an input picker calls is itself listed in `providers.browserOperations`
|
|
162
|
+
|
|
163
|
+
### Grep invariants
|
|
164
|
+
|
|
165
|
+
| Invariant | Command |
|
|
166
|
+
|---|---|
|
|
167
|
+
| Clients are built from `forExecution` | `rg -n "Client\(" backend-api/src \| rg -v forExecution` (review each hit) |
|
|
168
|
+
| No credential handled in application code | `rg -in "accessToken\|apiKey\|botToken" backend-api/src frontend/src` (must be empty) |
|
|
169
|
+
| Browser calls name declared operations | `rg -n "executeProviderOperation" frontend/src` then check each against `rg -n "browserOperations" wildo.saas.config.ts` |
|
|
170
|
+
| No component calls a vendor directly | `rg -n "fetch\(['\"]https://" frontend/src` (must be empty) |
|
|
171
|
+
|
|
172
|
+
## Common Rationalizations
|
|
173
|
+
|
|
174
|
+
| Rationalization | Reality |
|
|
175
|
+
|---|---|
|
|
176
|
+
| "I'll call the vendor's API from the component with a token" | The token then lives in every browser that loads the app. The door exists so the credential never leaves the backend. |
|
|
177
|
+
| "Listing each operation is tedious; allow the whole provider" | There is no such switch, on purpose: a READ still spends a tenant's credential and returns whatever the vendor holds. One declaration per operation is the review. |
|
|
178
|
+
| "Any signed-in user may use the app's account" | Only if `allowedRoles` says who. The config refuses an application-owned connection without roles. |
|
|
179
|
+
| "I'll build an execution context for the call" | A synthesised context has no real roles or identity: organization targets are refused and the audit row names nobody. Use the request's. |
|
|
180
|
+
| "The vendor returns CSV; I'll parse around the JSON error" | Declare `responseDecoding: TEXT`; the output is the CSV string. |
|
|
181
|
+
| "I'll store the chosen workspace on the connection" | A workspace is a choice per call within the account; load it with `loadProviderOperationInputOptions` and pass it as input. The connection only records what the vendor reported at authorization. |
|
|
182
|
+
|
|
183
|
+
## Red Flags
|
|
184
|
+
|
|
185
|
+
- A vendor token, key or secret in application code (catch with the **no credential** grep)
|
|
186
|
+
- A component `fetch` to a vendor host (catch with the **no component calls a vendor** grep)
|
|
187
|
+
- A client built from something other than `forExecution` (catch with the **built from `forExecution`** grep)
|
|
188
|
+
- `executeProviderOperation` naming an operation absent from `providers.browserOperations` (catch with the **declared operations** grep)
|
|
189
|
+
- A 403 handled by matching its message text instead of `reason`
|
|
190
|
+
|
|
191
|
+
## Related Skills
|
|
192
|
+
|
|
193
|
+
- `provider-backend-package` — install and scope the provider before calling it
|
|
194
|
+
- `resource-external-data` — read a vendor's records into resources instead of calling ad hoc
|
|
195
|
+
- `backend-custom-operation` — a custom operation is the usual home of a backend provider call
|
|
196
|
+
- `provider-frontend-file-picker` — browser-side provider modules that genuinely run in the browser
|