@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
|
@@ -47,10 +47,10 @@ roles / milestones the app ships.
|
|
|
47
47
|
| Feature identifiers + definitions | `shared-lib/src/engine/features.ts` |
|
|
48
48
|
| Milestone definitions | `shared-lib/src/engine/milestones.ts` |
|
|
49
49
|
| Role definitions | `shared-lib/src/engine/roles.ts` (when present) |
|
|
50
|
-
|
|
|
50
|
+
| Existing engine module contribution | `shared-lib/src/engine/index.ts` |
|
|
51
51
|
| Spec parity | `specifications/src/engine/features/**/*.feature.specification.ts` (and family equivalents) |
|
|
52
|
-
| Runtime consumer (backend) |
|
|
53
|
-
| Runtime consumer (frontend) |
|
|
52
|
+
| Runtime consumer (backend) | operation variants declaring `requiredFeatures` |
|
|
53
|
+
| Runtime consumer (frontend) | `FeatureGate`, `useFeatureGate` and `useFeatures` from `@wildo-ai/saas-frontend-lib` |
|
|
54
54
|
|
|
55
55
|
## When to Use
|
|
56
56
|
|
|
@@ -120,13 +120,7 @@ means the definition default ABSORBS every finite plan grant
|
|
|
120
120
|
no error, no failing test, just an unenforced limit. If the limit is
|
|
121
121
|
something the tenant CONSUMES, set `limitSemantic: CEILING`.
|
|
122
122
|
|
|
123
|
-
|
|
124
|
-
defineLimitFeature('MONTHLY_TOKEN_CAP', {
|
|
125
|
-
scope: ResourcePrimaryScope.ORGANIZATIONS,
|
|
126
|
-
default: FEATURES_UNLIMITED, // no cap until a plan grants one
|
|
127
|
-
limitSemantic: FeatureLimitSemantic.CEILING,
|
|
128
|
-
});
|
|
129
|
-
```
|
|
123
|
+
The compiled example in `references/connected-feature-workflow.md` also declares `BudgetFeature.MONTHLY_TOKEN_CAP` with organization scope, an unlimited default and `FeatureLimitSemantic.CEILING`. Use the same named-enum pattern for your own cap.
|
|
130
124
|
|
|
131
125
|
Note that a CEILING is enforced by whatever consumes it, not by the
|
|
132
126
|
feature gate's row-counting (a token/spend total is not a count of
|
|
@@ -140,8 +134,7 @@ profile or a manual limit override.
|
|
|
140
134
|
|
|
141
135
|
### Step 4: Update profiles / policy as needed
|
|
142
136
|
|
|
143
|
-
|
|
144
|
-
the relevant `FEATURE_PROFILES.<tier>.features[]` arrays. If the
|
|
137
|
+
When billing is disabled, put the feature in the selected profile if that profile should grant it. When billing is enabled, grant it through the product catalogue’s `grantedFeatures` / `grantedLimits`; profiles are not the paid-tier authority. If the
|
|
145
138
|
feature has a global posture default, update
|
|
146
139
|
`CUSTOM_UNAVAILABILITY_POLICY` accordingly.
|
|
147
140
|
|
|
@@ -159,6 +152,24 @@ surfaces don't see the new identifier. Use `spec-feature-update`
|
|
|
159
152
|
- (When applicable) profile entries reference the new identifier
|
|
160
153
|
- Spec exists for the identifier
|
|
161
154
|
- Companion exports list the spec
|
|
155
|
+
- Existing engine module contributes the definitions and configuration
|
|
156
|
+
- The selected profile or product grants the feature
|
|
157
|
+
- Protected backend operation variants declare `requiredFeatures`
|
|
158
|
+
- Frontend presentation uses the same identifier under the normal provider tree
|
|
159
|
+
|
|
160
|
+
## Three separate decisions
|
|
161
|
+
|
|
162
|
+
| Decision | Owner | What it does not do |
|
|
163
|
+
|---|---|---|
|
|
164
|
+
| Runtime activation | Application configuration and `EngineCapability` | Does not create or purchase an entitlement. |
|
|
165
|
+
| Tenant entitlement | Registered feature definition plus resolved profile, product grant or manual override | Does not start an engine capability or configure a customer integration. |
|
|
166
|
+
| Customer integration setup | Tenant configuration such as an identity provider or webhook destination | Does not itself grant the paid feature. |
|
|
167
|
+
|
|
168
|
+
`EngineCapability` is deliberately excluded from automatic feature registration. A capability can be deployed while a tenant lacks access; a tenant can be entitled while its integration remains unconfigured. Preserve all three checks where the product needs them.
|
|
169
|
+
|
|
170
|
+
## Connected example: a gated reporting surface
|
|
171
|
+
|
|
172
|
+
Read `references/connected-feature-workflow.md`. It carries two compiled fragments that connect one identifier to its registration, grant, backend operation requirement and frontend presentation using public package imports, followed by the steps that join them. Attach the backend requirement before exposing the interface; a hidden component is not authorization.
|
|
162
173
|
|
|
163
174
|
## Worked Example
|
|
164
175
|
|
|
@@ -184,6 +195,8 @@ export enum ApplicationFeature {
|
|
|
184
195
|
CUSTOM_WORKFLOWS = 'CUSTOM_WORKFLOWS',
|
|
185
196
|
}
|
|
186
197
|
|
|
198
|
+
|
|
199
|
+
|
|
187
200
|
// ══════════════════════════════════════════════════════════
|
|
188
201
|
// Feature Definitions
|
|
189
202
|
// ══════════════════════════════════════════════════════════
|
|
@@ -267,15 +280,25 @@ export const FEATURE_PROFILES: Record<string, ScopeFeatures> = {
|
|
|
267
280
|
|
|
268
281
|
/**
|
|
269
282
|
* Free tier — minimal features, tight limits.
|
|
270
|
-
* Default for new orgs when billing is
|
|
283
|
+
* Default for new orgs when billing is DISABLED.
|
|
271
284
|
*
|
|
272
|
-
*
|
|
285
|
+
* Granting the org-admin infrastructure CoreFeatures (SSO,
|
|
273
286
|
* SCIM/directory-provisioning, SIEM/security-event-export, M2M webhooks,
|
|
274
|
-
* audit logs)
|
|
275
|
-
*
|
|
276
|
-
*
|
|
277
|
-
*
|
|
278
|
-
*
|
|
287
|
+
* audit logs) from a default profile is how an app activates features
|
|
288
|
+
* globally WITHOUT billing.
|
|
289
|
+
*
|
|
290
|
+
* IN THIS APPLICATION THAT DOES NOT HAPPEN, and the profile below is inert.
|
|
291
|
+
* `saas-config.backend.ts` sets `billing.enabled: true`, and feature
|
|
292
|
+
* resolution returns before it layers any profile whenever billing is
|
|
293
|
+
* enabled: profiles and subscriptions are alternatives, never a merge. So
|
|
294
|
+
* these five reach an organization only through a subscription that grants
|
|
295
|
+
* them or through a manual per-scope override, and a new organization
|
|
296
|
+
* receives none of them.
|
|
297
|
+
*
|
|
298
|
+
* Keep it as the authored shape for the billing-disabled case, and read it
|
|
299
|
+
* that way: turning `billing.enabled` off is what makes these five global.
|
|
300
|
+
* The corresponding Settings Hub sections stay role-gated (ORG_ADMIN /
|
|
301
|
+
* ORG_OWNER) either way, so non-admins still do not see them.
|
|
279
302
|
*/
|
|
280
303
|
free: {
|
|
281
304
|
features: [
|
|
@@ -319,11 +342,7 @@ What earns its place:
|
|
|
319
342
|
The string values match the enum member names; never silently
|
|
320
343
|
rename one without renaming the other.
|
|
321
344
|
- `CUSTOM_FEATURE_DEFINITIONS: FeatureDefinitionWithAutoRegister[]`
|
|
322
|
-
— typed array, not a plain object map. The `WithAutoRegister`
|
|
323
|
-
suffix is the contract: the framework reads these definitions
|
|
324
|
-
at startup, merges with `CORE_FEATURE_DEFINITIONS`
|
|
325
|
-
(engine-default features + `EngineCapability` auto-generated
|
|
326
|
-
features), and registers them with the runtime guard layer.
|
|
345
|
+
— typed array, not a plain object map. The array must be contributed through the existing `SharedSaaSModule.customFeatureDefinitions` hook. Startup registers core entitlement definitions, then the custom definitions. The array name alone does not register anything. `WithAutoRegister` carries optional limit-check metadata from `countResource`; it does not discover files or convert `EngineCapability` values into entitlements.
|
|
327
346
|
- `defineFeature(ApplicationFeature.AI_ASSISTANT, { scope:
|
|
328
347
|
ResourcePrimaryScope.ORGANIZATIONS, unavailability: { behavior:
|
|
329
348
|
FeatureUnavailabilityBehavior.ADDON_PROMPT, suggestedProductRef:
|
|
@@ -342,8 +361,7 @@ What earns its place:
|
|
|
342
361
|
/ `starter` / `pro` / `enterprise` tiers — each tier lists
|
|
343
362
|
the **enum members** (typed reference, not strings) it unlocks.
|
|
344
363
|
The `DEFAULT_FEATURE_PROFILE = 'free'` constant declares which
|
|
345
|
-
profile is
|
|
346
|
-
disabled.
|
|
364
|
+
profile is layered during feature resolution when billing is disabled; it is not a one-time grant written at organization creation.
|
|
347
365
|
- `CUSTOM_UNAVAILABILITY_POLICY` carries the **global fallback
|
|
348
366
|
surface**: `defaultBehavior` (when no per-feature override),
|
|
349
367
|
`whenBillingDisabled` (typically `HIDE`), `roleDefaults`
|
|
@@ -366,11 +384,16 @@ What is **not** in this block (and shouldn't be):
|
|
|
366
384
|
|
|
367
385
|
## References
|
|
368
386
|
|
|
387
|
+
- `references/connected-feature-workflow.md` — registration, granting, backend enforcement and frontend consumption of one feature, with both compiled fragments inlined
|
|
388
|
+
|
|
389
|
+
- `references/framework-feature-builders-api.md` — source-backed `defineFeature` / `defineLimitFeature`, plus the reserved `rateLimit`, why `checkLimit` refuses without counting, and why granting is not configuring
|
|
369
390
|
- `references/product-registry-scope.md` — what lives in code vs specs
|
|
370
391
|
- `references/framework-engine-product-definitions-api.md` — `SharedSaaSModule` hooks + definition spec record types
|
|
371
392
|
- `spec-feature-update/SKILL.md` — feature spec authoring (the spec counterpart)
|
|
372
393
|
- `spec-family-update/SKILL.md` — product / role / milestone family spec authoring
|
|
373
394
|
|
|
395
|
+
For a metered product, read `references/framework-metered-usage-recording-api.md` and connect its consumption to the resource operation. A product declaration alone does not write usage.
|
|
396
|
+
|
|
374
397
|
## Verification
|
|
375
398
|
|
|
376
399
|
- [ ] Every new identifier is added to the typed enum (`ApplicationFeature` / family equivalent)
|
|
@@ -378,7 +401,9 @@ What is **not** in this block (and shouldn't be):
|
|
|
378
401
|
- [ ] `scope` uses `ResourcePrimaryScope.*` (typed enum)
|
|
379
402
|
- [ ] `unavailability.behavior` (when present) uses `FeatureUnavailabilityBehavior.*` (typed enum)
|
|
380
403
|
- [ ] `byRole` keys use `CORE_ORG_ROLES.*` (typed enum), not string literals
|
|
381
|
-
- [ ]
|
|
404
|
+
- [ ] Existing `SharedSaaSModule` contributes the definitions and feature configuration
|
|
405
|
+
- [ ] Selected profile grants the feature when billing is disabled; intended product grants it when billing is enabled
|
|
406
|
+
- [ ] Every protected backend operation variant declares `requiredFeatures`; frontend presentation uses the same identifier
|
|
382
407
|
- [ ] `CUSTOM_UNAVAILABILITY_POLICY` updated if the new feature changes the global posture
|
|
383
408
|
- [ ] Matching spec file exists (`spec-feature-update` / `spec-family-update`)
|
|
384
409
|
- [ ] Spec is wired into companion exports (`spec-companion-exports`)
|
|
@@ -398,9 +423,7 @@ Run from the app root, substituting `<MEMBER>`:
|
|
|
398
423
|
| Profile entries reference enum members | `rg -n "ApplicationFeature\.<MEMBER>" shared-lib/src/engine/features.ts` |
|
|
399
424
|
| Spec exists for new identifier | `rg -n "<MEMBER>" specifications/src/engine/features/` |
|
|
400
425
|
|
|
401
|
-
|
|
402
|
-
definition, and spec"** — drift in any one of the three breaks
|
|
403
|
-
guards / addon prompts / companion lookup.
|
|
426
|
+
Verify identifier → definition → module registration → grant → backend enforcement → frontend presentation → specification. A declared or documented feature alone neither grants access nor protects an operation.
|
|
404
427
|
|
|
405
428
|
## Common Rationalizations
|
|
406
429
|
|
|
@@ -409,7 +432,7 @@ guards / addon prompts / companion lookup.
|
|
|
409
432
|
| "Code-only feature flag, no spec needed" | Companion / AI surfaces lose the feature entirely; addon prompts can render but with no narrative. |
|
|
410
433
|
| "Inline string identifier is fine — TypeScript will catch typos" | TypeScript only catches typos when the consumer uses the typed enum reference. String literals in definitions are not cross-checked. |
|
|
411
434
|
| "Skip `unavailability` — addon framing is just copy" | `unavailability.behavior` drives the runtime to render the addon prompt vs the upgrade prompt; missing it defaults to silent fallthrough. |
|
|
412
|
-
| "Profiles
|
|
435
|
+
| "Profiles define the paid tiers" | Profiles apply when billing is disabled. Billing grants, definition defaults, broader scopes and manual overrides are distinct resolution inputs. |
|
|
413
436
|
| "I can rename a feature in one place" | Renaming the enum member without renaming the spec, profile entries, and consumer references silently breaks gating in production. |
|
|
414
437
|
|
|
415
438
|
## Red Flags
|
package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md
ADDED
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
# One feature from declaration to protected operation
|
|
2
|
+
|
|
3
|
+
The two fragments below are compiled against the live framework contracts, so they cannot drift from
|
|
4
|
+
them. Read them together: they are additions to an EXISTING application, not a second bootstrap and
|
|
5
|
+
not a complete reporting implementation.
|
|
6
|
+
|
|
7
|
+
## The declaration half
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
## Usage Example
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
// One feature identifier, followed from declaration to enforcement.
|
|
14
|
+
//
|
|
15
|
+
// In an application every symbol below comes from the package root:
|
|
16
|
+
//
|
|
17
|
+
// import {
|
|
18
|
+
// defineFeature, defineLimitFeature, FEATURES_UNLIMITED, FeatureLimitSemantic,
|
|
19
|
+
// FeatureUnavailabilityBehavior, ResourcePrimaryScope,
|
|
20
|
+
// type FeatureDefinitionWithAutoRegister, type ProductDefinition,
|
|
21
|
+
// type RequiredFeaturesConfig, type SharedSaaSModule,
|
|
22
|
+
// } from '@wildo-ai/saas-models';
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* The identifier is a NAMED ENUM MEMBER rather than a bare string, so the one place that explains
|
|
26
|
+
* what the feature means travels with every use of it.
|
|
27
|
+
*/
|
|
28
|
+
export enum ApplicationFeature {
|
|
29
|
+
/** Access the application's advanced reporting operation and interface. */
|
|
30
|
+
ADVANCED_REPORTS = 'ADVANCED_REPORTS',
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export const CUSTOM_FEATURE_DEFINITIONS: FeatureDefinitionWithAutoRegister[] = [
|
|
34
|
+
defineFeature(ApplicationFeature.ADVANCED_REPORTS, {
|
|
35
|
+
scope: ResourcePrimaryScope.ORGANIZATIONS,
|
|
36
|
+
defaultEnabled: false,
|
|
37
|
+
unavailability: { behavior: FeatureUnavailabilityBehavior.UPGRADE_PROMPT },
|
|
38
|
+
}),
|
|
39
|
+
];
|
|
40
|
+
|
|
41
|
+
// Merge these hooks into the EXISTING engine contribution; do not register a second engine module.
|
|
42
|
+
export const reportingContribution = {
|
|
43
|
+
customFeatureDefinitions: CUSTOM_FEATURE_DEFINITIONS,
|
|
44
|
+
customFeatureConfiguration: {
|
|
45
|
+
profiles: { preview: { features: [ApplicationFeature.ADVANCED_REPORTS], limits: {} } },
|
|
46
|
+
defaultProfile: 'preview',
|
|
47
|
+
},
|
|
48
|
+
} satisfies Pick<SharedSaaSModule, 'customFeatureDefinitions' | 'customFeatureConfiguration'>;
|
|
49
|
+
|
|
50
|
+
// When billing is enabled, apply this fragment to the intended existing plan or add-on.
|
|
51
|
+
export const reportingProductGrant = {
|
|
52
|
+
grantedFeatures: [ApplicationFeature.ADVANCED_REPORTS],
|
|
53
|
+
} satisfies Pick<ProductDefinition, 'grantedFeatures'>;
|
|
54
|
+
|
|
55
|
+
// Use this as requiredFeatures on EVERY externally reachable reporting operation variant.
|
|
56
|
+
export const reportingRequirement: RequiredFeaturesConfig = {
|
|
57
|
+
features: [ApplicationFeature.ADVANCED_REPORTS],
|
|
58
|
+
};
|
|
59
|
+
export const reportingOperationGate = { requiredFeatures: reportingRequirement };
|
|
60
|
+
|
|
61
|
+
export enum BudgetFeature {
|
|
62
|
+
/** Upper bound measured by a token-consumption service, not a repository row count. */
|
|
63
|
+
MONTHLY_TOKEN_CAP = 'MONTHLY_TOKEN_CAP',
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
// Contribute this definition alongside your other definitions only when a consumer enforces it.
|
|
67
|
+
export const tokenCapDefinition = defineLimitFeature(BudgetFeature.MONTHLY_TOKEN_CAP, {
|
|
68
|
+
scope: ResourcePrimaryScope.ORGANIZATIONS,
|
|
69
|
+
default: FEATURES_UNLIMITED,
|
|
70
|
+
limitSemantic: FeatureLimitSemantic.CEILING,
|
|
71
|
+
});
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
## The interface half
|
|
75
|
+
|
|
76
|
+
|
|
77
|
+
## Usage Example
|
|
78
|
+
|
|
79
|
+
```tsx
|
|
80
|
+
// Consuming the SAME identifier the feature was declared under.
|
|
81
|
+
//
|
|
82
|
+
// In an application both imports come from package roots:
|
|
83
|
+
//
|
|
84
|
+
// import { FeatureGate, useFeatureGate } from '@wildo-ai/saas-frontend-lib';
|
|
85
|
+
// import { ApplicationFeature } from '@your-app/shared-lib';
|
|
86
|
+
//
|
|
87
|
+
// `ApplicationFeature` is the enum declared on the models side — one identifier, not a second
|
|
88
|
+
// string typed at the point of use. Render inside the normal Wildo provider tree, which supplies
|
|
89
|
+
// the features, user/organization and billing contexts these read from.
|
|
90
|
+
//
|
|
91
|
+
// A hidden component is NOT authorization. Both forms below decide what a person SEES; the
|
|
92
|
+
// operation still needs its own `requiredFeatures` declaration, or the capability is reachable
|
|
93
|
+
// by anyone who calls the API directly.
|
|
94
|
+
|
|
95
|
+
enum ApplicationFeature {
|
|
96
|
+
ADVANCED_REPORTS = 'ADVANCED_REPORTS',
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
/**
|
|
100
|
+
* The ordinary form: when the feature is unavailable, `FeatureGate` renders the policy-driven
|
|
101
|
+
* prompt configured by the feature's `unavailability` behavior instead of the children.
|
|
102
|
+
*/
|
|
103
|
+
export function ReportsSurface({ children }: { children: ReactNode }) {
|
|
104
|
+
return <FeatureGate featureId={ApplicationFeature.ADVANCED_REPORTS}>{children}</FeatureGate>;
|
|
105
|
+
}
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* For a custom layout, consume the same availability result directly. The application supplies
|
|
109
|
+
* translated content and its normal design-system controls through these slots.
|
|
110
|
+
*/
|
|
111
|
+
export function ReportsAvailability({ available, unavailable }: { available: ReactNode; unavailable: ReactNode }) {
|
|
112
|
+
const availability = useFeatureGate(ApplicationFeature.ADVANCED_REPORTS);
|
|
113
|
+
return <>{availability.isAvailable ? available : unavailable}</>;
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Connecting them
|
|
118
|
+
|
|
119
|
+
1. Put the enum and definition in the application's existing feature module and export them through its declared shared-lib package root. `defineFeature` and its types come from `@wildo-ai/saas-models`.
|
|
120
|
+
2. Merge `reportingContribution` into the existing engine `SharedSaaSModule`. Preserve its other feature definitions, profiles, resources and products. The application’s shared registry must include that module; a constant named `CUSTOM_FEATURE_DEFINITIONS` has no discovery magic. Startup explicitly registers core entitlements, then the contributed custom definitions and configuration. `countResource` on a limit builder is the separate mechanism that can add CREATE limit checks automatically.
|
|
121
|
+
3. With billing disabled, the selected `preview` profile grants the reporting feature during resolution. With billing enabled, profiles are skipped: add `reportingProductGrant.grantedFeatures` to the existing intended product and use the ordinary catalogue/subscription lifecycle. Preserve the product’s other grants, prices and scope. A definition with `defaultEnabled: false` does not grant itself.
|
|
122
|
+
4. In the resource factory, set `requiredFeatures: reportingRequirement` on the reporting API operation variant, preserving its existing input/output, roles, scope and implementation. Apply it to every externally reachable variant that performs the protected work. The operation gate resolves entitlements and refuses a missing boolean before execution. A custom route bypassing that pipeline must await `FeatureGateBackendService.checkRequiredFeatures` from `@wildo-ai/saas-backend-lib` with the original externally initiated, authenticated execution context before performing the work. Do not relabel it as `PUBLIC_EXECUTION` or `INTERNALLY_INITIATED_REQUEST`: the gate intentionally bypasses feature checks for those execution types. Feature requirements supplement ordinary access control; they do not replace it.
|
|
123
|
+
5. Render `ReportsSurface` around the actual report UI. `FeatureGate` takes `featureId` and `children`, and optionally `renderUnavailable(availability)`. `HIDE` policy takes precedence over a custom unavailable renderer. `useFeatureGate(featureId)` returns the availability object, including `isAvailable`, behavior and upgrade information; it is not a boolean hook. `useFeatures()` exposes the broader context and requires `FeaturesProvider`.
|
|
124
|
+
6. Verify a tenant without the grant cannot invoke the backend operation directly, and the interface follows its configured unavailable policy. Grant the feature and verify both the operation and presentation. The frontend availability hook is optimistic while loading, so presentation is never the access boundary. Keep role/scope refusal controls even for an entitled tenant.
|
|
125
|
+
|
|
126
|
+
The example passes translated React content in slots rather than inventing application labels. Place it inside the normal application provider tree, not a standalone React root missing the user/org, feature and billing contexts. The two fragments declare the identifier separately because they come from separate framework packages; in an application there is ONE enum, declared once and imported by both sides from the application’s public shared-lib package entrypoint.
|
|
127
|
+
|
|
128
|
+
For numeric limits, use `defineLimitFeature` and `requiredFeatures.limitChecks` with an appropriate counting configuration (or the builder’s `countResource` shortcut for CREATE). A boolean `FeatureGate` is not a replacement for backend consumption accounting. See the builders reference for FLOOR versus CEILING, unsupported rate-limit metadata and failed-read behavior.
|
|
129
|
+
|
|
130
|
+
Runtime activation, tenant grants and tenant integration configuration remain separate. For example, a deployed SSO capability, the organization's SSO entitlement and its configured identity provider must not be represented as one interchangeable flag.
|
|
@@ -26,6 +26,18 @@ export interface SharedSaaSModule extends SharedDomainModule {
|
|
|
26
26
|
defaultProfile?: string;
|
|
27
27
|
unavailabilityPolicy?: Partial<FeatureConfiguration['unavailabilityPolicy']>;
|
|
28
28
|
};
|
|
29
|
+
/**
|
|
30
|
+
* Progression milestones this module owns.
|
|
31
|
+
*
|
|
32
|
+
* ⚠️ **Milestones need the ANALYTICS capability enabled to appear at all.** The frontend fetches
|
|
33
|
+
* milestone definitions only when analytics is on and returns an empty list otherwise, so with it
|
|
34
|
+
* off the definitions never arrive and the progression tracker renders nothing — declared
|
|
35
|
+
* correctly, and invisible.
|
|
36
|
+
*
|
|
37
|
+
* Enabling analytics with an EMPTY provider list is what lights up the internal progression plane
|
|
38
|
+
* without any telemetry leaving the application. That is the configuration to reach for when an
|
|
39
|
+
* application wants progression and not tracking.
|
|
40
|
+
*/
|
|
29
41
|
customMilestoneDefinitions?: MilestoneDefinition[];
|
|
30
42
|
productDefinitions?: ProductDefinition[];
|
|
31
43
|
/**
|
|
@@ -34,6 +46,19 @@ export interface SharedSaaSModule extends SharedDomainModule {
|
|
|
34
46
|
* an "incomplete todos" count). Aggregated across modules by
|
|
35
47
|
* `buildSharedSaaSModulesRegistry` and threaded into the app init config, so a
|
|
36
48
|
* module owns its badge concern end-to-end with no app-level wiring.
|
|
49
|
+
*
|
|
50
|
+
* The framework ships NO badges of its own — every badge in an application is one that application
|
|
51
|
+
* declared.
|
|
52
|
+
*
|
|
53
|
+
* Two limits worth knowing before designing around one. A badge is scoped to a USER or to an
|
|
54
|
+
* ORGANIZATION and to nothing else; there is no application-wide scope. And a DERIVED badge is
|
|
55
|
+
* recomputed off the resource operation's own dispatch, so a change written by some other route
|
|
56
|
+
* does not move it — a client sees the corrected count on its next connection rather than
|
|
57
|
+
* immediately.
|
|
58
|
+
*
|
|
59
|
+
* A badge reference that does not resolve renders nothing, deliberately. The configuration
|
|
60
|
+
* verifier is what makes that loud: an unresolvable badge reference on a launcher item is reported
|
|
61
|
+
* when the application's navigation content is checked.
|
|
37
62
|
*/
|
|
38
63
|
notificationBadgeDefinitions?: NotificationBadgeDefinition[];
|
|
39
64
|
}
|
|
@@ -0,0 +1,215 @@
|
|
|
1
|
+
# Framework Feature Builders API
|
|
2
|
+
|
|
3
|
+
The source contract for `defineFeature` and `defineLimitFeature` — the parameter surface behind the
|
|
4
|
+
guidance in this skill's SKILL.md.
|
|
5
|
+
|
|
6
|
+
Read it for the exact options, and for three facts that decide whether a gate you declared actually
|
|
7
|
+
fires.
|
|
8
|
+
|
|
9
|
+
## `rateLimit` on a definition is RESERVED
|
|
10
|
+
|
|
11
|
+
The field exists for schema stability and **the gate ignores it**. A time-windowed allowance — "one
|
|
12
|
+
hundred calls an hour" — is not expressible as a feature at all. Abuse throttling is a separate
|
|
13
|
+
mechanism with its own declaration; do not model a rate as a limit feature and expect enforcement.
|
|
14
|
+
|
|
15
|
+
## A limit with no counting configuration cannot be checked automatically
|
|
16
|
+
|
|
17
|
+
`checkLimit` **refuses** rather than guessing at a remaining quota. That is deliberate: the caller
|
|
18
|
+
must either pass a counting override or measure consumption itself.
|
|
19
|
+
|
|
20
|
+
It is the right answer whenever the quantity is not a row count — a sum of tokens, a total of bytes —
|
|
21
|
+
and `countResource` is the one-call form for when it IS: it registers the limit check on that
|
|
22
|
+
resource's CREATE automatically, so "at most ten projects per organisation" is one declaration rather
|
|
23
|
+
than a definition plus a hand-written gate.
|
|
24
|
+
|
|
25
|
+
## `scopeBoundary` — when a broader grant must NOT imply the narrower one
|
|
26
|
+
|
|
27
|
+
By default a feature enabled at the APPLICATION layer cascades to every organisation and user
|
|
28
|
+
request: the resolver merges features across every scope in the chain. That is right for a
|
|
29
|
+
capability-style gate — "audit logs available app-wide".
|
|
30
|
+
|
|
31
|
+
It is wrong for an opt-in policy that must stay per-organisation even when the parent scope has the
|
|
32
|
+
same flag on. Mark those `scopeBoundary: true`, and the feature is on only when the EXACT scope it is
|
|
33
|
+
queried against has it enabled.
|
|
34
|
+
|
|
35
|
+
⚠️ **A scope-bound feature must be gated with the per-scope check.** `isFeatureEnabledAtScope(featureId,
|
|
36
|
+
scopeType, entityId)` is the one to call; the unscoped `isFeatureEnabled(featureId, ec)` **throws**
|
|
37
|
+
for these features rather than answering. That is deliberate — chain-union semantics would silently
|
|
38
|
+
defeat the per-scope opt-in, which is the entire reason the feature was marked scope-bound — but it
|
|
39
|
+
means mixing the two checks is a runtime failure, not a wrong answer.
|
|
40
|
+
|
|
41
|
+
## Granting a capability does not configure it
|
|
42
|
+
|
|
43
|
+
An entitlement says the tenant MAY have the thing. Single sign-on entitles an organisation to
|
|
44
|
+
register an identity provider; somebody still has to register one. The same holds for provisioning
|
|
45
|
+
tokens, export destinations and webhook endpoints — a plan that grants one of these still needs an
|
|
46
|
+
onboarding step behind it, or the customer buys a capability and sees nothing.
|
|
47
|
+
|
|
48
|
+
## Feature Builders
|
|
49
|
+
|
|
50
|
+
## Import Origins
|
|
51
|
+
|
|
52
|
+
- `@wildo-ai/saas-models`
|
|
53
|
+
|
|
54
|
+
## Source Excerpts
|
|
55
|
+
|
|
56
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
57
|
+
|
|
58
|
+
```typescript
|
|
59
|
+
*
|
|
60
|
+
* Declaring what an application can SELL or gate on. Two builders, from `@wildo-ai/saas-models`:
|
|
61
|
+
* `defineFeature` for a boolean capability, `defineLimitFeature` for a numeric allowance.
|
|
62
|
+
*
|
|
63
|
+
* A product in the billing catalogue then grants them through `grantedFeatures` / `grantedLimits`,
|
|
64
|
+
* and any surface gates on the identifier with `requiredFeatures` — a resource operation, a view, a
|
|
65
|
+
* chart, a navigation item, a settings section.
|
|
66
|
+
*
|
|
67
|
+
* ## Two things that decide whether the gate actually fires
|
|
68
|
+
*
|
|
69
|
+
* (`limitSemantic` is the third and is covered by the product-definitions skill's own guidance —
|
|
70
|
+
* the default `FLOOR` is an entitlement the tenant is ALLOWED, and a consumption CAP needs `CEILING`.)
|
|
71
|
+
*
|
|
72
|
+
* - **`countResource` is the one-call form.** It registers a limit check on that resource's CREATE
|
|
73
|
+
* automatically, so "at most ten projects per organisation" is one declaration rather than a
|
|
74
|
+
* definition plus a hand-written gate. A limit declared WITHOUT counting cannot be checked
|
|
75
|
+
* automatically: `checkLimit` REFUSES rather than guessing at a remaining quota, and the caller
|
|
76
|
+
* must pass a counting override or measure consumption itself. That is the right answer for a
|
|
77
|
+
* quantity that is not a row count — a sum of tokens, for instance.
|
|
78
|
+
* - **`rateLimit` on a definition is RESERVED and ignored by the gate.** A time-windowed allowance
|
|
79
|
+
* like "one hundred calls an hour" is not expressible here at all; abuse throttling is a separate
|
|
80
|
+
* mechanism with its own declaration.
|
|
81
|
+
*
|
|
82
|
+
* ## Granting a capability does not configure it
|
|
83
|
+
*
|
|
84
|
+
* An entitlement says the tenant MAY have the thing. Single sign-on entitles an organisation to
|
|
85
|
+
* register an identity provider; somebody still has to register one. The same holds for provisioning
|
|
86
|
+
* tokens, export destinations and webhook endpoints — so a plan that grants one of these still needs
|
|
87
|
+
* an onboarding step behind it.
|
|
88
|
+
*
|
|
89
|
+
* Simple boolean feature builder.
|
|
90
|
+
*
|
|
91
|
+
* @example
|
|
92
|
+
* defineFeature('AI_ASSISTANT', { scope: ResourcePrimaryScope.ORGANIZATIONS })
|
|
93
|
+
*
|
|
94
|
+
* @example
|
|
95
|
+
* defineFeature('PREMIUM_THEMES', {
|
|
96
|
+
* scope: ResourcePrimaryScope.USER_SELF,
|
|
97
|
+
* unavailability: {
|
|
98
|
+
* behavior: FeatureUnavailabilityBehavior.UPGRADE_PROMPT,
|
|
99
|
+
* },
|
|
100
|
+
* })
|
|
101
|
+
*/
|
|
102
|
+
export function defineFeature(
|
|
103
|
+
identifier: string,
|
|
104
|
+
options: {
|
|
105
|
+
scope: ResourcePrimaryScope | ResourcePrimaryScope[];
|
|
106
|
+
defaultEnabled?: boolean;
|
|
107
|
+
dependencies?: string[];
|
|
108
|
+
unavailability?: FeatureUnavailabilityOverride;
|
|
109
|
+
}
|
|
110
|
+
): FeatureDefinition {
|
|
111
|
+
return {
|
|
112
|
+
identifier,
|
|
113
|
+
valueType: FeatureValueType.BOOLEAN,
|
|
114
|
+
applicableScopes: normalizeScopes(options.scope),
|
|
115
|
+
defaultValue: options.defaultEnabled ?? false,
|
|
116
|
+
dependencies: options.dependencies ?? [],
|
|
117
|
+
unavailability: options.unavailability,
|
|
118
|
+
};
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
// =====================================================
|
|
122
|
+
// defineLimitFeature() — Limit Feature Builder
|
|
123
|
+
// =====================================================
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* Limit feature builder with auto-wiring support.
|
|
127
|
+
*
|
|
128
|
+
* Key DX improvement: when `countResource` is provided, the engine
|
|
129
|
+
* auto-registers a `limitChecks` entry on the CREATE operation of the
|
|
130
|
+
* referenced resource at startup (via FeatureDefinitionRegistryBackendService).
|
|
131
|
+
*
|
|
132
|
+
* This means: to add "max 10 projects per org", write ONE call and the
|
|
133
|
+
* gate is automatically enforced. No need to manually add limitChecks on
|
|
134
|
+
* the resource's operation variant.
|
|
135
|
+
*
|
|
136
|
+
* @example
|
|
137
|
+
* defineLimitFeature('MAX_PROJECTS', {
|
|
138
|
+
* scope: ResourcePrimaryScope.ORGANIZATIONS,
|
|
139
|
+
* default: 5,
|
|
140
|
+
* countResource: CustomShared_ResourceType.PROJECTS,
|
|
141
|
+
* })
|
|
142
|
+
* // Equivalent to manually defining:
|
|
143
|
+
* // { identifier: 'MAX_PROJECTS', valueType: LIMIT, applicableScopes: [ORGANIZATIONS],
|
|
144
|
+
* // defaultValue: 5, counting: { resourceType: 'PROJECTS' } }
|
|
145
|
+
* // + adding limitChecks: [{ featureId: 'MAX_PROJECTS' }] on PROJECTS.CREATE variant
|
|
146
|
+
*
|
|
147
|
+
* @example
|
|
148
|
+
* defineLimitFeature('MAX_STORAGE_GB', {
|
|
149
|
+
* scope: ResourcePrimaryScope.ORGANIZATIONS,
|
|
150
|
+
* default: 10,
|
|
151
|
+
* counting: {
|
|
152
|
+
* resourceType: 'FILES',
|
|
153
|
+
* aggregate: { field: 'sizeBytes', operation: AggregationOperation.SUM },
|
|
154
|
+
* },
|
|
155
|
+
* })
|
|
156
|
+
*/
|
|
157
|
+
export function defineLimitFeature(
|
|
158
|
+
identifier: string,
|
|
159
|
+
options: {
|
|
160
|
+
scope: ResourcePrimaryScope | ResourcePrimaryScope[];
|
|
161
|
+
default: number;
|
|
162
|
+
/**
|
|
163
|
+
* How this limit COMPOSES when several sources supply a value (see {@link FeatureLimitSemantic}).
|
|
164
|
+
* Omit for the default `FLOOR` — an entitlement the tenant is ALLOWED, where most-permissive
|
|
165
|
+
* wins and add-ons stack upward (`MAX_MEMBERS`, `MAX_API_KEYS`).
|
|
166
|
+
*
|
|
167
|
+
* Pass `CEILING` for a consumption CAP the tenant may not exceed: most-RESTRICTIVE wins, and
|
|
168
|
+
* `FEATURES_UNLIMITED` means "no ceiling" so it yields to any finite grant. Without it a cap is
|
|
169
|
+
* inexpressible — under FLOOR an unlimited default absorbs every finite plan grant, so the cap
|
|
170
|
+
* silently never engages.
|
|
171
|
+
*/
|
|
172
|
+
limitSemantic?: FeatureLimitSemantic;
|
|
173
|
+
/** Resource to count. Auto-registers a limitCheck on CREATE for this resource. */
|
|
174
|
+
countResource?: string;
|
|
175
|
+
/** Advanced: filter + aggregation for counting (overrides simple resource count) */
|
|
176
|
+
counting?: LimitCountingConfig;
|
|
177
|
+
/** If true, skip auto-registration of limitChecks on the resource's CREATE operation */
|
|
178
|
+
skipAutoRegister?: boolean;
|
|
179
|
+
dependencies?: string[];
|
|
180
|
+
unavailability?: FeatureUnavailabilityOverride;
|
|
181
|
+
}
|
|
182
|
+
): FeatureDefinitionWithAutoRegister {
|
|
183
|
+
// Build counting config: explicit counting takes precedence, then countResource, then nothing
|
|
184
|
+
const counting: LimitCountingConfig | undefined =
|
|
185
|
+
options.counting ??
|
|
186
|
+
(options.countResource ? { resourceType: options.countResource } : undefined);
|
|
187
|
+
|
|
188
|
+
const definition: FeatureDefinitionWithAutoRegister = {
|
|
189
|
+
identifier,
|
|
190
|
+
valueType: FeatureValueType.LIMIT,
|
|
191
|
+
applicableScopes: normalizeScopes(options.scope),
|
|
192
|
+
defaultValue: options.default,
|
|
193
|
+
dependencies: options.dependencies ?? [],
|
|
194
|
+
// Omitted ⇒ absent on the definition ⇒ read as FLOOR, so every existing caller is unchanged.
|
|
195
|
+
...(options.limitSemantic ? { limitSemantic: options.limitSemantic } : {}),
|
|
196
|
+
counting,
|
|
197
|
+
unavailability: options.unavailability,
|
|
198
|
+
};
|
|
199
|
+
|
|
200
|
+
// Add auto-register marker for limit features with countResource (unless skipped)
|
|
201
|
+
if (options.countResource && !options.skipAutoRegister) {
|
|
202
|
+
definition[AUTO_REGISTER_LIMIT_CHECK] = {
|
|
203
|
+
countResource: options.countResource,
|
|
204
|
+
};
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
return definition;
|
|
208
|
+
}
|
|
209
|
+
```
|
|
210
|
+
|
|
211
|
+
### Distinguish an absent entitlement record from a read failure
|
|
212
|
+
|
|
213
|
+
A successfully read, absent scope record uses the normal definition/profile defaults. A failed entitlement read does not: resolution fails, the protected action cannot obtain a successful entitlement decision, and no default grant is cached for the failed scope. This prevents a finite purchased ceiling from becoming unlimited during an outage, or a paid feature from being cached as unavailable.
|
|
214
|
+
|
|
215
|
+
A valid warm cache continues to serve its known result within the normal cache lifetime. After a cache-miss read recovers, the next resolution reads the ledger again. Broader-scope grants and limits still participate in normal composition; they do not turn a failed narrower-scope read into a successful decision.
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
# Connect a metered product to the operation that consumes it
|
|
2
|
+
|
|
3
|
+
A metered product and price do not themselves record usage. Declare `recordsUsage`
|
|
4
|
+
on the resource operation that consumes that product. Read the extracted contract
|
|
5
|
+
below before choosing fixed units or a quantity from the operation result; use one
|
|
6
|
+
quantity source, and keep the product key aligned with the registered metered offer.
|
|
7
|
+
|
|
8
|
+
Metering records consumption; it does not replace the operation's access or limit
|
|
9
|
+
checks. Verify the resulting usage row for the intended billing account rather than
|
|
10
|
+
inferring recording from a successful operation alone.
|
|
11
|
+
|
|
12
|
+
## Import Origins
|
|
13
|
+
|
|
14
|
+
- `@wildo-ai/saas-models`
|
|
15
|
+
|
|
16
|
+
## Source Excerpts
|
|
17
|
+
|
|
18
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
19
|
+
|
|
20
|
+
```typescript
|
|
21
|
+
*
|
|
22
|
+
* Declares that a successful operation CONSUMES a metered product, so the engine records usage
|
|
23
|
+
* against the caller's billing account (#415).
|
|
24
|
+
*
|
|
25
|
+
* Before this existed, `UsageMeteringBackendService.recordUsage` had no caller anywhere: a product
|
|
26
|
+
* could be declared METERED, priced and synced to the billing provider, and nothing in the framework
|
|
27
|
+
* ever wrote a usage row. An application could only meter by reaching into a backend service by hand
|
|
28
|
+
* from a custom implementation, which is not an authoring surface — it is a workaround.
|
|
29
|
+
*
|
|
30
|
+
* Declared per OPERATION, beside `userNotifications` and `m2mNotifications`, because it is the same
|
|
31
|
+
* kind of thing: an authored consequence of an operation succeeding, expressed where the operation is
|
|
32
|
+
* expressed rather than buried in a handler.
|
|
33
|
+
*
|
|
34
|
+
* @example
|
|
35
|
+
* // One unit per successful export, whatever the export contains.
|
|
36
|
+
* [CoreResourceOperation.CREATE]: {
|
|
37
|
+
* variants: [ ... ],
|
|
38
|
+
* recordsUsage: { productKey: 'report_exports' },
|
|
39
|
+
* }
|
|
40
|
+
*
|
|
41
|
+
* @example
|
|
42
|
+
* // Usage that VARIES per operation, read from the row that was written.
|
|
43
|
+
* [Reports_Operations.RENDER]: {
|
|
44
|
+
* variants: [ ... ],
|
|
45
|
+
* recordsUsage: { productKey: 'rendered_pages', quantityFromResultField: 'pageCount' },
|
|
46
|
+
* }
|
|
47
|
+
*/
|
|
48
|
+
export interface MeteredUsageRecordingDefinition {
|
|
49
|
+
/**
|
|
50
|
+
* The METERED product's key.
|
|
51
|
+
*
|
|
52
|
+
* Convention, unchanged from the flush: the product key IS the provider's meter event name. Usage
|
|
53
|
+
* is only recorded when the caller's billing account holds an ACTIVE or TRIALING subscription
|
|
54
|
+
* containing a METERED product with this key — an operation declared against a product nobody has
|
|
55
|
+
* bought records nothing, and warns.
|
|
56
|
+
*/
|
|
57
|
+
productKey: string;
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Fixed units per successful operation. Defaults to 1.
|
|
61
|
+
*
|
|
62
|
+
* Mutually exclusive with {@link quantityFromResultField}: a usage amount has one source, and
|
|
63
|
+
* letting both apply would make "which one wins" a rule nobody could read off the declaration.
|
|
64
|
+
*/
|
|
65
|
+
quantity?: number;
|
|
66
|
+
|
|
67
|
+
/**
|
|
68
|
+
* Dot path to a NUMERIC field on the written row, for usage that varies per operation — pages
|
|
69
|
+
* rendered, bytes stored, rows exported.
|
|
70
|
+
*
|
|
71
|
+
* Read from the operation's RESULT rather than its input, deliberately: the input is what was
|
|
72
|
+
* asked for and the result is what happened, and only the second is what a customer should be
|
|
73
|
+
* billed for. A path that resolves to a non-number records nothing and warns, rather than
|
|
74
|
+
* defaulting to 1 — silently billing the wrong amount is worse than billing nothing and saying so.
|
|
75
|
+
*/
|
|
76
|
+
quantityFromResultField?: string;
|
|
77
|
+
}
|
|
78
|
+
```
|