@wildo-ai/framework-knowledge 1.1.3 → 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 +349 -17
- 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/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +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.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.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
|
@@ -5,7 +5,9 @@ backend host**. This is the seam that decides which providers a backend
|
|
|
5
5
|
process can resolve at runtime: the composed catalog (engine-shipped +
|
|
6
6
|
app-contributed) is filtered down to the refs the generated provider-runtime
|
|
7
7
|
artifact declares for this host, and that artifact is projected from the
|
|
8
|
-
`providers.scopes.backend` authoring
|
|
8
|
+
`providers.scopes.backend` authoring intersected with what discovery found —
|
|
9
|
+
the engine's own provider barrel, each installed provider package's, and any
|
|
10
|
+
`providerContributions` a runtime owner declares in its own companion barrel.
|
|
9
11
|
|
|
10
12
|
A provider authored only in a **non-backend** scope (e.g.
|
|
11
13
|
`providers.scopes.frontendServices.<app>`) never enters this registry. Any
|
|
@@ -24,46 +26,46 @@ scope was filtered out here.
|
|
|
24
26
|
|
|
25
27
|
```typescript
|
|
26
28
|
/**
|
|
27
|
-
*
|
|
28
|
-
* (auth, billing, notifications, …) will resolve through.
|
|
29
|
+
* Adopt the registry a host RESOLVED, and re-check it against what that host declared.
|
|
29
30
|
*
|
|
30
|
-
* This is the seam that decides which providers a backend host can actually
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
* matching backend contribution (`runtimeTargets: [{ kind: 'backend' }]`) so
|
|
37
|
-
* `wildo config sync` lists its ref in the generated provider-runtime
|
|
38
|
-
* artifact — otherwise it is filtered out here.
|
|
31
|
+
* This is the seam that decides which providers a backend host can actually reach at runtime. A
|
|
32
|
+
* provider authored only in a NON-backend scope (e.g. `providers.scopes.frontendServices.<app>`)
|
|
33
|
+
* never enters this registry, so any backend feature keyed on it (billing, transactional email,
|
|
34
|
+
* server-side LLM calls) resolves nothing and fails at startup. Author the provider under
|
|
35
|
+
* `providers.scopes.backend` in `./wildo.saas.config.ts` so `wildo config sync` lists its ref in
|
|
36
|
+
* the generated provider-runtime artifact — otherwise it is filtered out here.
|
|
39
37
|
*
|
|
40
38
|
* Composition model:
|
|
41
39
|
*
|
|
42
|
-
* 1. The **
|
|
43
|
-
*
|
|
44
|
-
*
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
*
|
|
48
|
-
*
|
|
49
|
-
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
* is no silent fallback to the unfiltered catalog.
|
|
40
|
+
* 1. The **runtime artifact** (`providerRuntime`, generated by `wildo config sync` and imported by
|
|
41
|
+
* the application bootstrap) declares which providers this specific process may expose.
|
|
42
|
+
* 2. `resolveBackendProviderRegistry` LOADS exactly those refs — an application-supplied module
|
|
43
|
+
* first, then the engine's on-demand map, then a dynamic import of the package the artifact
|
|
44
|
+
* names — and hands the composed result here. Nothing a process did not declare is imported,
|
|
45
|
+
* which is the whole point: a worker that declares one email provider evaluates one provider.
|
|
46
|
+
* 3. This method re-filters that registry to the artifact's `providerRefs` and REFUSES if any ref
|
|
47
|
+
* is still missing. That is not redundant with the loader: the loader deliberately does not
|
|
48
|
+
* throw, so this stays the one place a deployment gap is reported, and it reports ALL of them at
|
|
49
|
+
* once rather than the first import that failed.
|
|
53
50
|
*
|
|
54
|
-
* When `providerRuntime` is `undefined
|
|
55
|
-
*
|
|
56
|
-
* platform applications that initialize their config later).
|
|
51
|
+
* When `providerRuntime` is `undefined` no filtering is applied — the host declared no topology, so
|
|
52
|
+
* there is nothing to filter against, and the loader will have handed over the whole engine
|
|
53
|
+
* catalogue (platform applications that initialize their config later).
|
|
54
|
+
*
|
|
55
|
+
* `unresolvedReasons` carries the loader's per-ref explanation into the refusal below, so an
|
|
56
|
+
* operator is told WHY a ref did not resolve (no package declares it / the import threw / the
|
|
57
|
+
* package exports no fragment) instead of only that it was absent.
|
|
57
58
|
*/
|
|
58
59
|
initialize(
|
|
59
|
-
registry: BackendProviderRegistry
|
|
60
|
+
registry: BackendProviderRegistry,
|
|
60
61
|
providerRuntime?: ProviderRuntimeArtifact,
|
|
62
|
+
unresolvedReasons?: ReadonlyMap<string, string>,
|
|
61
63
|
): void {
|
|
62
64
|
if (!providerRuntime) {
|
|
63
65
|
this.registry = registry;
|
|
64
66
|
return;
|
|
65
67
|
}
|
|
66
68
|
|
|
67
|
-
this.registry = filterRegistryByProviderRuntime(registry, providerRuntime);
|
|
69
|
+
this.registry = filterRegistryByProviderRuntime(registry, providerRuntime, unresolvedReasons);
|
|
68
70
|
}
|
|
69
71
|
```
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
# Framework Billing Frontend API
|
|
2
|
+
|
|
3
|
+
What an application's own frontend reads and calls about billing: `useBilling()`, the product
|
|
4
|
+
catalogue, usage, and the two actions that start a purchase or open the provider's portal.
|
|
5
|
+
|
|
6
|
+
Read it when composing a purchase flow, a plan picker, or any screen that has to know what the
|
|
7
|
+
customer currently has.
|
|
8
|
+
|
|
9
|
+
## The context is the whole surface
|
|
10
|
+
|
|
11
|
+
`useBilling()` throws outside a `BillingProvider`. `useBillingSafe()` returns `undefined` instead —
|
|
12
|
+
use it in a component that may render before the provider mounts, or in an application where billing
|
|
13
|
+
may be off.
|
|
14
|
+
|
|
15
|
+
The shipped billing components read this context, so a bespoke billing flow can share their scoped
|
|
16
|
+
state. The provider builds the request. Feature-gating hooks read the separate `FeaturesContext`
|
|
17
|
+
and its resolved-entitlements endpoint; billing-state availability is not an entitlement decision.
|
|
18
|
+
|
|
19
|
+
## Two actions, and one behaviour that reads as a bug
|
|
20
|
+
|
|
21
|
+
`openCheckout(productKey, priceId, options)` posts to the scoped billing-account route and follows
|
|
22
|
+
the returned URL. **A second call while one is in flight is IGNORED** — a double-click cannot open two
|
|
23
|
+
sessions. Do not add a guard expecting otherwise, and do not read the silence as a failure.
|
|
24
|
+
|
|
25
|
+
The `priceId` must belong to the product named by `productKey`; a mismatched pair is refused. Resolve
|
|
26
|
+
it through `getPricesForProduct(productId)` rather than assuming an ordering.
|
|
27
|
+
|
|
28
|
+
`openCustomerPortal()` opens the provider's own portal. Payment methods, card updates and receipt
|
|
29
|
+
downloads live THERE and are deliberately not rendered by the framework — an application that needs
|
|
30
|
+
them links the portal rather than building them.
|
|
31
|
+
|
|
32
|
+
## Empty data and unavailable data are different
|
|
33
|
+
|
|
34
|
+
Check `isSliceAvailable(BillingStateSlice.INVOICES)` before treating an empty invoice list as
|
|
35
|
+
“no invoices”. The `availability` map uses `BillingStateSlice` keys and
|
|
36
|
+
`BillingSliceAvailability.AVAILABLE` / `UNAVAILABLE` values from `@wildo-ai/saas-models`.
|
|
37
|
+
An available empty slice is a successful read; an unavailable slice carries a fallback value that
|
|
38
|
+
must not be presented as confirmed absence. Keep available sections visible and use `refetch` for
|
|
39
|
+
retry. An unknown subscription must not become a “no plan” message or a new-purchase invitation.
|
|
40
|
+
|
|
41
|
+
The availability keys cover the billing account, subscription, products, prices, invoices, usage,
|
|
42
|
+
credit pools and active promotions. Dependencies matter: a failed subscription read also makes
|
|
43
|
+
usage unavailable because the period cannot be established; a failed products read makes active
|
|
44
|
+
promotions unavailable. Failed account lookup does not auto-create a replacement billing account.
|
|
45
|
+
|
|
46
|
+
`error` remains the request-wide failure channel. Per-slice failures are carried by `availability`,
|
|
47
|
+
without raw backend exception details. Check `isLoading` first, then distinguish request-wide errors,
|
|
48
|
+
slice unavailability, confirmed empty results and populated results.
|
|
49
|
+
|
|
50
|
+
## Two limits on what the context carries
|
|
51
|
+
|
|
52
|
+
- **`usage` is only populated if the application RECORDS metered consumption.** Nothing is automatic:
|
|
53
|
+
an available usage slice with no recorded consumption is genuinely empty. An unavailable slice is not evidence of zero consumption.
|
|
54
|
+
- **`invoices` carries the fifty most recent**, which is what the shipped history component renders.
|
|
55
|
+
Reading further means reading the invoices resource directly.
|
|
56
|
+
|
|
57
|
+
## Related
|
|
58
|
+
|
|
59
|
+
- `references/framework-product-catalog-api.md` — the `ProductDefinition[]` this context surfaces.
|
|
60
|
+
- `references/framework-subscription-behavior-policy.md` — how a change settles once bought.
|
|
61
|
+
|
|
62
|
+
## Billing Context
|
|
63
|
+
|
|
64
|
+
## Import Origins
|
|
65
|
+
|
|
66
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
67
|
+
|
|
68
|
+
## Source Excerpts
|
|
69
|
+
|
|
70
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
71
|
+
|
|
72
|
+
```tsx
|
|
73
|
+
*
|
|
74
|
+
* Everything an application's own frontend reads or does about billing. Reached with `useBilling()`,
|
|
75
|
+
* which throws outside a `BillingProvider`; `useBillingSafe()` returns `undefined` instead, for a
|
|
76
|
+
* component that may render before the provider mounts or in an application where billing is off.
|
|
77
|
+
*
|
|
78
|
+
* The shipped billing components and the feature-gating hooks read this same context, so an
|
|
79
|
+
* application composing its own purchase flow works from exactly what they do — no application code
|
|
80
|
+
* builds the request.
|
|
81
|
+
*
|
|
82
|
+
* ## Starting a purchase
|
|
83
|
+
*
|
|
84
|
+
* `openCheckout(productKey, priceId, options)` posts to the scoped billing-account route and follows
|
|
85
|
+
* the returned URL; success and cancel destinations come from the application's own redirect base. A
|
|
86
|
+
* SECOND call while one is in flight is IGNORED, so a double-click cannot open two sessions — do not
|
|
87
|
+
* add your own guard expecting otherwise, and do not read the silence as a failure.
|
|
88
|
+
*
|
|
89
|
+
* The `priceId` must belong to the product named by `productKey`; the checkout operation refuses a
|
|
90
|
+
* mismatched pair. Resolve it through `getPricesForProduct` rather than assuming an ordering.
|
|
91
|
+
*
|
|
92
|
+
* `openCustomerPortal()` opens the provider's own portal — which is where payment methods, card
|
|
93
|
+
* updates and receipt downloads live. Those are deliberately NOT rendered by the framework, so an
|
|
94
|
+
* application that needs them links the portal rather than building them.
|
|
95
|
+
*
|
|
96
|
+
* ## What `usage` contains
|
|
97
|
+
*
|
|
98
|
+
* Metered consumption appears here only if the application RECORDS it. Nothing is automatic: a
|
|
99
|
+
* metered product with no recorded usage shows an empty dashboard rather than an error.
|
|
100
|
+
*
|
|
101
|
+
* ## Invoices are capped
|
|
102
|
+
*
|
|
103
|
+
* `invoices` carries the fifty most recent, which is what the shipped history component renders. An
|
|
104
|
+
* application needing more reads the invoices resource directly.
|
|
105
|
+
*/
|
|
106
|
+
export type BillingPlanChangeTarget = z.infer<typeof BillingSubscription_PreviewPlanChangeRequestDto>;
|
|
107
|
+
export type BillingPlanChangeConfirmation = z.infer<typeof BillingSubscription_ChangePlanRequestDto>;
|
|
108
|
+
export type BillingPlanChangePreviewResponse = z.infer<typeof BillingSubscription_PlanChangePreviewResponseDto>;
|
|
109
|
+
|
|
110
|
+
export interface BillingContextType {
|
|
111
|
+
// ── Configuration ──
|
|
112
|
+
isEnabled: boolean;
|
|
113
|
+
billingConfiguration: BillingConfiguration | undefined;
|
|
114
|
+
billingProvider: FrontendAppProviderModule | null;
|
|
115
|
+
|
|
116
|
+
// ── Billing State ──
|
|
117
|
+
billingAccount: BillingAccount | null;
|
|
118
|
+
subscription: BillingSubscriptionBase | null;
|
|
119
|
+
currentPlanKey: string | null;
|
|
120
|
+
currentPlanProduct: Product | null;
|
|
121
|
+
|
|
122
|
+
// ── Product Catalog ──
|
|
123
|
+
products: Product[];
|
|
124
|
+
prices: Price[];
|
|
125
|
+
productDefinitions: ProductDefinition[];
|
|
126
|
+
getPricesForProduct: (productId: string) => Price[];
|
|
127
|
+
getProductByKey: (key: string) => Product | undefined;
|
|
128
|
+
|
|
129
|
+
// ── Scope ──
|
|
130
|
+
currentScope: ResourcePrimaryScope | null;
|
|
131
|
+
|
|
132
|
+
// ── Invoices ──
|
|
133
|
+
invoices: InvoiceRef[];
|
|
134
|
+
|
|
135
|
+
// ── Promotions ──
|
|
136
|
+
activePromotions: Promotion[];
|
|
137
|
+
|
|
138
|
+
// ── Usage & Credits ──
|
|
139
|
+
usage: UsageSummary;
|
|
140
|
+
creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;
|
|
141
|
+
|
|
142
|
+
// ── Actions ──
|
|
143
|
+
openCheckout: (productKey: string, priceId: string, options?: {
|
|
144
|
+
quantity?: number;
|
|
145
|
+
promotionCode?: string;
|
|
146
|
+
}) => Promise<void>;
|
|
147
|
+
|
|
148
|
+
openCustomerPortal: () => Promise<void>;
|
|
149
|
+
/** Provider estimate bound to the current subscription and selected target; never commits a change. */
|
|
150
|
+
previewPlanChange: (target: BillingPlanChangeTarget, options?: { signal?: AbortSignal }) => Promise<BillingPlanChangePreviewResponse>;
|
|
151
|
+
/** Confirm only the server token returned for the displayed preview. Successful mutation refreshes billing state. */
|
|
152
|
+
confirmPlanChange: (confirmation: BillingPlanChangeConfirmation) => Promise<void>;
|
|
153
|
+
|
|
154
|
+
// ── State ──
|
|
155
|
+
isLoading: boolean;
|
|
156
|
+
error: Error | null;
|
|
157
|
+
/** Only a successful slice read establishes emptiness; failed or absent state is unavailable. */
|
|
158
|
+
availability: BillingStateAvailability | null;
|
|
159
|
+
isSliceAvailable: (slice: BillingStateSlice) => boolean;
|
|
160
|
+
|
|
161
|
+
// ── Actions ──
|
|
162
|
+
refetch: () => void;
|
|
163
|
+
}
|
|
164
|
+
|
|
165
|
+
// ── Default empty state ──
|
|
166
|
+
const EMPTY_USAGE: UsageSummary = {
|
|
167
|
+
byProduct: {},
|
|
168
|
+
};
|
|
169
|
+
```
|
|
@@ -1,17 +1,31 @@
|
|
|
1
1
|
# Billing resolution failure reasons — the debugging map
|
|
2
2
|
|
|
3
3
|
Read this when `billing.enabled: true` crash-loops the backend at startup. The
|
|
4
|
-
framework classifies **why** the billing provider could not resolve
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
authoring.
|
|
4
|
+
framework classifies **why** the billing provider could not resolve, and almost
|
|
5
|
+
every reason names the ONE config surface to fix. The fatal startup message is
|
|
6
|
+
built from this enum, so it points you at the right file instead of the
|
|
7
|
+
historical catch-all ("set providerRef + its secret") that misdirected authors
|
|
8
|
+
to the secret when the real gap was backend-scope authoring.
|
|
10
9
|
|
|
11
10
|
Use it as a lookup: read the reason in the startup error, then jump to the
|
|
12
11
|
matching surface. The full surface-by-surface fix is in
|
|
13
12
|
`config-chain-and-failure-map.md`.
|
|
14
13
|
|
|
14
|
+
**One reason is not a config surface, and it is worth knowing before you go
|
|
15
|
+
looking for one.** `NO_ADAPTER_FOR_SDK_PACKAGE` means your provider is
|
|
16
|
+
reachable, enabled and holds its secret — everything you author is correct —
|
|
17
|
+
but the engine ships no billing adapter for the `sdkPackage` that provider's
|
|
18
|
+
runtime contract declares. A standard billing adapter is roughly thirty methods
|
|
19
|
+
of translation between the provider's API and the framework's billing
|
|
20
|
+
interface, so it cannot be derived from a declaration; it has to exist. No edit
|
|
21
|
+
to `wildo.saas.config.ts` fixes this. Point `billing.providerRef` at a provider
|
|
22
|
+
whose SDK is served — the message lists which are — or treat it as a framework
|
|
23
|
+
request.
|
|
24
|
+
|
|
25
|
+
The list below is the source of truth for the reasons that exist; read it
|
|
26
|
+
rather than a count, because a reason added to the enum appears here and in no
|
|
27
|
+
prose anyone has to remember to update.
|
|
28
|
+
|
|
15
29
|
## Import Origins
|
|
16
30
|
|
|
17
31
|
- `@wildo-ai/saas-backend-lib`
|
|
@@ -31,9 +45,10 @@ matching surface. The full surface-by-surface fix is in
|
|
|
31
45
|
* Read this as a debugging map — the fatal startup message names the surface,
|
|
32
46
|
* and each reason below is the surface:
|
|
33
47
|
* - PROVIDER_REF_UNSET → `billing.providerRef` in `./backend-api/src/saas-config.backend.ts`
|
|
34
|
-
* - PROVIDER_NOT_REACHABLE_ON_BACKEND → author the ref under `providers.scopes.backend` in `./wildo.saas.config.ts`
|
|
48
|
+
* - PROVIDER_NOT_REACHABLE_ON_BACKEND → author the ref under `providers.scopes.backend` in `./wildo.saas.config.ts` (the classic trap: authored only in a frontend scope), then `wildo config sync`. An engine-shipped or package-shipped provider needs NO hand-authored contribution: discovery reads the provider package's own `./companion` barrel and derives the backend target from that scope
|
|
35
49
|
* - PROVIDER_DISABLED → the ref resolves but is disabled for the BILLING protocol in external-provider config
|
|
36
50
|
* - SECRET_MISSING → the env var named by the provider's `secretRef` is absent from the per-env `providerEnv` secrets
|
|
51
|
+
* - NO_ADAPTER_FOR_SDK_PACKAGE → the engine ships no billing adapter for the `sdkPackage` the provider declares. The one reason here that is NOT a config surface — no application edit fixes it
|
|
37
52
|
* - RESOLUTION_ERROR → the provider threw while resolving (registry / billing-SDK fault)
|
|
38
53
|
*/
|
|
39
54
|
enum BillingProviderResolutionFailureReason {
|
|
@@ -41,16 +56,34 @@ enum BillingProviderResolutionFailureReason {
|
|
|
41
56
|
PROVIDER_REF_UNSET = 'provider-ref-unset',
|
|
42
57
|
/**
|
|
43
58
|
* `providerRef` is set, but no billing runtime contract is exposed to the
|
|
44
|
-
* backend registry for it — the provider is not
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
*
|
|
59
|
+
* backend registry for it — the provider is not in the generated
|
|
60
|
+
* provider-runtime artifact this host loads, so it was filtered out of the
|
|
61
|
+
* active catalog.
|
|
62
|
+
*
|
|
63
|
+
* Almost always one of two things: the ref is not authored under
|
|
64
|
+
* `providers.scopes.backend` (the common trap — it is authored only in a
|
|
65
|
+
* frontend scope), or the artifact has not been regenerated since it was.
|
|
66
|
+
*
|
|
67
|
+
* A ref that is scoped but that discovery cannot supply for this runtime is
|
|
68
|
+
* NOT this reason: `validateDiscoveredSaasProviderContributions` refuses that
|
|
69
|
+
* at `wildo config sync`, naming the scope, long before a boot.
|
|
48
70
|
*/
|
|
49
71
|
PROVIDER_NOT_REACHABLE_ON_BACKEND = 'provider-not-reachable-on-backend',
|
|
50
72
|
/** The provider resolves but is disabled by external-provider configuration. */
|
|
51
73
|
PROVIDER_DISABLED = 'provider-disabled',
|
|
52
74
|
/** The provider resolves but its secret (env var `secretRef`) is absent. */
|
|
53
75
|
SECRET_MISSING = 'secret-missing',
|
|
76
|
+
/**
|
|
77
|
+
* The provider is reachable, enabled and holds its secret, but the engine ships no billing
|
|
78
|
+
* adapter for the `sdkPackage` its runtime contract declares.
|
|
79
|
+
*
|
|
80
|
+
* This is a FRAMEWORK gap rather than an application misconfiguration — the only one of these
|
|
81
|
+
* reasons the operator cannot fix by editing config — and it exists so that state is stated.
|
|
82
|
+
* Until this reason existed, that configuration silently received Stripe's adapter built over
|
|
83
|
+
* the other provider's secret, because the resolution narrowed on the protocol `kind` and then
|
|
84
|
+
* constructed one named class. `detail` carries the unserved `sdkPackage`.
|
|
85
|
+
*/
|
|
86
|
+
NO_ADAPTER_FOR_SDK_PACKAGE = 'no-adapter-for-sdk-package',
|
|
54
87
|
/** An unexpected error was thrown while resolving (registry/SDK fault). */
|
|
55
88
|
RESOLUTION_ERROR = 'resolution-error',
|
|
56
89
|
}
|
|
@@ -0,0 +1,187 @@
|
|
|
1
|
+
# Framework Product Catalog API
|
|
2
|
+
|
|
3
|
+
The vocabularies an application types into its own product catalogue — the `ProductDefinition[]` it
|
|
4
|
+
exports from its shared library and hands to the engine with its module declarations.
|
|
5
|
+
|
|
6
|
+
Read this before authoring or editing a product.
|
|
7
|
+
|
|
8
|
+
```ts
|
|
9
|
+
export const CUSTOM_PRODUCT_CATALOG: ProductDefinition[] = [{
|
|
10
|
+
key: 'org-professional',
|
|
11
|
+
type: ProductType.PLAN,
|
|
12
|
+
targetScopes: [ResourcePrimaryScope.ORGANIZATIONS],
|
|
13
|
+
grantedFeatures: [ApplicationFeature.BULK_EXPORT],
|
|
14
|
+
grantedLimits: { [ApplicationFeature.MAX_TODO_LISTS]: { value: 100, mode: LimitGrantMode.SET } },
|
|
15
|
+
planTier: 'professional',
|
|
16
|
+
planTierOrder: 1,
|
|
17
|
+
prices: [{ model: PricingModel.FLAT, unitPrice: { amount: 2900n, decimals: 2, currency: 'USD' },
|
|
18
|
+
interval: BillingInterval.MONTH, intervalCount: 1, isDefault: true }],
|
|
19
|
+
}];
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## ⚠️ The catalogue is one-way
|
|
23
|
+
|
|
24
|
+
A complete `ProductCatalogSyncBackendService.syncProductCatalog()` pass compares active local products
|
|
25
|
+
with the authored keys. A disappeared key is retired locally: the product and its active prices become
|
|
26
|
+
inactive. The rows are retained so subscriptions and invoices keep their references.
|
|
27
|
+
|
|
28
|
+
The result reports retired keys in `retired` and those with live subscribers in
|
|
29
|
+
`retiredWithLiveSubscribers`. Those subscriptions are not migrated or cancelled; decide whether to
|
|
30
|
+
migrate, grandfather or cancel them explicitly. Inspect `errors` as well as successful results.
|
|
31
|
+
|
|
32
|
+
Provider catalogue retirement is separate. Synchronization does not archive removed provider products
|
|
33
|
+
or prices, and provider-dashboard edits are not read back into the authored catalogue. Existing linked
|
|
34
|
+
provider records are not rewritten merely because a declaration changes. Provider archiving and
|
|
35
|
+
customer migration remain deliberate operations after reviewing affected subscribers.
|
|
36
|
+
|
|
37
|
+
Make every change through the array, and treat the provider dashboard as read-only for anything the
|
|
38
|
+
catalogue owns.
|
|
39
|
+
|
|
40
|
+
## Recurring cadence
|
|
41
|
+
|
|
42
|
+
Author the period with both `interval` and `intervalCount`. `BillingInterval.MONTH` with a count of `3` means every three months; omitted count defaults to `1`. Catalogue synchronization stores the authored cadence and carries it to the billing provider. A one-time price has no recurring interval. Changing a declaration does not rewrite an already linked provider price; review existing subscriptions and provider mappings when changing cadence.
|
|
43
|
+
|
|
44
|
+
## Money is a `MoneyValue`, and its scale is now honoured
|
|
45
|
+
|
|
46
|
+
`amount` is a bigint of MINOR UNITS with its own `decimals`. Sync converts from the authored scale to
|
|
47
|
+
the currency's smallest unit, and **refuses a price it cannot convert exactly** rather than rounding
|
|
48
|
+
it — the refusal is logged and the rest of the catalogue still syncs, so one unrepresentable price
|
|
49
|
+
does not block a sync and does not reach the provider either.
|
|
50
|
+
|
|
51
|
+
(This was fixed 2026-09-08, #515. Before it, the amount was passed verbatim with `decimals` discarded,
|
|
52
|
+
so any price authored at a scale other than the currency's synced at the wrong magnitude. Notes older
|
|
53
|
+
than that describe the previous behaviour.)
|
|
54
|
+
|
|
55
|
+
## `grantedLimits` composes, and the mode decides how
|
|
56
|
+
|
|
57
|
+
A plan seeds its base limits from the declared grant values. For an add-on, `LimitGrantMode.ADD`
|
|
58
|
+
adds a finite grant to the current finite allowance. `LimitGrantMode.SET` composes using the feature's
|
|
59
|
+
`limitSemantic`: the larger value for FLOOR entitlements, the smaller for CEILING caps. It does not
|
|
60
|
+
blindly overwrite the plan's value. `FEATURES_UNLIMITED` wins for FLOOR and yields to a finite cap for
|
|
61
|
+
CEILING. Choose the semantic and grant mode for the intended entitlement or spending boundary; they
|
|
62
|
+
are separate decisions.
|
|
63
|
+
|
|
64
|
+
## Related
|
|
65
|
+
|
|
66
|
+
- `references/framework-subscription-behavior-policy.md` — how upgrades, downgrades, trials and
|
|
67
|
+
cancellations settle, and the two fields there that constrain nothing.
|
|
68
|
+
|
|
69
|
+
## Catalog Vocabularies
|
|
70
|
+
|
|
71
|
+
## Import Origins
|
|
72
|
+
|
|
73
|
+
- `@wildo-ai/saas-models`
|
|
74
|
+
|
|
75
|
+
## Source Excerpts
|
|
76
|
+
|
|
77
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
78
|
+
|
|
79
|
+
```typescript
|
|
80
|
+
*
|
|
81
|
+
* The vocabularies an application types into its own product catalogue — the `ProductDefinition[]`
|
|
82
|
+
* it exports from its shared library and hands to the engine with its module declarations.
|
|
83
|
+
*
|
|
84
|
+
* Imported from `@wildo-ai/saas-models`. `PricingModel`, `BillingInterval` and `ProrationBehavior`
|
|
85
|
+
* are re-exported from the connector models, because their values ARE the provider's wire values.
|
|
86
|
+
*
|
|
87
|
+
* The authored catalogue is the source of truth; provider-dashboard edits are not read back.
|
|
88
|
+
* A complete sync detects active local product keys absent from the array and deactivates those
|
|
89
|
+
* products and their active local prices, retaining the rows and reporting live subscribers.
|
|
90
|
+
* It does not archive provider products/prices or migrate/cancel subscribers. Treat provider
|
|
91
|
+
* retirement and customer migration as separate decisions, and inspect the complete sync result.
|
|
92
|
+
*
|
|
93
|
+
* Product types available in the billing catalog.
|
|
94
|
+
*
|
|
95
|
+
* | Type | Creates subscription? | Repeatable? | Grants features? | Usage tracked? |
|
|
96
|
+
* |-------------|----------------------|-------------|------------------|----------------|
|
|
97
|
+
* | PLAN | Yes (exclusive) | No (switch) | Yes | No |
|
|
98
|
+
* | ADDON | Yes (stackable) | No (toggle) | Yes | No |
|
|
99
|
+
* | METERED | Yes | No | Optional | Yes |
|
|
100
|
+
* | ONE_TIME | No | No (once) | Optional | No |
|
|
101
|
+
* | CREDIT_PACK | No | Yes | No (credits) | Credits-based |
|
|
102
|
+
* | ITEM | No | Yes | Optional | No |
|
|
103
|
+
*/
|
|
104
|
+
export enum ProductType {
|
|
105
|
+
/** Subscription plan, mutually exclusive per billing account */
|
|
106
|
+
PLAN = 'plan',
|
|
107
|
+
/** Optional subscription add-on, stackable on top of plan */
|
|
108
|
+
ADDON = 'addon',
|
|
109
|
+
/** Usage-based subscription (consumption reported to provider) */
|
|
110
|
+
METERED = 'metered',
|
|
111
|
+
/** Single purchase, once per billing account (e.g., setup fee, migration) */
|
|
112
|
+
ONE_TIME = 'one_time',
|
|
113
|
+
/** Buy a pack of credits/tokens (repeatable, consumable over time) */
|
|
114
|
+
CREDIT_PACK = 'credit_pack',
|
|
115
|
+
/** Purchasable item, repeatable (e.g., report generation, data export) */
|
|
116
|
+
ITEM = 'item',
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* Limit grant mode: how this product's limits compose with other products.
|
|
121
|
+
* - SET: absolute value (replaces, used for PLAN base limits)
|
|
122
|
+
* - ADD: additive (stacks on top, used for ADDON bonus limits)
|
|
123
|
+
*/
|
|
124
|
+
export enum LimitGrantMode {
|
|
125
|
+
SET = 'set',
|
|
126
|
+
ADD = 'add',
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
// ── Billing Lifecycle ──────────────────────────────────────────────
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* Proration behavior for plan changes (upgrade/downgrade).
|
|
133
|
+
*/
|
|
134
|
+
// ProrationBehavior: re-exported from @wildo-ai/external-connectors-models (see top of file).
|
|
135
|
+
// Moved there 2026-09-08 (#516) because its three values ARE the provider's wire values, so the
|
|
136
|
+
// request contract has to be able to name the type — see TaxDisplayMode for the same reasoning.
|
|
137
|
+
|
|
138
|
+
/**
|
|
139
|
+
* Billing timing: when to apply plan changes.
|
|
140
|
+
*/
|
|
141
|
+
export enum BillingTiming {
|
|
142
|
+
IMMEDIATE = 'immediate',
|
|
143
|
+
AT_PERIOD_END = 'at_period_end',
|
|
144
|
+
}
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## Complete synchronization result
|
|
148
|
+
|
|
149
|
+
The backend result contract below is extracted from the owning synchronization service. It describes
|
|
150
|
+
what that pass reports; a successful local retirement is not evidence of provider retirement or
|
|
151
|
+
subscriber migration.
|
|
152
|
+
|
|
153
|
+
## Import Origins
|
|
154
|
+
|
|
155
|
+
- `@wildo-ai/saas-backend-lib`
|
|
156
|
+
|
|
157
|
+
## Source Excerpts
|
|
158
|
+
|
|
159
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
160
|
+
|
|
161
|
+
```typescript
|
|
162
|
+
*
|
|
163
|
+
* Result of `ProductCatalogSyncBackendService.syncProductCatalog()`, exported from
|
|
164
|
+
* `@wildo-ai/saas-backend-lib`. Inspect errors even when the call returns normally: a complete
|
|
165
|
+
* pass reports individual failures alongside successful changes. `retired` records local
|
|
166
|
+
* deactivation, not provider archiving. `retiredWithLiveSubscribers` identifies customer decisions
|
|
167
|
+
* still owed; synchronization neither migrates nor cancels those subscriptions.
|
|
168
|
+
*/
|
|
169
|
+
export interface ProductCatalogSyncResult {
|
|
170
|
+
synced: number;
|
|
171
|
+
created: number;
|
|
172
|
+
updated: number;
|
|
173
|
+
featuresDirty: string[];
|
|
174
|
+
/**
|
|
175
|
+
* Keys that exist in the DATABASE and no longer in the code catalogue, and were soft-retired by
|
|
176
|
+
* this run (`isActive: false` on the product and every one of its prices).
|
|
177
|
+
*/
|
|
178
|
+
retired: string[];
|
|
179
|
+
/**
|
|
180
|
+
* Retired keys that STILL HAVE LIVE SUBSCRIBERS. Reported, never acted on — see
|
|
181
|
+
* {@link ProductCatalogSyncBackendService.reconcileRetiredProducts} for why the framework refuses
|
|
182
|
+
* to decide what happens to those customers.
|
|
183
|
+
*/
|
|
184
|
+
retiredWithLiveSubscribers: Array<{ productKey: string; liveSubscriptions: number }>;
|
|
185
|
+
errors: string[];
|
|
186
|
+
}
|
|
187
|
+
```
|
package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md
ADDED
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# Framework Subscription Behaviour Policy
|
|
2
|
+
|
|
3
|
+
`behaviorPolicy` on a product definition — trial, upgrade, downgrade, cancellation — plus
|
|
4
|
+
`billing.defaultBehaviorPolicy` in the backend config for the application-wide values.
|
|
5
|
+
|
|
6
|
+
Read it before declaring one, because two of its fields do not do what their names promise, and
|
|
7
|
+
money depends on the difference.
|
|
8
|
+
|
|
9
|
+
```ts
|
|
10
|
+
behaviorPolicy: {
|
|
11
|
+
trial: { days: 14, requirePaymentMethod: false },
|
|
12
|
+
upgrade: { proration: ProrationBehavior.CREATE_PRORATIONS, timing: BillingTiming.IMMEDIATE },
|
|
13
|
+
downgrade: { proration: ProrationBehavior.NONE, timing: BillingTiming.AT_PERIOD_END },
|
|
14
|
+
cancellation: { allowImmediate: false, defaultBehavior: BillingTiming.AT_PERIOD_END },
|
|
15
|
+
}
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## What IS honoured
|
|
19
|
+
|
|
20
|
+
| field | effect |
|
|
21
|
+
|---|---|
|
|
22
|
+
| `upgrade.proration` / `downgrade.proration` | passed to the provider as a request field. A downgrade declared `NONE` is not prorated |
|
|
23
|
+
| `cancellation.allowImmediate: false` | a **REFUSAL**. Effective immediate timing gets a `409`, whether requested explicitly or inherited from a default; it is never silently downgraded to period-end |
|
|
24
|
+
| `cancellation.defaultBehavior` | decides the timing when the caller expresses NO preference (`cancelImmediately` absent) |
|
|
25
|
+
| `trial.days` / `trial.requirePaymentMethod` | both reach the provider |
|
|
26
|
+
|
|
27
|
+
The cancellation policy is read from the subscription's **PLAN** product. An addon riding on a
|
|
28
|
+
subscription does not carry it. Resolve cancellation timing from the explicit caller preference,
|
|
29
|
+
then the plan default, then the application default, finally period-end. Validate that effective
|
|
30
|
+
timing against the plan's prohibition before calling the provider. An explicit period-end choice
|
|
31
|
+
is permitted even when a default is immediate. Do not author `defaultBehavior: IMMEDIATE` with
|
|
32
|
+
`allowImmediate: false` (including the default false): the product policy schema rejects that
|
|
33
|
+
contradiction. The runtime also protects previously stored or unparsed policies and application
|
|
34
|
+
fallbacks.
|
|
35
|
+
|
|
36
|
+
## ⚠️ What is NOT honoured
|
|
37
|
+
|
|
38
|
+
**`upgrade.timing` / `downgrade.timing` change nothing.** A provider's proration parameter says HOW a
|
|
39
|
+
change settles, not WHEN it applies. Deferring a change to the period end needs a subscription
|
|
40
|
+
schedule — a different call and a different mechanism the shipped adapter does not make. The timing
|
|
41
|
+
travels as metadata so a connector that grows one can read it, and it is inert today.
|
|
42
|
+
|
|
43
|
+
So a downgrade declared `AT_PERIOD_END` applies **immediately**, at the declared proration. If a
|
|
44
|
+
product must not change mid-period, that has to be built; declaring it here does not do it.
|
|
45
|
+
|
|
46
|
+
**`defaultCurrency` and `supportedCurrencies` constrain nothing.** No billing path reads either. The
|
|
47
|
+
currency that reaches the provider is the one on the price's own money value, so an application can
|
|
48
|
+
declare EUR and GBP, price its whole catalogue in USD, and no check will notice. They are read only
|
|
49
|
+
by the compliance drafting step, which turns them into a statement in the application's terms — which
|
|
50
|
+
makes a mismatch a statement that is wrong, not merely unenforced.
|
|
51
|
+
|
|
52
|
+
## Recently corrected — do not carry the old behaviour forward
|
|
53
|
+
|
|
54
|
+
Four of these were genuinely inert until 2026-09-08 and are not any more: proration was discarded at
|
|
55
|
+
the provider boundary (#516), the whole cancellation block was read by nothing (#408),
|
|
56
|
+
`requirePaymentMethod` was not passed, and a price's authored `decimals` scale was discarded so an
|
|
57
|
+
amount at any scale other than the currency's synced at the wrong magnitude (#515 — which now
|
|
58
|
+
REFUSES a price it cannot convert exactly rather than rounding it).
|
|
59
|
+
|
|
60
|
+
If you are reading older notes that say a declared proration is ignored, they describe the previous
|
|
61
|
+
behaviour.
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
### Checkout trial authority
|
|
65
|
+
|
|
66
|
+
Set trial duration on the product's `behaviorPolicy.trial.days`, or use the application's `defaultBehaviorPolicy.defaultTrialDays`. An explicit product value of zero disables the trial even if the application default is positive. Payers cannot choose a duration through `openCheckout` or the account's `OPEN_CHECKOUT` request; those options only select the purchase and permitted checkout inputs. The backend resolves trial duration before sending the provider request. Displaying trial days in a pricing table does not grant authority to change them.
|
|
67
|
+
|
|
68
|
+
## Removing an add-on
|
|
69
|
+
|
|
70
|
+
Use the subscription’s `REMOVE_ADDON` operation with its `addonProductKey`. The key must identify an ADDON, not a PLAN or another product type. Removal remains available for a retired product already attached to a subscription. The operation requires recorded provider subscription-item IDs for all matching entries, sends explicit deletions, and only then returns the remaining items for persistence. Missing provider IDs produce a conflict before mutation; repair the provider mapping explicitly rather than guessing from item positions; routine status reconciliation does not populate item IDs. The plan and unrelated add-ons remain untouched. Provider proration defaults apply when no proration setting is sent; removal is not scheduled by merely omitting the item from a payload.
|
|
71
|
+
|
|
72
|
+
### Keep existing subscription item identities
|
|
73
|
+
|
|
74
|
+
Plan changes preserve the known provider item ID. Changing a plan or adding an add-on requires every existing item to have its provider item ID recorded; otherwise the operation refuses before contacting the provider. This prevents an existing line from being mistaken for a new purchase.
|
|
75
|
+
|
|
76
|
+
A new line carries a backend-generated correlation key. The provider returns its created item ID under that key, and the operation records it immediately with the local line. Consecutive changes therefore keep targeting the same provider items without waiting for a webhook. Missing identities in older records still require an explicit repair; routine status reconciliation does not repair item identities. Neither price nor array position is used to guess an ID.
|