@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
# Tenant teardown: retention window, purge schedule, batch size
|
|
2
|
+
|
|
3
|
+
The optional `tenantTeardown` block of `backend-api/src/saas-config.backend.ts`.
|
|
4
|
+
|
|
5
|
+
Read this when:
|
|
6
|
+
|
|
7
|
+
- your application deletes organizations and you need to know how long a deleted tenant stays
|
|
8
|
+
restorable, and who chose that number;
|
|
9
|
+
- you have a contractual or regulatory retention obligation of your own to honour;
|
|
10
|
+
- an operator asks why a tenant deleted last month is still in the database, or why one deleted this
|
|
11
|
+
morning is already gone;
|
|
12
|
+
- you shortened the window and an in-flight tenant did not move.
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/saas-models`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
21
|
+
|
|
22
|
+
```typescript
|
|
23
|
+
/**
|
|
24
|
+
* Tenant teardown — the operator-tunable half of soft-delete + retention window + purge.
|
|
25
|
+
*
|
|
26
|
+
* Declared as the optional `tenantTeardown` block of your application's backend-authored
|
|
27
|
+
* configuration (`backend-api/src/saas-config.backend.ts`), beside `lifecycle` and `compliance`.
|
|
28
|
+
*
|
|
29
|
+
* ## What it governs, and why you cannot ignore it by omitting it
|
|
30
|
+
*
|
|
31
|
+
* Deleting a tenant is TWO acts. Requesting deletion MARKS the organization, at which point it
|
|
32
|
+
* stops conferring any authority and its data is still entirely intact; an engine-owned batch
|
|
33
|
+
* destroys it later. The three fields here decide how long "later" is, when the batch runs, and how
|
|
34
|
+
* many tenants one run may destroy — so an application that declares nothing still deletes its
|
|
35
|
+
* customers' tenants, on this block's defaults, thirty days after the mark.
|
|
36
|
+
*
|
|
37
|
+
* ## Why this is its own config block
|
|
38
|
+
*
|
|
39
|
+
* `LifecycleConfigSchema` already exists and is about the USER lifecycle (activation, engagement,
|
|
40
|
+
* dormancy detection). Folding tenant teardown into it would merge two unrelated concerns behind
|
|
41
|
+
* one master switch — and that switch defaults to `enabled: false`, which would make an
|
|
42
|
+
* organization's retention window silently depend on whether the app opted into user-engagement
|
|
43
|
+
* tracking. Tenant teardown has no such opt-in: an application that deletes tenants always has a
|
|
44
|
+
* retention window, so the block is optional only in the sense that its defaults are usually right.
|
|
45
|
+
*
|
|
46
|
+
* ## Why every value has a default
|
|
47
|
+
*
|
|
48
|
+
* Omitting the block entirely must produce a working, safe configuration — the alternative is an
|
|
49
|
+
* application that ships without a purge schedule and accumulates marked-but-never-destroyed
|
|
50
|
+
* tenants, which is the failure mode a retention window is supposed to prevent.
|
|
51
|
+
*/
|
|
52
|
+
export const TenantTeardownConfigSchema = z.object({
|
|
53
|
+
/**
|
|
54
|
+
* How long a marked tenant stays restorable before the purge batch may destroy it.
|
|
55
|
+
*
|
|
56
|
+
* Default 30 days. The window is a commitment, not a scheduling hint: the value is read ONCE,
|
|
57
|
+
* when the tenant is marked, and pinned onto `Organization.purgeScheduledAt`. Lowering this
|
|
58
|
+
* setting therefore affects only tenants marked afterwards — tenants already inside a window
|
|
59
|
+
* keep the deadline they were promised. See `Organization.purgeScheduledAt` for why the deadline
|
|
60
|
+
* is stored rather than recomputed.
|
|
61
|
+
*
|
|
62
|
+
* 30 days sits inside the band comparable products use (roughly 20–90 days) and inside the
|
|
63
|
+
* one-month response period GDPR Art. 12(3) allows for acting on an erasure request, so the
|
|
64
|
+
* default does not put an application in breach by itself. It is not legal advice: an
|
|
65
|
+
* application with its own retention obligations must set this deliberately.
|
|
66
|
+
*/
|
|
67
|
+
retentionWindowDays: z.number().int().positive().default(30),
|
|
68
|
+
|
|
69
|
+
/**
|
|
70
|
+
* Cron schedule for the engine-owned `organization-purge` batch. Default 03:00 daily.
|
|
71
|
+
*
|
|
72
|
+
* Daily rather than hourly on purpose: the window is measured in days, so a finer cadence buys
|
|
73
|
+
* no promptness that anyone can observe and only multiplies the scans.
|
|
74
|
+
*/
|
|
75
|
+
purgeCronSchedule: z.string().default('0 3 * * *'),
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* Maximum tenants destroyed per purge run.
|
|
79
|
+
*
|
|
80
|
+
* A purge cascades across every child resource of a tenant, so an unbounded run after a mass
|
|
81
|
+
* offboarding could hold database resources for a long time. Anything not reached this run is
|
|
82
|
+
* reached by the next one — the deadline has passed, so there is no correctness cost to
|
|
83
|
+
* spreading the work, and a bounded run keeps one bad batch from becoming an outage.
|
|
84
|
+
*/
|
|
85
|
+
purgeBatchSize: z.number().int().positive().default(50),
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
export type TenantTeardownConfig = z.infer<typeof TenantTeardownConfigSchema>;
|
|
89
|
+
|
|
90
|
+
/** Defaults applied when an application declares no `tenantTeardown` block at all. */
|
|
91
|
+
export const TENANT_TEARDOWN_CONFIG_DEFAULTS: TenantTeardownConfig = TenantTeardownConfigSchema.parse({});
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
## What the purge destroys is decided by YOUR relationships
|
|
95
|
+
|
|
96
|
+
The purge contains no teardown logic of its own. It deletes each due organization through the
|
|
97
|
+
ordinary organization delete, and what happens to everything the organization owns is whatever each
|
|
98
|
+
relationship already declares for a parent's deletion (`childOperations.lifecycle.onParentDelete` —
|
|
99
|
+
see the `module-relationships` skill):
|
|
100
|
+
|
|
101
|
+
- a child whose edge follows the parent's deletion is deleted with it — or, where its strategy says
|
|
102
|
+
so, impersonalized and retained (see the erasure treatments in `resource-schema-authoring`);
|
|
103
|
+
- a child whose edge does not follow the parent's deletion is left in place;
|
|
104
|
+
- a `REFERENCE` edge is refused as a teardown path. An ownership (`COMPOSITION`) or `ASSOCIATION`
|
|
105
|
+
edge carries a parent's deletion to a child exactly as its `onParentDelete` declares.
|
|
106
|
+
|
|
107
|
+
So a resource you add under an organization is destroyed, kept, or anonymized once the tenant's
|
|
108
|
+
retention window has passed — 30 days unless `retentionWindowDays` says otherwise, at the first
|
|
109
|
+
scheduled purge run after the deadline — according to what YOU declared on its relationship. Decide
|
|
110
|
+
that when you declare it, not when the first tenant leaves.
|
|
111
|
+
|
|
112
|
+
## When a tenant cannot be purged
|
|
113
|
+
|
|
114
|
+
- Each organization is its own attempt. One that fails is logged at error level and **stays
|
|
115
|
+
marked**, so the next run retries it — a tenant past its deadline that cannot be destroyed is a
|
|
116
|
+
standing exposure, not routine noise.
|
|
117
|
+
- A deletion cascade that would cross two different persistence stores is refused as a
|
|
118
|
+
configuration error rather than run non-atomically. That tenant keeps failing on every run until
|
|
119
|
+
the relationship is fixed, so treat the error line as a defect in your model.
|
|
120
|
+
- The purge sends no email: everyone it would write to is deleted in the same act. The warning is
|
|
121
|
+
the deletion request's notification, sent when the tenant is marked.
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# Understand the configuration your process starts with
|
|
2
|
+
|
|
3
|
+
A running application uses a resolved startup snapshot. Changing a source file, changing the platform's stored configuration and restarting a process are separate actions; a restart reads what is stored, it does not publish your authored changes.
|
|
4
|
+
|
|
5
|
+
## Sources and order
|
|
6
|
+
|
|
7
|
+
| Stage | Contribution | Ownership |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| Environment | Application and service identity, manager address and bootstrap authentication; runtime connection settings | Deployment environment |
|
|
10
|
+
| Base configuration | Schema defaults overlaid with environment settings | Framework and deployment |
|
|
11
|
+
| Manager secrets response | Managed credentials, fetched through an authenticated request | Platform provisioning |
|
|
12
|
+
| Manager configuration response | Selected managed metadata, including public signing keys and token lifetimes | Platform configuration |
|
|
13
|
+
| Backend-authored configuration | Allowed application policy from `backend-api/src/saas-config.backend.ts` | Application builder |
|
|
14
|
+
| Resolution and validation | Required values and startup invariants checked before the application can rely on the result | Framework startup |
|
|
15
|
+
|
|
16
|
+
Configuration and secrets are separate responses. The managed metadata response is not a wholesale replacement of environmental connection settings. Backend-authored configuration is applied through its allowed boundary, not an unrestricted deep merge: the whole `jwt` branch and runtime topology remain platform-managed.
|
|
17
|
+
|
|
18
|
+
## Startup availability and changes
|
|
19
|
+
|
|
20
|
+
The loader fetches secrets before managed configuration. These are startup reads, not a subscription or a live update stream. A process already running does not adopt a later manager snapshot through this loader.
|
|
21
|
+
|
|
22
|
+
In development, services other than the application manager retry failed reads with bounded backoff. Other environments do not use that development retry loop. Exhausted or unsuccessful reads refuse startup; there is no stale-cache fallback that turns an unavailable manager into a successful boot. Diagnose the selected environment, identity, manager reachability and the failing response before changing application policy.
|
|
23
|
+
|
|
24
|
+
## Publish a changed token policy
|
|
25
|
+
|
|
26
|
+
Application-owned authentication posture belongs in the backend-authored file. Platform token lifetimes belong to `serviceAuth` in the selected infrastructure environment, such as `infrastructure/local/wildo.infra.local.config.ts`. Do not redeclare `jwt` in backend-authored configuration.
|
|
27
|
+
|
|
28
|
+
For an existing application with the local environment selected and its platform running, author the intended token lifetimes. From that application's root, regenerate the local configuration snapshot before registering:
|
|
29
|
+
|
|
30
|
+
```sh
|
|
31
|
+
wildo config sync --env local --domain config
|
|
32
|
+
wildo local init --register-only
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
The config-sync workflow refreshes the snapshot and related generated configuration/deployment artifacts; it can also prepare registration targets. It is not a JSON-only edit. The registration step then uses the refreshed policy. Initialization reconciles an explicitly supplied policy into the stored configuration without requiring broad `override`. The command also performs its normal registration and declaration work; it is not a policy-only API.
|
|
36
|
+
|
|
37
|
+
Verify the selected application's stored `platformManaged.jwt.accessTokenExpirationMinutes` and `platformManaged.jwt.refreshTokenExpirationDays`, then restart the affected runtime through its normal lifecycle and check the effective values. Never log or export the whole secrets response as evidence. Restarting alone does not publish a file edit, and already-issued tokens keep their existing expiration claims.
|
|
38
|
+
|
|
39
|
+
| Authored input | Existing application during ordinary registration |
|
|
40
|
+
|---|---|
|
|
41
|
+
| No `serviceAuth` block | Preserve its stored token lifetimes |
|
|
42
|
+
| Both lifetime values | Apply both explicit values |
|
|
43
|
+
| Present partial block | Apply the supplied member and the schema default for the omitted member |
|
|
44
|
+
| Explicit empty block | Apply the current schema defaults |
|
|
45
|
+
|
|
46
|
+
For first registration, omission uses schema defaults. Broad initialization override still has wider reset effects and is not required for a policy change. Removing a previously authored block is therefore not a request to reset an existing policy: use an explicit block when resetting is intended. Remote environments use their operator provisioning workflow; the local command rejects them.
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: configure-billing
|
|
3
|
-
description: Enable billing (or make any backend-reachable external provider resolve) across the full multi-surface config chain. Use when the user says "enable billing", "turn on Stripe", "billing crash-loops the backend", "wire up subscriptions/checkout", "the billing provider won't resolve at startup", "my provider is authored but the backend can't reach it", "provider not reachable on the backend", or "make <provider> work on the backend host". Covers the
|
|
3
|
+
description: Enable billing (or make any backend-reachable external provider resolve) across the full multi-surface config chain. Use when the user says "enable billing", "turn on Stripe", "billing crash-loops the backend", "wire up subscriptions/checkout", "the billing provider won't resolve at startup", "my provider is authored but the backend can't reach it", "provider not reachable on the backend", or "make <provider> work on the backend host". Covers the 5 config surfaces (engine capability activation, backend billing block, backend provider scope, per-env secrets, `wildo config sync` regen), the auto-registered webhook route, and the failure-reason → surface debugging map.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Configure Billing
|
|
@@ -29,9 +29,15 @@ the backend crash-loops at startup with `PROVIDER_NOT_REACHABLE_ON_BACKEND`.
|
|
|
29
29
|
|
|
30
30
|
This skill teaches the billing case end-to-end and doubles as a **debugging
|
|
31
31
|
aid**: the framework classifies every billing-resolution failure into a reason
|
|
32
|
-
that maps 1:1 to the surface you must fix. Surfaces 1 and 3–
|
|
32
|
+
that maps 1:1 to the surface you must fix. Surfaces 1 and 3–5 are provider-agnostic —
|
|
33
33
|
the same chain makes any backend-reachable provider resolve.
|
|
34
34
|
|
|
35
|
+
**You do not declare an engine-shipped provider twice.** Scoping the ref is the
|
|
36
|
+
whole of it: discovery reads the engine's own provider barrel (and each installed
|
|
37
|
+
provider package's) and derives which runtimes reach a provider from
|
|
38
|
+
`providers.scopes`. A hand-authored `provider-contributions.ts` entry is for one
|
|
39
|
+
narrow case only — a provider module your application itself ships.
|
|
40
|
+
|
|
35
41
|
## App Paths
|
|
36
42
|
|
|
37
43
|
| Surface | Glob (relative to app root) |
|
|
@@ -40,7 +46,6 @@ the same chain makes any backend-reachable provider resolve.
|
|
|
40
46
|
| Engine capability activation | `./wildo.saas.config.ts` (`engineCapabilities[EngineCapability.BILLING]`) |
|
|
41
47
|
| Backend billing enable | `./backend-api/src/saas-config.backend.ts` (`billing: { enabled, providerRef }`) |
|
|
42
48
|
| Backend provider scope | `./wildo.saas.config.ts` (`providers.scopes.backend.providers.<ref>`) |
|
|
43
|
-
| Backend contribution | `./backend-api/src/provider-contributions.ts` |
|
|
44
49
|
| Per-env secrets | `./infrastructure/<env>/secrets/secrets.json` (`providerEnv`) |
|
|
45
50
|
| Generated artifact (do NOT hand-edit) | `./backend-api/src/generated/wildo-provider-runtime.generated.ts` |
|
|
46
51
|
|
|
@@ -65,7 +70,7 @@ the same chain makes any backend-reachable provider resolve.
|
|
|
65
70
|
|
|
66
71
|
### Step 1: Classify — new enablement, or a failing startup?
|
|
67
72
|
|
|
68
|
-
- **New**: install the provider SDK (Step 2, prerequisite) + author all
|
|
73
|
+
- **New**: install the provider SDK (Step 2, prerequisite) + author all five config surfaces below in one pass.
|
|
69
74
|
- **Failing**: read the fatal startup message, note its classified reason, and
|
|
70
75
|
jump straight to the matching surface via
|
|
71
76
|
`references/config-chain-and-failure-map.md` (failure → surface table).
|
|
@@ -113,16 +118,13 @@ In `./wildo.saas.config.ts`, add the ref under
|
|
|
113
118
|
Read `references/framework-backend-provider-reachability-api.md` for why this
|
|
114
119
|
scope (not the frontend one) is the one the backend registry reads.
|
|
115
120
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
source of capabilities, protocols, and the values-free secret-contract shape;
|
|
122
|
-
copying those fields into the app creates silent drift. See
|
|
123
|
-
`references/example-provider-contribution-and-backend-config.md`.
|
|
121
|
+
This scope is also what supplies the provider's RUNTIME TARGET. A provider
|
|
122
|
+
package is installed by many applications and cannot know any one application's
|
|
123
|
+
topology, so discovery discards the targets the package declares and derives
|
|
124
|
+
them from your scopes — which is why scoping is sufficient and a second
|
|
125
|
+
declaration is not merely redundant but a source of disagreement.
|
|
124
126
|
|
|
125
|
-
### Step
|
|
127
|
+
### Step 6: Surface 4 — populate the secrets
|
|
126
128
|
|
|
127
129
|
In `./infrastructure/<env>/secrets/secrets.json` → `providerEnv`, set the
|
|
128
130
|
env-var-named keys the provider's `secretsContract` declares
|
|
@@ -130,7 +132,7 @@ env-var-named keys the provider's `secretsContract` declares
|
|
|
130
132
|
See `references/example-backend-provider-module-shape.md` for where these
|
|
131
133
|
names come from.
|
|
132
134
|
|
|
133
|
-
### Step
|
|
135
|
+
### Step 7: Surface 5 — regenerate + verify webhook
|
|
134
136
|
|
|
135
137
|
Run `wildo config sync` (apps-manager must be up). Confirm `<ref>` appears in
|
|
136
138
|
`providerRefs` of the generated provider-runtime artifact, and that the backend
|
|
@@ -178,12 +180,14 @@ authoring only there is exactly the trap that leaves the backend unable to
|
|
|
178
180
|
resolve the provider.
|
|
179
181
|
|
|
180
182
|
## References
|
|
181
|
-
|
|
183
|
+
- `references/framework-billing-frontend-api.md` — `useBilling()`, `openCheckout`, `openCustomerPortal`: the frontend surface a bespoke purchase flow is built on
|
|
184
|
+
- `references/framework-product-catalog-api.md` — source-backed catalogue vocabularies and sync results; local retirement versus provider retirement and subscriber migration
|
|
185
|
+
- `references/framework-subscription-behavior-policy.md` — `behaviorPolicy` on a product: what trial, proration, cancellation and timing actually control, and the two fields that constrain nothing
|
|
182
186
|
- `references/config-chain-and-failure-map.md` — the 6-surface checklist, the failure-reason → surface map, the webhook route, and the generalization to non-billing providers
|
|
183
187
|
- `references/framework-backend-provider-reachability-api.md` — source: the backend registry catalog→artifact filter (why a mis-scoped provider is dropped)
|
|
184
188
|
- `references/framework-billing-resolution-failure-api.md` — source: the 5 classified resolution-failure reasons (the debugging map)
|
|
185
189
|
- `references/example-backend-provider-module-shape.md` — source: the provider module contract (capabilities / secretsContract / protocols) your authoring must match
|
|
186
|
-
- `references/example-
|
|
190
|
+
- `references/example-backend-billing-enable-block.md` — worked: the `billing` enable block the runtime reads
|
|
187
191
|
|
|
188
192
|
## Verification
|
|
189
193
|
|
|
@@ -191,7 +195,6 @@ resolve the provider.
|
|
|
191
195
|
- [ ] `EngineCapability.BILLING` explicitly enabled in `./wildo.saas.config.ts`
|
|
192
196
|
- [ ] Backend billing block present with `enabled` + `providerRef`
|
|
193
197
|
- [ ] Provider ref authored under `providers.scopes.backend.providers` (not only a frontend scope)
|
|
194
|
-
- [ ] Backend contribution declares the ref with `runtimeTargets: [{ kind: 'backend' }]`
|
|
195
198
|
- [ ] Billing scope declares `BILLING_PROVIDER` + `WEBHOOK_ORIGINATOR` protocols
|
|
196
199
|
- [ ] Secret env-var names populated in the per-env `providerEnv`
|
|
197
200
|
- [ ] `wildo config sync` re-run; ref appears in the generated artifact's `providerRefs`; backend boots clean
|
|
@@ -206,7 +209,7 @@ Run from the app root (substitute `<ref>` / `<env>`):
|
|
|
206
209
|
| Engine capability enabled | `rg -n "EngineCapability.BILLING.*enabled:\s*true" wildo.saas.config.ts` |
|
|
207
210
|
| Billing block declares provider ref | `rg -n "billing:\s*\{" -A3 backend-api/src/saas-config.backend.ts \| rg "providerRef:"` |
|
|
208
211
|
| **Ref authored in BACKEND scope** (must return a hit) | `rg -n "backend:\s*\{" -A80 wildo.saas.config.ts \| rg "<ref>:"` |
|
|
209
|
-
| **
|
|
212
|
+
| **No second declaration** (must return NOTHING for an engine-shipped or package-shipped provider) | `rg -n "<ref>" backend-api/src/provider-contributions.ts` |
|
|
210
213
|
| Billing scope declares both protocols | `rg -n "'BILLING_PROVIDER'.*'WEBHOOK_ORIGINATOR'\|'WEBHOOK_ORIGINATOR'.*'BILLING_PROVIDER'" wildo.saas.config.ts` |
|
|
211
214
|
| Secrets populated | `rg -n "STRIPE_SECRET_KEY\|STRIPE_WEBHOOK_SECRET" infrastructure/<env>/secrets/secrets.json` |
|
|
212
215
|
| **Ref materialized in the artifact** (must return a hit after sync) | `rg -n "<ref>" backend-api/src/generated/wildo-provider-runtime.generated.ts` |
|
|
@@ -220,11 +223,11 @@ signature.
|
|
|
220
223
|
|
|
221
224
|
| Rationalization | Reality |
|
|
222
225
|
|-----------------|---------|
|
|
223
|
-
| "I set `billing.enabled` + `providerRef` and the secret — that's everything." | That is only surfaces 2 and
|
|
226
|
+
| "I set `billing.enabled` + `providerRef` and the secret — that's everything." | That is only surfaces 2 and 4. Without engine activation (1), backend-scope authoring (3) and the regeneration that materializes it (5), exposure or provider resolution remains incomplete. |
|
|
224
227
|
| "The engine ships the Stripe integration, so I don't need any npm package." | The engine ships the ADAPTER; it lazy-`require`s the provider's SDK at runtime. You must add the SDK package (`stripe`) to `backend-api/package.json` and install it. Missing SDK fails when the adapter instantiates — a require/module-not-found error, distinct from the classified billing-resolution fatals. |
|
|
225
228
|
| "Stripe is already in `frontendServices` — the backend will find it." | Frontend scope is the browser SDK (Checkout.js), a DIFFERENT scope. The backend host reads only `providers.scopes.backend`. Same ref, two surfaces, two purposes. |
|
|
226
229
|
| "The fatal says secret missing, so I'll rotate the key." | Only if the reason is `SECRET_MISSING`. `PROVIDER_NOT_REACHABLE_ON_BACKEND` looks similar but is a scope/contribution gap — read the classified reason before touching the secret. |
|
|
227
|
-
| "Stripe is engine-shipped, I
|
|
230
|
+
| "Stripe is engine-shipped, so I still need to project it into `provider-contributions.ts`." | You do not, and doing so is a second declaration that can disagree with the engine. Discovery admits the engine's own provider package by name and reads its `./companion` barrel; the scope supplies the runtime target. Hand-author a contribution only for a provider module your application itself ships. |
|
|
228
231
|
| "I'll edit the generated `wildo-provider-runtime.generated.ts` to add the ref." | Generated artifact — hand edits are overwritten on the next sync and mask the real authoring gap. Fix surfaces 3/4 and re-run `wildo config sync`. |
|
|
229
232
|
|
|
230
233
|
## Red Flags
|
|
@@ -240,8 +243,10 @@ signature.
|
|
|
240
243
|
- Ref under `frontendServices` only, absent from the backend scope (catch with
|
|
241
244
|
the **Frontend-only trap** grep returning a hit while the backend-scope grep
|
|
242
245
|
is empty).
|
|
243
|
-
-
|
|
244
|
-
with the **
|
|
246
|
+
- An engine- or package-shipped ref ALSO hand-authored in
|
|
247
|
+
`backend-api/src/provider-contributions.ts` (catch with the **No second
|
|
248
|
+
declaration** grep — must return nothing). Discovery already supplies it; the
|
|
249
|
+
hand-authored copy exists only to drift from the package it duplicates.
|
|
245
250
|
- Billing scope missing `WEBHOOK_ORIGINATOR` (catch with the **both protocols**
|
|
246
251
|
grep) — webhooks silently never register.
|
|
247
252
|
- Secret env-var names absent from `providerEnv` (catch with the **Secrets
|
|
@@ -6,40 +6,51 @@ the rest wrong fails at startup. This file is the authoritative checklist and
|
|
|
6
6
|
the debugging aid: match the classified startup reason to the surface, fix it,
|
|
7
7
|
re-sync.
|
|
8
8
|
|
|
9
|
-
## Prerequisite — the provider SDK package (not one of the
|
|
9
|
+
## Prerequisite — the provider SDK package (not one of the five surfaces)
|
|
10
10
|
|
|
11
11
|
The engine ships the provider **adapter**, not the provider's SDK. The adapter
|
|
12
12
|
lazy-loads the SDK at runtime (`createRequire` → `require('stripe')`), so the app
|
|
13
13
|
backend MUST declare the SDK npm package in `./backend-api/package.json`
|
|
14
14
|
(`"stripe": "*"` for the Stripe billing provider) and install it. This is a
|
|
15
|
-
**prerequisite, not one of the
|
|
16
|
-
the classified startup reasons: if it is missing, all
|
|
15
|
+
**prerequisite, not one of the five config surfaces**, and it does NOT appear in
|
|
16
|
+
the classified startup reasons: if it is missing, all five surfaces can be correct
|
|
17
17
|
and the backend still fails when the adapter instantiates — a `Cannot find module
|
|
18
18
|
'stripe'` / require error at billing init (may surface as `RESOLUTION_ERROR` or a
|
|
19
19
|
raw module-not-found). Check it first whenever billing resolution looks correctly
|
|
20
20
|
authored but the provider still cannot be constructed.
|
|
21
21
|
|
|
22
|
-
## The
|
|
22
|
+
## The five surfaces (author all, in one pass)
|
|
23
23
|
|
|
24
24
|
| # | Surface | File | What to author |
|
|
25
25
|
|---|---------|------|----------------|
|
|
26
26
|
| 1 | Engine capability activation | `./wildo.saas.config.ts` → `engineCapabilities` | `[EngineCapability.BILLING]: { enabled: true }` |
|
|
27
27
|
| 2 | Backend billing enable | `./backend-api/src/saas-config.backend.ts` | `billing: { enabled: true, providerRef: 'stripe' }` |
|
|
28
28
|
| 3 | Backend provider scope | `./wildo.saas.config.ts` → `providers.scopes.backend.providers.<ref>` | `providerCapabilities: ['BILLING']`, `protocols: ['BILLING_PROVIDER', 'WEBHOOK_ORIGINATOR']`, `engineCapabilities: [EngineCapability.BILLING]` |
|
|
29
|
-
| 4 |
|
|
30
|
-
| 5 |
|
|
31
|
-
| 6 | Regenerate | run `wildo config sync` | regenerates the provider-runtime artifact (its `providerRefs` must now list `<ref>`) + `.env` files |
|
|
29
|
+
| 4 | Per-env secrets | `./infrastructure/<env>/secrets/secrets.json` → `providerEnv` | env-var-named keys `STRIPE_SECRET_KEY` + `STRIPE_WEBHOOK_SECRET` (emitted verbatim into the backend env) |
|
|
30
|
+
| 5 | Regenerate | run `wildo config sync` | regenerates the provider-runtime artifact (its `providerRefs` must now list `<ref>`) + `.env` files |
|
|
32
31
|
|
|
33
|
-
Surface
|
|
32
|
+
Surface 3 is the **classic trap**: authoring the provider only in a frontend
|
|
34
33
|
scope (`providers.scopes.frontendServices.<app>`) looks done, but that surface
|
|
35
34
|
is the browser SDK (e.g. Stripe Checkout.js) — a DIFFERENT scope from the
|
|
36
35
|
backend host that runs the billing SDK and verifies inbound webhooks. The
|
|
37
36
|
backend registry only exposes refs authored under `providers.scopes.backend`.
|
|
38
37
|
|
|
38
|
+
**There is no sixth surface projecting the provider into the backend package,
|
|
39
|
+
and there used to be.** An engine-shipped or package-shipped provider is
|
|
40
|
+
DISCOVERED: `discoverSaasProviderCompanionContributions` reads the provider
|
|
41
|
+
package's own `./companion` barrel, and — because a package installed by many
|
|
42
|
+
applications cannot know any one application's topology — derives its runtime
|
|
43
|
+
targets from `providers.scopes` rather than from what the package declares. So
|
|
44
|
+
surface 3 is both the reachability declaration and the target declaration.
|
|
45
|
+
|
|
46
|
+
Hand-author a `providerContributions` entry in a runtime owner's companion
|
|
47
|
+
barrel for ONE case: a provider module your application itself ships, which
|
|
48
|
+
neither the engine carries nor any installed provider package publishes.
|
|
49
|
+
|
|
39
50
|
> Billing note: the provider fills `EngineCapability.BILLING`, the same slot the
|
|
40
51
|
> application enables. Runtime billing-provider choice still comes from
|
|
41
52
|
> `billing.providerRef` (surface 2), so billing does not need a provider
|
|
42
|
-
> `selection` primary/
|
|
53
|
+
> `selection` primary/whenUnavailable entry. Capability activation and provider choice
|
|
43
54
|
> are distinct axes; both must agree on the canonical billing slot.
|
|
44
55
|
|
|
45
56
|
## Failure reason → surface
|
|
@@ -50,14 +61,15 @@ The fatal startup message names one classified reason (see
|
|
|
50
61
|
| Classified reason | Fix at surface |
|
|
51
62
|
|-------------------|----------------|
|
|
52
63
|
| `PROVIDER_REF_UNSET` | **2** — set `billing.providerRef` |
|
|
53
|
-
| `PROVIDER_NOT_REACHABLE_ON_BACKEND` | **3
|
|
64
|
+
| `PROVIDER_NOT_REACHABLE_ON_BACKEND` | **3** — author the ref under `providers.scopes.backend`, then re-sync (**5**). If it is already there, the artifact is stale: re-run `wildo config sync`. A ref that is scoped but that discovery cannot supply is refused AT SYNC, naming the scope — it never reaches a boot |
|
|
54
65
|
| `PROVIDER_DISABLED` | external-provider config — the ref resolves but is disabled for the `BILLING` protocol in this environment; enable it, then re-sync |
|
|
55
|
-
| `SECRET_MISSING` | **
|
|
66
|
+
| `SECRET_MISSING` | **4** — populate the env var named by the provider's `secretRef` in `providerEnv`, then re-sync |
|
|
67
|
+
| `NO_ADAPTER_FOR_SDK_PACKAGE` | **none — this is not an authoring gap.** Everything you author is right: the provider is reachable, enabled and its secret is present. The engine simply ships no billing adapter for the `sdkPackage` that provider declares, and the message lists the ones it does serve. Point `billing.providerRef` at a served provider, or ask for the adapter. Checked BEFORE the secret, so you are never sent to populate a credential that could not have been used |
|
|
56
68
|
| `RESOLUTION_ERROR` | the provider threw while resolving (registry / billing-SDK fault) — inspect the SDK wiring; not an authoring gap. **Common cause: the provider SDK package is not installed** (see Prerequisite above) |
|
|
57
69
|
|
|
58
70
|
## Webhooks
|
|
59
71
|
|
|
60
|
-
Declaring `WEBHOOK_ORIGINATOR` (
|
|
72
|
+
Declaring `WEBHOOK_ORIGINATOR` (surface 3) makes the webhook
|
|
61
73
|
auto-controller register an inbound route from the provider's declared
|
|
62
74
|
endpoints. For billing that is:
|
|
63
75
|
|
|
@@ -65,7 +77,7 @@ endpoints. For billing that is:
|
|
|
65
77
|
POST /api/v1/webhooks/{providerRef}/{endpoint.key} → POST /api/v1/webhooks/stripe/billing
|
|
66
78
|
```
|
|
67
79
|
|
|
68
|
-
Signature verification uses the `STRIPE_WEBHOOK_SECRET` secret (surface
|
|
80
|
+
Signature verification uses the `STRIPE_WEBHOOK_SECRET` secret (surface 4).
|
|
69
81
|
For local dev, forward Stripe events to the running backend:
|
|
70
82
|
|
|
71
83
|
```bash
|
|
@@ -74,12 +86,12 @@ stripe listen --forward-to localhost:<backend-port>/api/v1/webhooks/stripe/billi
|
|
|
74
86
|
|
|
75
87
|
## Generalizing beyond billing
|
|
76
88
|
|
|
77
|
-
Surfaces 1 and 3 →
|
|
89
|
+
Surfaces 1 and 3 → 5 are provider-agnostic: they are how ANY backend-reachable
|
|
78
90
|
provider (transactional email, server-side LLM, SMS, audit sink) is made
|
|
79
91
|
resolvable on the backend host. Only surface 2 and the webhook route are
|
|
80
92
|
billing-specific. Billing fills `EngineCapability.BILLING` but is selected by
|
|
81
93
|
its dedicated `billing.providerRef`; email/LLM providers use the generic
|
|
82
|
-
`selection` primary/
|
|
94
|
+
`selection` primary/whenUnavailable map. SSO currently has no mapped engine slot.
|
|
83
95
|
|
|
84
96
|
## App-backend env prep
|
|
85
97
|
|
package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md
ADDED
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# The `billing` enable block (worked example)
|
|
2
|
+
|
|
3
|
+
One of the five config surfaces, shown as a portable target-application example.
|
|
4
|
+
|
|
5
|
+
## Surface 2 — `billing` enable block in `saas-config.backend.ts`
|
|
6
|
+
|
|
7
|
+
The backend app config turns billing on and names the provider ref. This is
|
|
8
|
+
the entry point the runtime reads; everything else exists to make that ref
|
|
9
|
+
resolvable on the backend host.
|
|
10
|
+
|
|
11
|
+
|
|
12
|
+
## Usage Example
|
|
13
|
+
|
|
14
|
+
```typescript
|
|
15
|
+
billing: {
|
|
16
|
+
// Enabled for local dev against a test-mode Stripe connector.
|
|
17
|
+
// Requires a resolvable provider — the framework ships only a Stripe
|
|
18
|
+
// adapter — so `providerRef: 'stripe'` must be paired with the
|
|
19
|
+
// `STRIPE_SECRET_KEY` (billing API) and `STRIPE_WEBHOOK_SECRET`
|
|
20
|
+
// (webhook signature verification) secrets in the per-env
|
|
21
|
+
// `providerEnv` map (see `infrastructure/local/secrets/secrets.json`).
|
|
22
|
+
// With `enabled: true` and no resolvable provider, startup fails loud
|
|
23
|
+
// (see `StartApplicationBackendService.initializeBillingServices`).
|
|
24
|
+
// To disable: set `enabled: false` (providerRef then becomes inert).
|
|
25
|
+
enabled: true,
|
|
26
|
+
providerRef: 'stripe',
|
|
27
|
+
},
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## There is no companion "backend contribution" surface
|
|
31
|
+
|
|
32
|
+
This file used to carry a second section showing a hand-authored
|
|
33
|
+
`./backend-api/src/provider-contributions.ts` entry projecting the engine's own
|
|
34
|
+
Stripe contribution back at it. That surface no longer exists for an
|
|
35
|
+
engine-shipped or package-shipped provider: discovery reads the provider
|
|
36
|
+
package's own `./companion` barrel and derives the runtime targets from
|
|
37
|
+
`providers.scopes`, so scoping the ref (surface 3) is the whole declaration.
|
|
38
|
+
|
|
39
|
+
Both dogfood applications deleted their backend `provider-contributions.ts`
|
|
40
|
+
accordingly, which is why no worked example of one is shown here — inventing
|
|
41
|
+
one would teach the duplication the framework removed.
|
package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
# Backend provider module shape (Stripe, engine-owned)
|
|
2
2
|
|
|
3
3
|
Read this to see the contract your authoring must line up with. You do **not**
|
|
4
|
-
write this file — engine-shipped providers already declare it — but
|
|
5
|
-
backend-scope entry in `./wildo.saas.config.ts`
|
|
6
|
-
`
|
|
7
|
-
`
|
|
4
|
+
write this file — engine-shipped providers already declare it — but your
|
|
5
|
+
backend-scope entry in `./wildo.saas.config.ts` must agree with the module's
|
|
6
|
+
`ref`, `providerCapabilities` and `protocols`, and your per-env secrets with its
|
|
7
|
+
`secretsContract`. `wildo config sync` refuses a scope that claims a capability
|
|
8
|
+
or protocol discovery does not report for that runtime. In particular:
|
|
8
9
|
|
|
9
10
|
- `secretsContract.*.envVarName` are the **exact** keys you populate in the
|
|
10
11
|
per-env `providerEnv` secrets (`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`).
|
|
@@ -19,9 +20,11 @@ backend-scope entry in `./wildo.saas.config.ts` and every backend
|
|
|
19
20
|
/**
|
|
20
21
|
* Shape of a backend provider module (illustrated by the engine's built-in
|
|
21
22
|
* Stripe billing provider). App authors do NOT write this — engine-shipped
|
|
22
|
-
* providers already declare it —
|
|
23
|
-
* provider
|
|
24
|
-
* `
|
|
23
|
+
* providers already declare it — and they do not project it into a backend
|
|
24
|
+
* `provider-contributions.ts` either: discovery reads this package's own
|
|
25
|
+
* `./companion` barrel and derives runtime targets from `providers.scopes`.
|
|
26
|
+
* It is the contract your backend-scope provider authoring in
|
|
27
|
+
* `./wildo.saas.config.ts` must line up with:
|
|
25
28
|
*
|
|
26
29
|
* - `metadata.ref` — the provider ref you reference everywhere (`'stripe'`).
|
|
27
30
|
* - `providerCapabilities` — the built-in capabilities the provider fills
|
|
@@ -35,9 +38,18 @@ backend-scope entry in `./wildo.saas.config.ts` and every backend
|
|
|
35
38
|
* `POST /api/v1/webhooks/stripe/billing` from the declared `endpoints`).
|
|
36
39
|
*/
|
|
37
40
|
export const StripeBackendProvider: BackendProviderModule = {
|
|
38
|
-
metadata: {
|
|
39
|
-
ref:
|
|
40
|
-
|
|
41
|
+
metadata: defineProviderMetadata({
|
|
42
|
+
ref: 'stripe',
|
|
43
|
+
packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE_NAME,
|
|
44
|
+
tier: ProviderTier.MAIN,
|
|
45
|
+
origin: ENGINE_PROVIDER_ORIGIN,
|
|
46
|
+
}),
|
|
47
|
+
// WHO can run this, and where its vendor processes — read by the compliance-document lane to
|
|
48
|
+
// decide whether this provider is a third-party recipient at all (issue #130).
|
|
49
|
+
complianceProfile: {
|
|
50
|
+
deploymentModels: [ProviderDeploymentModel.VENDOR_HOSTED],
|
|
51
|
+
processingRegions: ['us-east-1', 'eu-west-1'],
|
|
52
|
+
vendorLegalEntityName: 'Stripe, Inc.',
|
|
41
53
|
},
|
|
42
54
|
providerCapabilities: [
|
|
43
55
|
BUILTIN_PROVIDER_CAPABILITY.BILLING,
|
|
@@ -57,9 +69,8 @@ export const StripeBackendProvider: BackendProviderModule = {
|
|
|
57
69
|
protocols: [
|
|
58
70
|
{
|
|
59
71
|
protocol: "BILLING_PROVIDER",
|
|
60
|
-
designTimeExposed: false,
|
|
61
72
|
runtimeContract: {
|
|
62
|
-
kind:
|
|
73
|
+
kind: ProviderProtocolRuntimeKind.BILLING,
|
|
63
74
|
secretRef: "STRIPE_SECRET_KEY",
|
|
64
75
|
sdkPackage: "stripe",
|
|
65
76
|
apiVersion: "2026-01-28.clover",
|
|
@@ -72,19 +83,28 @@ export const StripeBackendProvider: BackendProviderModule = {
|
|
|
72
83
|
"meteredUsage"
|
|
73
84
|
]
|
|
74
85
|
},
|
|
75
|
-
parameterSchema: z.unknown()
|
|
76
86
|
},
|
|
77
87
|
{
|
|
78
88
|
protocol: "WEBHOOK_ORIGINATOR",
|
|
79
|
-
designTimeExposed: false,
|
|
80
89
|
runtimeContract: {
|
|
81
|
-
kind:
|
|
90
|
+
kind: ProviderProtocolRuntimeKind.WEBHOOK_ORIGINATOR,
|
|
82
91
|
secretRef: "STRIPE_WEBHOOK_SECRET",
|
|
83
92
|
signatureHeaderName: "stripe-signature",
|
|
84
93
|
endpoints: [
|
|
85
94
|
{
|
|
86
95
|
key: 'billing',
|
|
87
|
-
|
|
96
|
+
/**
|
|
97
|
+
* The CAPABILITY this endpoint dispatches to — always a `BUILTIN_PROVIDER_CAPABILITY`
|
|
98
|
+
* member, never a hand-spelled string.
|
|
99
|
+
*
|
|
100
|
+
* The engine matches this value against the key the capability module registered, and
|
|
101
|
+
* that module takes its key from this same enum. Both sides are typed `string`, so a
|
|
102
|
+
* spelling difference does not fail to compile: it withholds the route at startup and
|
|
103
|
+
* the endpoint answers 404 for the life of the deployment. Note `key` above is a
|
|
104
|
+
* different field — it is the URL segment (`/webhooks/stripe/billing`) and is
|
|
105
|
+
* lowercase for that reason.
|
|
106
|
+
*/
|
|
107
|
+
capability: BUILTIN_PROVIDER_CAPABILITY.BILLING,
|
|
88
108
|
signatureConfig: {
|
|
89
109
|
algorithm: Hook_SignatureAlgorithm.HMAC_SHA256,
|
|
90
110
|
},
|
|
@@ -108,7 +128,6 @@ export const StripeBackendProvider: BackendProviderModule = {
|
|
|
108
128
|
},
|
|
109
129
|
],
|
|
110
130
|
},
|
|
111
|
-
parameterSchema: z.unknown()
|
|
112
131
|
}
|
|
113
132
|
],
|
|
114
133
|
};
|