@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
package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md
ADDED
|
@@ -0,0 +1,242 @@
|
|
|
1
|
+
# Which third-party identity a provider call acts as
|
|
2
|
+
|
|
3
|
+
How one application serving many organizations lets each of them act as its **own** third-party
|
|
4
|
+
principal — its own Slack token, its own CRM key — instead of sharing the deployment's single one,
|
|
5
|
+
and how it says so explicitly at each call.
|
|
6
|
+
|
|
7
|
+
Read this when:
|
|
8
|
+
|
|
9
|
+
- each customer must connect their own vendor account;
|
|
10
|
+
- an integration works but acts as the wrong third-party identity;
|
|
11
|
+
- you are deciding whether a provider secret belongs in the environment or on the tenant;
|
|
12
|
+
- a provider call refuses naming an environment variable, a tenant that has not connected, or a
|
|
13
|
+
credential stored under a retired slot.
|
|
14
|
+
|
|
15
|
+
Note the boundary this does **not** cross: provider SELECTION — which module fills an engine
|
|
16
|
+
capability — stays per capability and per scope, application-wide. What varies per call is the
|
|
17
|
+
CREDENTIAL used when calling the one selected provider.
|
|
18
|
+
|
|
19
|
+
## The target is the decision
|
|
20
|
+
|
|
21
|
+
Every resolution names a `ExternalProvider_ConnectionTarget`: `ownerScope` × `delegation`. Those are
|
|
22
|
+
four different principals, not four spellings of one:
|
|
23
|
+
|
|
24
|
+
| target | whose credential is spent |
|
|
25
|
+
|---|---|
|
|
26
|
+
| `APPLICATION` × `SERVICE` | the deployment's own, from the environment |
|
|
27
|
+
| `ORGANIZATION` × `SERVICE` | that tenant's connected account |
|
|
28
|
+
| `ORGANIZATION` × `USER` | a member's own account, lent to their organization |
|
|
29
|
+
| `USER` × `SERVICE` / `USER` | that one person's account |
|
|
30
|
+
|
|
31
|
+
`APPLICATION` × `USER` is refused by name: impersonating a person with the application's own identity
|
|
32
|
+
needs a vendor-side impersonation grant that nothing stores.
|
|
33
|
+
|
|
34
|
+
## Nothing is ever substituted
|
|
35
|
+
|
|
36
|
+
There is no fallback. A miss in any branch refuses and names the place an operator must go — it never
|
|
37
|
+
quietly reaches for a different principal's credential, because a call that asks to act as a tenant
|
|
38
|
+
and acts as the deployment attributes every record the vendor keeps to the wrong party.
|
|
39
|
+
|
|
40
|
+
**If you want "the tenant's key when they have connected one, otherwise ours", compose it yourself:**
|
|
41
|
+
try an `ORGANIZATION` target, and on the refusal call again with an `APPLICATION` one. Three lines in
|
|
42
|
+
your own code, where the substitution is visible to whoever reads it next. An engine that did it
|
|
43
|
+
underneath would hide the one fact the call is about.
|
|
44
|
+
|
|
45
|
+
## Import Origins
|
|
46
|
+
|
|
47
|
+
- `@wildo-ai/saas-backend-lib`
|
|
48
|
+
|
|
49
|
+
## Source Excerpts
|
|
50
|
+
|
|
51
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
52
|
+
|
|
53
|
+
```typescript
|
|
54
|
+
*
|
|
55
|
+
* One provider secret for ONE connection target — strictly, with no substitution.
|
|
56
|
+
*
|
|
57
|
+
* Reached as `ExternalProvidersRegistryBackendService` from `@wildo-ai/saas-backend-lib`, through
|
|
58
|
+
* the container token `SAAS_SERVICE_TYPES.ExternalProvidersRegistryService`.
|
|
59
|
+
*
|
|
60
|
+
* ## What a TARGET is, and why the call names one
|
|
61
|
+
*
|
|
62
|
+
* A target is `ownerScope` × `delegation`: WHOSE credential is spent, and whether the call acts
|
|
63
|
+
* for a person. The four combinations are different principals, not four ways of saying the same
|
|
64
|
+
* thing — an ORGANIZATION target spends the tenant's own connected account, an APPLICATION target
|
|
65
|
+
* spends the deployment's shared one, a USER target spends one person's.
|
|
66
|
+
*
|
|
67
|
+
* Naming the target is what makes the identity on the wire a decision the calling code states
|
|
68
|
+
* rather than one the engine infers.
|
|
69
|
+
*
|
|
70
|
+
* ## There is NO fallback, deliberately, and that is the whole design
|
|
71
|
+
*
|
|
72
|
+
* A miss in any branch REFUSES, naming what it will not substitute. It never quietly reaches for
|
|
73
|
+
* a different principal's credential.
|
|
74
|
+
*
|
|
75
|
+
* This replaced a resolver that did fall back — an organization with no credential of its own
|
|
76
|
+
* silently spent the deployment's — and the difference is not a tightening of one idea, it is the
|
|
77
|
+
* opposite policy. A fallback means the vendor sees the application's identity while the
|
|
78
|
+
* application believes it acted as the tenant, so every artifact the call leaves behind — a
|
|
79
|
+
* message, a record, a line in the vendor's own audit log — is attributed to the wrong party, and
|
|
80
|
+
* nothing downstream can detect it.
|
|
81
|
+
*
|
|
82
|
+
* **An application that wants "the tenant's key when they have connected one, otherwise ours"
|
|
83
|
+
* still has it**, and composes it itself: try an ORGANIZATION target, and on the refusal call
|
|
84
|
+
* again with an APPLICATION one. That is three lines in the application's own code, where the
|
|
85
|
+
* substitution is visible to whoever reads it. What no longer exists is the engine performing
|
|
86
|
+
* that swap underneath a call that asked for a tenant.
|
|
87
|
+
*
|
|
88
|
+
* ## A refusal is never `undefined`
|
|
89
|
+
*
|
|
90
|
+
* Every miss throws. Returning nothing was the original defect: several callers passed the empty
|
|
91
|
+
* value onward, the vendor received a blank credential and answered 401, and that is
|
|
92
|
+
* indistinguishable from a revoked key — which is how "nobody ever configured this" stayed
|
|
93
|
+
* invisible. Each refusal below therefore names the PLACE an operator must go.
|
|
94
|
+
*
|
|
95
|
+
* Two misses are deliberately not fall-throughs, and both are cases where the tenant or the
|
|
96
|
+
* person DID connect:
|
|
97
|
+
*
|
|
98
|
+
* - a credential stored under a RETIRED slot name (a provider regeneration renamed it). Nothing
|
|
99
|
+
* can read or rename that row — its seal binds the slot name — so the owner reconnects the
|
|
100
|
+
* account. The deployment's credential is NOT used instead, because the fallback that would
|
|
101
|
+
* have applied is for an owner that has none (#624);
|
|
102
|
+
* - a credential that cannot be OPENED. The envelope failure is not caught: a principal that HAS
|
|
103
|
+
* an unreadable credential and one that has none are indistinguishable to a caller, and only
|
|
104
|
+
* one of them is safe to continue from.
|
|
105
|
+
*/
|
|
106
|
+
public async resolveProviderSecretForTarget(
|
|
107
|
+
target: ExternalProvider_ConnectionTarget,
|
|
108
|
+
providerRef: string,
|
|
109
|
+
protocolKind: ExternalProvider_ExchangeProtocol_Kind,
|
|
110
|
+
secretRef: string,
|
|
111
|
+
): Promise<{
|
|
112
|
+
value: string;
|
|
113
|
+
source: ProviderCredentialResolutionSource;
|
|
114
|
+
credentialId?: string;
|
|
115
|
+
credentialSetByUserId?: string;
|
|
116
|
+
/** The connection row's account facts, for a tenant-owned credential (#333, #1047). Absent for the deployment's own. */
|
|
117
|
+
connectionFacts?: ProviderConnectionFacts;
|
|
118
|
+
/** What the vendor granted, when it stated it (#979). Absent means not recorded, never nothing granted. */
|
|
119
|
+
grantedScopes?: readonly string[];
|
|
120
|
+
}> {
|
|
121
|
+
this.ensureInitialized();
|
|
122
|
+
|
|
123
|
+
// Only the APPLICATION's identity impersonating a person is unbuilt. It needs a vendor-side
|
|
124
|
+
// impersonation grant (domain-wide delegation) that no store holds, so it refuses by name.
|
|
125
|
+
//
|
|
126
|
+
// An ORGANIZATION × USER target resolves below like any tenant credential: it IS one — a member
|
|
127
|
+
// linked their own account for the organization, and every member spends it (decision on #18).
|
|
128
|
+
// This used to refuse every USER delegation with "no outbound per-principal token store exists
|
|
129
|
+
// yet", after both stores existed, while the connect leg admitted and stored the very shape
|
|
130
|
+
// this refused: a grant could be connected that nothing could ever spend.
|
|
131
|
+
if (target.ownerScope === ExternalProvider_Connection_OwnerScope.APPLICATION
|
|
132
|
+
&& target.delegation === ExternalProvider_Connection_DelegationMode.USER) {
|
|
133
|
+
throw this.buildConnectionRefusal(
|
|
134
|
+
providerRef,
|
|
135
|
+
`the application cannot act as user '${target.actingForUserId}': impersonating a person with the application's own `
|
|
136
|
+
+ 'identity needs a vendor impersonation grant, which nothing stores. Declare a USER-owned connection, so the person '
|
|
137
|
+
+ 'connects their own account.',
|
|
138
|
+
);
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
if (target.ownerScope === ExternalProvider_Connection_OwnerScope.USER) {
|
|
142
|
+
// An envelope failure is NOT caught here, deliberately, for the organization branch's
|
|
143
|
+
// reason: a person who HAS a credential which cannot be opened must refuse loudly rather
|
|
144
|
+
// than be treated as a person who has none. The two are indistinguishable to a caller
|
|
145
|
+
// and only one of them is a safe thing to continue from.
|
|
146
|
+
const userResolver = this.resolveUserCredentialResolver();
|
|
147
|
+
if (!userResolver) {
|
|
148
|
+
throw this.buildConnectionRefusal(
|
|
149
|
+
providerRef,
|
|
150
|
+
'no user credential store is bound, so a person-owned connection cannot be read at all. '
|
|
151
|
+
+ 'This is a wiring fault rather than a missing credential.',
|
|
152
|
+
);
|
|
153
|
+
}
|
|
154
|
+
const userSecretSlug = this.canonicalCredentialSlug(providerRef, secretRef);
|
|
155
|
+
// A name the provider no longer declares is never sent to the store: its row would still open,
|
|
156
|
+
// because the seal binds the name it was stored under, and spend a credential this subsystem
|
|
157
|
+
// reports as unusable (#624). The miss path below then names that row as retired.
|
|
158
|
+
const userSlotRetired = this.classifyStoredCredentialSlot(providerRef, userSecretSlug) === StoredCredentialSlotStanding.RETIRED;
|
|
159
|
+
const ownedByUser = userSlotRetired ? undefined : await userResolver.resolveUserCredential({
|
|
160
|
+
userId: target.ownerId!,
|
|
161
|
+
providerRef,
|
|
162
|
+
// The store is keyed on the contract KEY, never the env-var spelling a rename can move.
|
|
163
|
+
// See `canonicalCredentialSlug` (#624).
|
|
164
|
+
secretSlug: userSecretSlug,
|
|
165
|
+
});
|
|
166
|
+
if (!ownedByUser) {
|
|
167
|
+
const retiredSlots = await this.findRetiredSlotsBehindMiss(providerRef, userSlotRetired ? undefined : userSecretSlug, ExternalProvider_Connection_OwnerScope.USER, () =>
|
|
168
|
+
userResolver.listStoredSecretSlugs({ userId: target.ownerId!, providerRef }));
|
|
169
|
+
throw this.buildConnectionRefusal(
|
|
170
|
+
providerRef,
|
|
171
|
+
(retiredSlots.length === 0
|
|
172
|
+
? `user '${target.ownerId}' has not connected '${secretRef}'. `
|
|
173
|
+
: `user '${target.ownerId}' has no credential for '${secretRef}' under the provider's current secrets contract. `
|
|
174
|
+
+ `${describeCredentialsStoredUnderRetiredSlots(retiredSlots)} `)
|
|
175
|
+
+ "It is not substituted with the deployment's or their organization's: the call asked to act as this person, and "
|
|
176
|
+
+ 'acting as anyone else would put the wrong name on the record the provider keeps.',
|
|
177
|
+
);
|
|
178
|
+
}
|
|
179
|
+
return {
|
|
180
|
+
value: ownedByUser.value,
|
|
181
|
+
source: ProviderCredentialResolutionSource.USER_CREDENTIAL,
|
|
182
|
+
credentialId: ownedByUser.credentialId,
|
|
183
|
+
...(ownedByUser.connectionFacts === undefined ? {} : { connectionFacts: ownedByUser.connectionFacts }),
|
|
184
|
+
...(ownedByUser.grantedScopes === undefined ? {} : { grantedScopes: ownedByUser.grantedScopes }),
|
|
185
|
+
};
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
if (target.ownerScope === ExternalProvider_Connection_OwnerScope.APPLICATION) {
|
|
189
|
+
const fromEnvironment = this.getProviderSecret(providerRef, protocolKind, secretRef);
|
|
190
|
+
if (fromEnvironment) {
|
|
191
|
+
return { value: fromEnvironment, source: ProviderCredentialResolutionSource.DEPLOYMENT_ENVIRONMENT };
|
|
192
|
+
}
|
|
193
|
+
const environmentVariableName = this.getProviderSecretEnvVarName(providerRef, protocolKind, secretRef) ?? secretRef;
|
|
194
|
+
throw this.buildConnectionRefusal(
|
|
195
|
+
providerRef,
|
|
196
|
+
`the application's own credential for '${secretRef}' is not set. Author '${environmentVariableName}' in the deployment environment.`,
|
|
197
|
+
);
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
// ORGANIZATION. An envelope failure is NOT caught, deliberately: a tenant that HAS a
|
|
201
|
+
// credential which cannot be opened must refuse loudly rather than be treated as a tenant
|
|
202
|
+
// that has none — the two are indistinguishable to a caller and only one is safe.
|
|
203
|
+
const resolver = this.resolveOrganizationCredentialResolver();
|
|
204
|
+
if (!resolver) {
|
|
205
|
+
throw this.buildConnectionRefusal(
|
|
206
|
+
providerRef,
|
|
207
|
+
'no organization credential store is bound, so a tenant-owned connection cannot be read at all. '
|
|
208
|
+
+ 'This is a wiring fault rather than a missing credential.',
|
|
209
|
+
);
|
|
210
|
+
}
|
|
211
|
+
const organizationSecretSlug = this.canonicalCredentialSlug(providerRef, secretRef);
|
|
212
|
+
// Never sends a RETIRED name to the store — see the USER branch above (#624).
|
|
213
|
+
const organizationSlotRetired = this.classifyStoredCredentialSlot(providerRef, organizationSecretSlug) === StoredCredentialSlotStanding.RETIRED;
|
|
214
|
+
const owned = organizationSlotRetired ? undefined : await resolver.resolveOrganizationCredential({
|
|
215
|
+
organizationId: target.ownerId!,
|
|
216
|
+
providerRef,
|
|
217
|
+
// Keyed on the contract KEY — see `canonicalCredentialSlug` (#624).
|
|
218
|
+
secretSlug: organizationSecretSlug,
|
|
219
|
+
});
|
|
220
|
+
if (!owned) {
|
|
221
|
+
const retiredSlots = await this.findRetiredSlotsBehindMiss(providerRef, organizationSlotRetired ? undefined : organizationSecretSlug, ExternalProvider_Connection_OwnerScope.ORGANIZATION, () =>
|
|
222
|
+
resolver.listStoredSecretSlugs({ organizationId: target.ownerId!, providerRef }));
|
|
223
|
+
throw this.buildConnectionRefusal(
|
|
224
|
+
providerRef,
|
|
225
|
+
(retiredSlots.length === 0
|
|
226
|
+
? `organization '${target.ownerId}' has no credential for '${secretRef}'. `
|
|
227
|
+
: `organization '${target.ownerId}' has no credential for '${secretRef}' under the provider's current secrets contract. `
|
|
228
|
+
+ `${describeCredentialsStoredUnderRetiredSlots(retiredSlots)} `)
|
|
229
|
+
+ "It is not substituted with the deployment's: the call asked to act as this tenant, and acting as someone else "
|
|
230
|
+
+ 'instead would be attributed to the wrong party.',
|
|
231
|
+
);
|
|
232
|
+
}
|
|
233
|
+
return {
|
|
234
|
+
value: owned.value,
|
|
235
|
+
source: ProviderCredentialResolutionSource.ORGANIZATION_CREDENTIAL,
|
|
236
|
+
credentialId: owned.credentialId,
|
|
237
|
+
...(owned.setByUserId === undefined ? {} : { credentialSetByUserId: owned.setByUserId }),
|
|
238
|
+
...(owned.connectionFacts === undefined ? {} : { connectionFacts: owned.connectionFacts }),
|
|
239
|
+
...(owned.grantedScopes === undefined ? {} : { grantedScopes: owned.grantedScopes }),
|
|
240
|
+
};
|
|
241
|
+
}
|
|
242
|
+
```
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# Framework Content-Security-Policy API
|
|
2
|
+
|
|
3
|
+
Declaring a CSP for one of the application's frontends. All three surfaces carry the same block:
|
|
4
|
+
`services.<key>.csp` on the SAAS app, `wildo.website.config.ts.csp`, `wildo.tech-doc.config.ts.csp`.
|
|
5
|
+
|
|
6
|
+
## ⚠️ Every browser surface ships a policy — what differs is what happens when you author none
|
|
7
|
+
|
|
8
|
+
The application, a website and a technical-doc site are all CSP-capable, and the sync refuses to
|
|
9
|
+
resolve a DISABLED policy for any of them: `enabled: false` is a refusal naming the service, never a
|
|
10
|
+
way to switch the header off.
|
|
11
|
+
|
|
12
|
+
What an omitted block does depends on the surface:
|
|
13
|
+
|
|
14
|
+
| surface | no `csp` block authored |
|
|
15
|
+
|---|---|
|
|
16
|
+
| the application (`services.<key>.csp`) | **defaults to `enabled: true, reportOnly: true`** — a policy that reports violations and blocks nothing |
|
|
17
|
+
| website (`wildo.website.config.ts`) / technical doc (`wildo.tech-doc.config.ts`) | **refused** — the sync names the file that must author a block |
|
|
18
|
+
|
|
19
|
+
So a fresh application is not unprotected by absence and not protected by it either: it ships a
|
|
20
|
+
report-only header until someone decides. Deleting the application's block does not remove the
|
|
21
|
+
header; it resets it to that default.
|
|
22
|
+
|
|
23
|
+
The block is a strict object on purpose: a typo like `enable: true` or `directive:` is a parse ERROR
|
|
24
|
+
rather than a silent strip to `enabled: false`.
|
|
25
|
+
|
|
26
|
+
## The generated artifact is the only one read
|
|
27
|
+
|
|
28
|
+
1. Author the static posture on the service.
|
|
29
|
+
2. Add per-environment entries under `csp.<serviceKey>` in that environment's infrastructure config.
|
|
30
|
+
3. Run `wildo dev sync-csp --env <env>` — starting development runs it for you.
|
|
31
|
+
|
|
32
|
+
**Each surface reads only the generated file.** Hand-editing a surface's own policy changes nothing
|
|
33
|
+
and is overwritten on the next sync. For a surface served by nginx, the sync also rewrites only the
|
|
34
|
+
region between the CSP markers in its `nginx-config/` files and leaves every other line alone — which
|
|
35
|
+
is why a production image must be built AFTER a sync for the target environment.
|
|
36
|
+
|
|
37
|
+
**The sync refuses before writing anything** when:
|
|
38
|
+
|
|
39
|
+
- an environment's `csp` override names a key that is not a service in `wildo.saas.config.ts`, or a
|
|
40
|
+
service that is not a browser surface;
|
|
41
|
+
- the surface's own backend origin is missing from the resolved `connect-src` — the mistake that
|
|
42
|
+
would ship a policy blocking the application from its own backend. This is checked for the
|
|
43
|
+
application (`VITE_API_BASE_URL`) and the technical doc (`WILDO_DOCS_API_BASE_URL`) only, and only
|
|
44
|
+
when that variable is set; a website is not checked.
|
|
45
|
+
|
|
46
|
+
Providers a service declares contribute the origins they need, read from that service's generated
|
|
47
|
+
provider artifact — so an origin a provider already declares is not yours to add by hand.
|
|
48
|
+
|
|
49
|
+
**The generated files are tracked, and a configuration change does not update them until the next
|
|
50
|
+
sync.** Run `wildo dev sync-csp --env <env> --check` in CI: it writes nothing and exits non-zero when a
|
|
51
|
+
tracked artifact no longer describes its own inputs.
|
|
52
|
+
|
|
53
|
+
## `reportOnly` is a posture, and pairs with a collector or does nothing
|
|
54
|
+
|
|
55
|
+
`reportOnly: true` emits the report-only header: the browser reports violations and **blocks
|
|
56
|
+
nothing**. Flipping it is one field.
|
|
57
|
+
|
|
58
|
+
A `report-uri` is supported by both the schema and the emitter, and no baseline ships a collector — so
|
|
59
|
+
report-only with nothing authored there neither blocks anything nor tells you anything. Decide both
|
|
60
|
+
together.
|
|
61
|
+
|
|
62
|
+
Nonces and hashes are not generated, per request or at build time. A source list can name one by
|
|
63
|
+
hand, but nothing produces them — which is why a baseline that must admit inline script still does.
|
|
64
|
+
|
|
65
|
+
## Content-Security-Policy
|
|
66
|
+
|
|
67
|
+
## Import Origins
|
|
68
|
+
|
|
69
|
+
- `@wildo-ai/platform-config-lib`
|
|
70
|
+
|
|
71
|
+
## Source Excerpts
|
|
72
|
+
|
|
73
|
+
### Origin Package: `@wildo-ai/platform-config-lib`
|
|
74
|
+
|
|
75
|
+
```typescript
|
|
76
|
+
*
|
|
77
|
+
* Declaring a Content-Security-Policy for one of the application's frontends.
|
|
78
|
+
*
|
|
79
|
+
* ⚠️ **Every browser surface ships a policy; what differs is what happens when you author none.** On
|
|
80
|
+
* the application (`services.<key>.csp`) an omitted block resolves at sync to `enabled: true,
|
|
81
|
+
* reportOnly: true` — a policy that reports violations and blocks nothing. A website or technical-doc
|
|
82
|
+
* config with no block is refused at sync, naming the file. A policy that resolves DISABLED is refused
|
|
83
|
+
* on every surface, so `enabled: false` cannot switch the header off.
|
|
84
|
+
*
|
|
85
|
+
* ## The generated file is the only one read
|
|
86
|
+
*
|
|
87
|
+
* Author the static posture here, add per-environment entries under `csp.<serviceKey>` in that
|
|
88
|
+
* environment's infrastructure configuration, then run `wildo dev sync-csp --env <env>` (starting
|
|
89
|
+
* development runs it for you). Each surface reads ONLY the generated artifact — hand-editing a
|
|
90
|
+
* surface's own policy file changes nothing and is overwritten on the next sync.
|
|
91
|
+
*
|
|
92
|
+
* ## `reportOnly` is a posture, not a formality
|
|
93
|
+
*
|
|
94
|
+
* `reportOnly: true` emits the report-only header: the browser reports violations and BLOCKS
|
|
95
|
+
* NOTHING. Flipping it is one field. Note also that a `report-uri` is supported by the schema and the
|
|
96
|
+
* emitter and no baseline ships a collector, so with nothing authored there the reports a browser
|
|
97
|
+
* generates have nowhere to go — report-only plus no collector is a policy that neither blocks nor
|
|
98
|
+
* tells you anything.
|
|
99
|
+
*
|
|
100
|
+
* Nonces and hashes are not generated per request or at build time. A source list may name one by
|
|
101
|
+
* hand, but there is no generation, which is why a baseline that must admit inline script still does.
|
|
102
|
+
*
|
|
103
|
+
* Per-frontend CSP block. Authored on each service-definition's `csp?`
|
|
104
|
+
* field. All three surfaces carry it: `wildo.tech-doc.config.ts.csp?`,
|
|
105
|
+
* `wildo.website.config.ts.csp?`, and `services.<key>.csp` on the
|
|
106
|
+
* `SAAS_APP` service definition.
|
|
107
|
+
*
|
|
108
|
+
* An AUTHORED block that omits `enabled` parses as `enabled: false`, which the resolver turns into no
|
|
109
|
+
* policy and the sync then refuses — so author `enabled: true` explicitly whenever you write a block.
|
|
110
|
+
*
|
|
111
|
+
* `z.strictObject` (Zod 4) is intentional — typos like `enable: true`
|
|
112
|
+
* (no `d`) or `directive: { … }` (no plural) MUST surface as parse
|
|
113
|
+
* errors, not silently strip to `enabled: false` (i.e. CSP off, the
|
|
114
|
+
* worst possible default). Same framework-mindset enforcement as
|
|
115
|
+
* `WildoAuthConfigSchema`.
|
|
116
|
+
*/
|
|
117
|
+
export const WildoCspConfigSchema = z.strictObject({
|
|
118
|
+
/**
|
|
119
|
+
* `true` => baseline (+ overrides) emitted on both channels per `reportOnly`.
|
|
120
|
+
* `false` — also the parse default for an authored block — makes the resolver return `null`, and
|
|
121
|
+
* `wildo dev sync-csp` refuses that for every CSP-capable surface. It is not a way to turn the
|
|
122
|
+
* header off.
|
|
123
|
+
*/
|
|
124
|
+
enabled: z.boolean().default(false),
|
|
125
|
+
/**
|
|
126
|
+
* `true` => header name flips to `Content-Security-Policy-Report-Only`
|
|
127
|
+
* AND the `<meta http-equiv>` channel goes silent (browsers reject the
|
|
128
|
+
* report-only header via meta — W3C CSP3 §4.2.1). Use during the
|
|
129
|
+
* pilot to triage console-surfaced violations without breaking real
|
|
130
|
+
* traffic. Flip to `false` once the directive overrides settle.
|
|
131
|
+
*
|
|
132
|
+
* Default: `false` (enforcing). Authors opting into CSP for the first
|
|
133
|
+
* time SHOULD set `reportOnly: true` for the first PR; the schema
|
|
134
|
+
* default is intentionally enforcing so the steady state (post-pilot)
|
|
135
|
+
* doesn't require a per-app authored `reportOnly: false`.
|
|
136
|
+
*/
|
|
137
|
+
reportOnly: z.boolean().default(false),
|
|
138
|
+
/**
|
|
139
|
+
* Merge strategy for authored `directives` over the baseline. Default:
|
|
140
|
+
* `'extend-baseline'` (per-directive additive merge — see
|
|
141
|
+
* `CspMergeStrategy`).
|
|
142
|
+
*/
|
|
143
|
+
mergeStrategy: z
|
|
144
|
+
.enum(CspMergeStrategy)
|
|
145
|
+
.default(CspMergeStrategy.EXTEND_BASELINE),
|
|
146
|
+
/**
|
|
147
|
+
* Per-directive overrides, keyed by directive name. Default: empty
|
|
148
|
+
* map (baseline emitted verbatim).
|
|
149
|
+
*/
|
|
150
|
+
directives: CspDirectivesOverrideSchema.default({}),
|
|
151
|
+
/**
|
|
152
|
+
* Optional `report-uri` directive value (header-only — meta tag
|
|
153
|
+
* ignores it; the resolver feeds it to the nginx channel only).
|
|
154
|
+
* No `report-to` field today — `report-to` requires the parallel
|
|
155
|
+
* Reporting API endpoint config which the platform doesn't ship; add
|
|
156
|
+
* when the violation-collector lands (`auth-hardening.md` "Cheap
|
|
157
|
+
* Bonuses — CSP violation monitoring endpoint").
|
|
158
|
+
*/
|
|
159
|
+
reportUri: z.string().min(1).optional(),
|
|
160
|
+
});
|
|
161
|
+
```
|
|
@@ -34,8 +34,32 @@ at-least-once.
|
|
|
34
34
|
export enum EngineCapability {
|
|
35
35
|
ORGANIZATIONS = 'ORGANIZATIONS',
|
|
36
36
|
BILLING = 'BILLING',
|
|
37
|
-
BILLING_PAYMENTS = 'BILLING_PAYMENTS',
|
|
38
37
|
MULTI_LANGUAGE = 'MULTI_LANGUAGE',
|
|
38
|
+
/**
|
|
39
|
+
* Durable, provider-backed audit trail: every audit event the application records is ALSO sent to
|
|
40
|
+
* each configured audit provider (an immutable ledger, a SIEM).
|
|
41
|
+
*
|
|
42
|
+
* Whether to enable it is a question of where the trail must live, not of what the application may
|
|
43
|
+
* claim. The assurance surface attests roughly half its control objectives through audit rows, and
|
|
44
|
+
* those rows are read from the application's OWN audit store, which exists whether or not this
|
|
45
|
+
* capability is on. So leaving it out removes no control objective an application can claim. Until
|
|
46
|
+
* 2026-09-14 the assurance basis wrongly treated this capability as the precondition for those
|
|
47
|
+
* claims, and this comment said leaving it out left about a third of them unclaimable.
|
|
48
|
+
*
|
|
49
|
+
* Two things this does NOT mean, because both are easy to assume:
|
|
50
|
+
*
|
|
51
|
+
* - It is not what makes security events happen. Authentication, authorization, privilege and
|
|
52
|
+
* credential events are recorded in the application's own database regardless. What this
|
|
53
|
+
* capability adds is the provider-backed fan-out — the durable, external, tamper-evident
|
|
54
|
+
* destination an assurance reader can be pointed at.
|
|
55
|
+
* - It is not retroactive. Turning it on later starts a trail from that moment; it does not
|
|
56
|
+
* furnish evidence for the period it was off, and a control's evidence cannot begin before its
|
|
57
|
+
* evidence store does.
|
|
58
|
+
*
|
|
59
|
+
* So decide it with the compliance posture rather than as an infrastructure detail: enable it when
|
|
60
|
+
* the trail must also exist OUTSIDE the application — a store its own operators cannot rewrite, or a
|
|
61
|
+
* security team's SIEM. The application's own store stays the authoritative record either way.
|
|
62
|
+
*/
|
|
39
63
|
COMPLIANCE_AUDIT_TRAIL = 'COMPLIANCE_AUDIT_TRAIL',
|
|
40
64
|
|
|
41
65
|
EMAIL_TRANSACTIONAL = 'EMAIL_TRANSACTIONAL',
|
|
@@ -66,11 +90,13 @@ export enum EngineCapability {
|
|
|
66
90
|
* extraction into `AI_LLM` would have made one `selection[AI_LLM].primary` decide all three,
|
|
67
91
|
* which is exactly the defect that split `AI_EMBEDDINGS` out of `AI_LLM`.
|
|
68
92
|
*
|
|
69
|
-
* ## Not to be confused with
|
|
93
|
+
* ## Not to be confused with PDF GENERATION
|
|
70
94
|
*
|
|
71
|
-
*
|
|
72
|
-
*
|
|
73
|
-
* unrelated
|
|
95
|
+
* PDF generation — templates and data become bytes — is the `pdfTemplates` surface, done
|
|
96
|
+
* in-process and with no provider slot of its own. This is the opposite direction: bytes become
|
|
97
|
+
* text. The two are unrelated and nothing routes between them. (There WAS an
|
|
98
|
+
* `EngineCapability.DOCUMENT_GENERATION` that this paragraph used to name; it was withdrawn
|
|
99
|
+
* because no provider capability could ever fill it.)
|
|
74
100
|
*
|
|
75
101
|
* ## Absence is benign, and that is load-bearing
|
|
76
102
|
*
|
|
@@ -97,8 +123,60 @@ export enum EngineCapability {
|
|
|
97
123
|
*/
|
|
98
124
|
AI_CODING_AGENT = 'AI_CODING_AGENT',
|
|
99
125
|
|
|
100
|
-
|
|
101
|
-
|
|
126
|
+
/*
|
|
127
|
+
* WITHDRAWN 2026-09-03: `DOCUMENT_GENERATION` and `ANTIVIRUS_SCANNING` were members here and are
|
|
128
|
+
* not any more. Neither could ever be filled — `PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY` had no
|
|
129
|
+
* entry pointing at either, so no provider capability token could claim the slot — while both were
|
|
130
|
+
* classified `SELECT_ONE`, which asserts that exactly one provider must be selected. Selecting one
|
|
131
|
+
* of zero candidates is not a resolution mode.
|
|
132
|
+
*
|
|
133
|
+
* Both capabilities are real and both are delivered elsewhere, which is why withdrawing the slots
|
|
134
|
+
* costs nothing: antivirus scanning is `InfraCapability.ANTIVIRUS_SCANNING`, fulfilled by ClamAV
|
|
135
|
+
* and consumed by `FileScanningBackendService`; PDF generation is the in-process `pdfTemplates`
|
|
136
|
+
* surface, rendered by `@react-pdf/renderer` inside the backend. Neither has an external
|
|
137
|
+
* provider, and neither is planned to.
|
|
138
|
+
*
|
|
139
|
+
* `InfraCapability.DOCUMENT_RENDERING` (Gotenberg) was provisioned beside the PDF surface and
|
|
140
|
+
* consumed by nothing; it was withdrawn on 2026-09-08 (#477) because in-process rendering had
|
|
141
|
+
* superseded it. Note the two are not interchangeable if it is ever reconsidered:
|
|
142
|
+
* `@react-pdf/renderer` composes a document from React primitives, while Gotenberg converts
|
|
143
|
+
* EXISTING HTML and Office documents — that is a different capability, not a second
|
|
144
|
+
* implementation of this one.
|
|
145
|
+
*
|
|
146
|
+
* Removing `ANTIVIRUS_SCANNING` also removes a collision: the identical spelling named an engine
|
|
147
|
+
* slot nothing could fill AND a live infra capability, in two packages, so a reader grepping the
|
|
148
|
+
* word landed in whichever they searched first.
|
|
149
|
+
*
|
|
150
|
+
* If a hosted AV or document-rendering vendor is ever adopted, the member comes back WITH its
|
|
151
|
+
* `PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY` entry and its own JSDoc in the same change.
|
|
152
|
+
*
|
|
153
|
+
* WITHDRAWN 2026-09-09: `BILLING_PAYMENTS`, the third member of exactly that shape, and the one
|
|
154
|
+
* this paragraph's own closing rule should have caught. It was never withdrawn with the other two
|
|
155
|
+
* because it had been left behind DELIBERATELY — as a "reserved slot" — which reads as a decision
|
|
156
|
+
* and is why nobody re-examined it. Measured before removing, across the whole repository outside
|
|
157
|
+
* `node_modules` / `dist`: it appeared in live source at exactly THREE sites, and none of them was
|
|
158
|
+
* a use — the enum declaration itself, its row in the compile-forced
|
|
159
|
+
* `ENGINE_CAPABILITY_RESOLUTION_MODE` record, and a comment in a test naming it as a slot the
|
|
160
|
+
* billing provider must NOT be registered under. Zero applications enabled it, zero scaffolds
|
|
161
|
+
* wrote it, zero consumers queried it, and no provider capability token mapped to it.
|
|
162
|
+
*
|
|
163
|
+
* The capability it names is real and is already delivered: a billing provider (Stripe) declares
|
|
164
|
+
* `BUILTIN_PROVIDER_CAPABILITY.BILLING` and fills `EngineCapability.BILLING`, which is the slot
|
|
165
|
+
* applications enable and `getProvidersForEngineCapability` gates on. Payment EXECUTION is served
|
|
166
|
+
* through that same provider's `BILLING_PROVIDER` protocol; splitting it into a second engine slot
|
|
167
|
+
* was a plan-era intention (`provider-registry-materialization-workflow.md`) that the shipped
|
|
168
|
+
* model settled the other way. So the withdrawal removes a name, not a capability.
|
|
169
|
+
*
|
|
170
|
+
* The reason a reserved slot is worse than no slot is `EngineCapabilityResolutionMode`: every
|
|
171
|
+
* member must be classified, `BILLING_PAYMENTS` was classified `SELECT_ONE`, and `SELECT_ONE`
|
|
172
|
+
* asserts that exactly one provider is selected from the candidates. There were zero candidates
|
|
173
|
+
* and there could never be one. A vocabulary member that no configuration can satisfy is not a
|
|
174
|
+
* reservation, it is a false statement the compiler is forced to carry.
|
|
175
|
+
*
|
|
176
|
+
* If a payments vendor is ever selected independently of the billing vendor, the member comes back
|
|
177
|
+
* with its provider-capability token and its map entry in the same change — the same rule as
|
|
178
|
+
* above, now with three instances behind it.
|
|
179
|
+
*/
|
|
102
180
|
|
|
103
181
|
FRONTEND_ERROR_MONITORING = 'FRONTEND_ERROR_MONITORING',
|
|
104
182
|
FRONTEND_PRODUCT_ANALYTICS = 'FRONTEND_PRODUCT_ANALYTICS',
|
|
@@ -139,8 +217,10 @@ export enum EngineCapability {
|
|
|
139
217
|
* Authoring rule: keep this list narrow and stable. Adding a new
|
|
140
218
|
* built-in capability is a framework-level decision (it implies the
|
|
141
219
|
* engine knows how to consume the capability via a transformer or a
|
|
142
|
-
* platform binding)
|
|
143
|
-
*
|
|
220
|
+
* platform binding). There is no app-side extension point: an application
|
|
221
|
+
* needing a capability this vocabulary does not name is a decision to widen
|
|
222
|
+
* the vocabulary, taken with the resolution path that would make it mean
|
|
223
|
+
* something (#502).
|
|
144
224
|
*/
|
|
145
225
|
export const BUILTIN_PROVIDER_CAPABILITY = {
|
|
146
226
|
EMAIL_TRANSACTIONAL: 'EMAIL_TRANSACTIONAL',
|
|
@@ -166,9 +246,10 @@ export const BUILTIN_PROVIDER_CAPABILITY = {
|
|
|
166
246
|
* a read of a PDF's existing text layer. Maps to `EngineCapability.AI_DOCUMENT_EXTRACTION`.
|
|
167
247
|
*
|
|
168
248
|
* A NEW token was genuinely required rather than convenient: `IMAGE_GENERATION` is an OUTPUT
|
|
169
|
-
* capability (text → image), and `
|
|
170
|
-
*
|
|
171
|
-
*
|
|
249
|
+
* capability (text → image), and PDF *generation* — the `pdfTemplates` surface — is this
|
|
250
|
+
* capability's exact opposite. Nothing in the existing vocabulary claimed the document-INPUT
|
|
251
|
+
* slot. (This paragraph used to name `EngineCapability.DOCUMENT_GENERATION`; that member was
|
|
252
|
+
* withdrawn because no provider capability could fill it.)
|
|
172
253
|
*
|
|
173
254
|
* Distinct from `LLM_CHAT` even where a vendor serves both from one API key: the work is
|
|
174
255
|
* different (a page-layout model, billed per page, with no sampling parameters), and fusing
|