@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -14,8 +14,8 @@
|
|
|
14
14
|
* OpenAI o-series, Claude 5 thinking, Gemini reasoning, …). The values mirror
|
|
15
15
|
* the AI SDK 7 top-level `reasoning` option EXACTLY, which the SDK translates to
|
|
16
16
|
* each provider's native reasoning setting (OpenAI `reasoning_effort`, Anthropic
|
|
17
|
-
*
|
|
18
|
-
* default.
|
|
17
|
+
* `output_config.effort`, …). Omit for non-reasoning models or to accept the
|
|
18
|
+
* provider default.
|
|
19
19
|
*
|
|
20
20
|
* Effort ladder (cost/latency ↑ with depth):
|
|
21
21
|
* - `NONE` — reasoning off; mechanical tasks (extraction, formatting, labelling).
|
|
@@ -26,20 +26,31 @@
|
|
|
26
26
|
* - `PROVIDER_DEFAULT` — explicitly defer to the model's own default effort.
|
|
27
27
|
*
|
|
28
28
|
* NOT EVERY MODEL SUPPORTS EVERY LEVEL — the SDK forwards the value and the
|
|
29
|
-
* provider validates it. Support matrix VERIFIED LIVE (2026-
|
|
30
|
-
*
|
|
29
|
+
* provider validates it. Support matrix VERIFIED LIVE (2026-09-08), per MODEL
|
|
30
|
+
* rather than per family, because the family is not uniform:
|
|
31
31
|
*
|
|
32
|
-
* | Model
|
|
33
|
-
*
|
|
34
|
-
* |
|
|
35
|
-
* |
|
|
36
|
-
* |
|
|
37
|
-
* | | | disabled is not supported…"; |
|
|
38
|
-
* | | | defaults to adaptive) |
|
|
32
|
+
* | Model | Supported | Rejected |
|
|
33
|
+
* |--------------------------------------|---------------------------------|-------------------------------|
|
|
34
|
+
* | GPT-5.6 sol / terra / luna | none, low, medium, high, xhigh | `minimal`, `provider-default` |
|
|
35
|
+
* | claude-fable-5 · claude-opus-5-5 | low, medium, high, xhigh | **`none`**, `minimal`, `provider-default` |
|
|
36
|
+
* | claude-sonnet-5 · claude-opus-5 | none, low, medium, high, xhigh | `minimal`, `provider-default` |
|
|
39
37
|
*
|
|
40
|
-
* ⚠️ `NONE` is
|
|
41
|
-
*
|
|
42
|
-
*
|
|
38
|
+
* ⚠️ `NONE` is NOT portable, but the line is finer than "OpenAI yes, Anthropic
|
|
39
|
+
* no": `claude-fable-5` and `claude-opus-5-5` refuse it while `claude-sonnet-5`
|
|
40
|
+
* and `claude-opus-5` accept it, so a level legal on one Opus revision is
|
|
41
|
+
* illegal on the next —
|
|
42
|
+
* which is why the capability is a per-model probed fact and never a family
|
|
43
|
+
* assumption. `PROVIDER_DEFAULT` is rejected as an explicit value by BOTH
|
|
44
|
+
* providers — omit the field entirely for the model's own default.
|
|
45
|
+
*
|
|
46
|
+
* How each provider expresses this natively, since the vocabularies differ and
|
|
47
|
+
* Anthropic's changed: OpenAI takes `reasoning_effort: <level>`. Anthropic
|
|
48
|
+
* takes `thinking: {type:'disabled'}` for `NONE`, and otherwise
|
|
49
|
+
* `thinking: {type:'adaptive'}` + `output_config: {effort: <level>}` — its
|
|
50
|
+
* accepted set is `low|medium|high|xhigh|max`, so `max` exists there and is
|
|
51
|
+
* deliberately NOT an enum member (OpenAI rejects it, and a level only one
|
|
52
|
+
* provider honours would not be portable). The older
|
|
53
|
+
* `thinking: {type:'enabled', budget_tokens}` form is RETIRED and now 400s.
|
|
43
54
|
*/
|
|
44
55
|
export enum LLMProvider_ReasoningEffort {
|
|
45
56
|
PROVIDER_DEFAULT = "provider-default",
|
|
@@ -93,7 +104,28 @@ export const validateReasoningEffortForModel = (
|
|
|
93
104
|
* REJECTS an explicit `temperature`).
|
|
94
105
|
*/
|
|
95
106
|
export const LLMProvider_OperationModelConfiguration_Schema = z.object({
|
|
96
|
-
|
|
107
|
+
/**
|
|
108
|
+
* A CONCRETE model id — the escape hatch, and no longer the ordinary way to answer "which model".
|
|
109
|
+
*
|
|
110
|
+
* Declare {@link modelApplicability} instead unless you specifically need THIS id: a fine-tuned
|
|
111
|
+
* or custom deployment, or an agent pinned for a reason worth writing down. Naming an id at each
|
|
112
|
+
* agent is what the applicability axis exists to replace — a monthly model launch then means one
|
|
113
|
+
* catalog edit rather than N definition edits, and nobody has to re-audit which agents should
|
|
114
|
+
* move.
|
|
115
|
+
*
|
|
116
|
+
* Exactly one of `model` / `modelApplicability` must be present (refined below).
|
|
117
|
+
*/
|
|
118
|
+
model: z.string().optional(),
|
|
119
|
+
/**
|
|
120
|
+
* The KIND of work this agent does — resolved to a concrete id at agent registration through
|
|
121
|
+
* `resolveModelForApplicability`, against the agent's own `providerRef`.
|
|
122
|
+
*
|
|
123
|
+
* This is the durable form: it survives model launches and retirements, and it states the
|
|
124
|
+
* cost/quality trade the author actually made. Resolution FAILS CLOSED with a named error, so an
|
|
125
|
+
* applicability no model of this provider serves is a startup error rather than a silent
|
|
126
|
+
* substitution.
|
|
127
|
+
*/
|
|
128
|
+
modelApplicability: z.enum(LLM_Model_Applicability).optional(),
|
|
97
129
|
providerRef: z.string(),
|
|
98
130
|
temperature: z.number().optional(),
|
|
99
131
|
maxTokens: z.number().optional(),
|
|
@@ -119,6 +151,23 @@ export const LLMProvider_OperationModelConfiguration_Schema = z.object({
|
|
|
119
151
|
toolingFunctionEnabled: z.boolean().optional(),
|
|
120
152
|
mcpCompatible: z.boolean().optional(),
|
|
121
153
|
toolChoice: LLMProvider_ToolChoice_Schema.optional(),
|
|
122
|
-
})
|
|
154
|
+
}).refine(
|
|
155
|
+
(config) => (config.model === undefined) !== (config.modelApplicability === undefined),
|
|
156
|
+
{
|
|
157
|
+
/*
|
|
158
|
+
* EXACTLY ONE, and both halves of that matter.
|
|
159
|
+
*
|
|
160
|
+
* NEITHER is the state this refinement mainly exists for — `model` used to be required, so
|
|
161
|
+
* omitting it is the new mistake and it must not reach a runtime that then has nothing to call.
|
|
162
|
+
*
|
|
163
|
+
* BOTH is the subtler one: a config carrying an id AND a class states two answers to one
|
|
164
|
+
* question, and whichever the resolver happened to prefer would be a silent decision. It is
|
|
165
|
+
* also exactly how the axis would have died — an applicability that coexists with the id it was
|
|
166
|
+
* meant to replace changes nothing, which is the trap #439 records.
|
|
167
|
+
*/
|
|
168
|
+
message: 'An LLM configuration must declare EXACTLY ONE of `model` (a concrete id — the escape hatch for fine-tuned or pinned deployments) or `modelApplicability` (the kind of work, resolved to an id at registration). Declaring both states two answers to one question; declaring neither leaves nothing to call.',
|
|
169
|
+
path: ['model'],
|
|
170
|
+
},
|
|
171
|
+
);
|
|
123
172
|
export type LLMProvider_OperationModelConfiguration = z.infer<typeof LLMProvider_OperationModelConfiguration_Schema>;
|
|
124
173
|
```
|
|
@@ -24,6 +24,16 @@ export const AppLevelComponentConfigurationSchema = z.object({
|
|
|
24
24
|
displayPolicy: z.union([z.literal("FIXED"), z.literal("OVERLAY")]).default("FIXED"),
|
|
25
25
|
hostedComponents: z.array(MenubarHostedComponentSchema).optional(),
|
|
26
26
|
items: z.array(MenubarLauncherItemSchema).optional(),
|
|
27
|
+
/**
|
|
28
|
+
* Render the application's identity — its mark and name — at the START of the bar as the
|
|
29
|
+
* HOME affordance, the horizontal counterpart of the sidebar's `BRAND_HEADER`. Opt-in, and
|
|
30
|
+
* off by default: a shell that also has a sidebar with a brand header would otherwise show
|
|
31
|
+
* the identity twice. A menubar-ONLY shell (no sidebar) is what needs it — without it the
|
|
32
|
+
* identity is nowhere on screen and there is no home affordance at all (#1454).
|
|
33
|
+
*/
|
|
34
|
+
brandHeader: z.boolean().optional(),
|
|
35
|
+
/** The mark variant the brand header renders; same vocabulary and same default (adaptive) as the sidebar's. */
|
|
36
|
+
brandMarkTheme: z.enum(BrandAssetTheme).optional(),
|
|
27
37
|
}),
|
|
28
38
|
]).default(true),
|
|
29
39
|
|
|
@@ -73,10 +83,34 @@ export const AppLevelComponentConfigurationSchema = z.object({
|
|
|
73
83
|
z.object({
|
|
74
84
|
placement: z.union([ z.literal(HorizontalPlacement.START), z.literal(HorizontalPlacement.END)]),
|
|
75
85
|
collapsible: z.boolean().default(true),
|
|
86
|
+
/**
|
|
87
|
+
* Does the sidebar start COLLAPSED (the icon rail) rather than expanded?
|
|
88
|
+
*
|
|
89
|
+
* This is the application's STARTING POSITION, not a lock: the rail
|
|
90
|
+
* collapse is a per-machine user preference persisted under
|
|
91
|
+
* `LOCAL_STORAGE_KEYS.SIDEBAR_COLLAPSED`, and a stored preference always
|
|
92
|
+
* wins. So this answers "what does a visitor with no preference yet
|
|
93
|
+
* see", which nothing could express before — the hydration fell back to
|
|
94
|
+
* `false`, making EXPANDED the only reachable default for every
|
|
95
|
+
* application.
|
|
96
|
+
*
|
|
97
|
+
* Pairs with the theme's `SidebarCompactLabelMode`: `ICON_AND_LABEL`
|
|
98
|
+
* renders a wrapping label under each icon in the collapsed rail, so a
|
|
99
|
+
* rail-first shell stays readable rather than becoming a column of
|
|
100
|
+
* unlabelled glyphs.
|
|
101
|
+
*
|
|
102
|
+
* OPTIONAL rather than `.default(false)` for the reason `homeDisplayMode`
|
|
103
|
+
* gives one line below: a Zod default makes the key REQUIRED in the
|
|
104
|
+
* inferred authoring type, forcing every preset and application config to
|
|
105
|
+
* restate an opinion it does not have. The framework default (expanded —
|
|
106
|
+
* the behavior every app had before this axis existed) is applied in
|
|
107
|
+
* `useSidebarBehavior`, which must resolve it there regardless because a
|
|
108
|
+
* sidebar authored as plain `true` never reaches this object branch.
|
|
109
|
+
*/
|
|
110
|
+
defaultCollapsed: z.boolean().optional(),
|
|
76
111
|
responsiveBreakpoint: z.enum(ViewportBreakpoint).default(ViewportBreakpoint.MOBILE),
|
|
77
112
|
responsivePolicy: z.enum(SidebarResponsivePolicy).default(SidebarResponsivePolicy.BURGER),
|
|
78
113
|
defaultSection: z.string().default("main"),
|
|
79
|
-
showUncategorized: z.boolean().default(true),
|
|
80
114
|
/**
|
|
81
115
|
* How the sidebar surfaces HOME — hidden, the pinned brand header
|
|
82
116
|
* (app symbol + name above the search trigger), or a "Home" navigation
|
|
@@ -222,16 +256,12 @@ export const AppLevelComponentConfigurationSchema = z.object({
|
|
|
222
256
|
sections: z.array(z.enum(UserDropdownSection)).optional(),
|
|
223
257
|
showOrgSwitcher: z.boolean().default(true),
|
|
224
258
|
showLogout: z.boolean().default(true),
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
[ApplicationLevelComponentType.SETTINGS_DROPDOWN]: z.union([
|
|
232
|
-
z.boolean().default(true),
|
|
233
|
-
z.object({
|
|
234
|
-
mergedWith: z.literal(ApplicationLevelComponentType.USER_DROPDOWN),
|
|
259
|
+
/**
|
|
260
|
+
* Settings-hub section refs surfaced inline in the dropdown, in order.
|
|
261
|
+
* Empty or omitted renders the single "Settings" button. Names the
|
|
262
|
+
* SETTINGS vocabulary directly — never a sidebar section ref.
|
|
263
|
+
*/
|
|
264
|
+
settingsEntries: z.array(z.string()).optional(),
|
|
235
265
|
}),
|
|
236
266
|
]).default(true),
|
|
237
267
|
|
|
@@ -22,6 +22,20 @@ export enum ApplicationLevelComponentType {
|
|
|
22
22
|
COMMAND_MENU = 'command_menu',
|
|
23
23
|
QUICK_ACTION_BUTTON = 'quick_action_button',
|
|
24
24
|
QUICK_SWITCHER = 'quick_switcher',
|
|
25
|
+
/**
|
|
26
|
+
* Settings/actions rail.
|
|
27
|
+
*
|
|
28
|
+
* **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**
|
|
29
|
+
* Decided 2026-09-09: not withdrawn, because it is an implemented, working preset and deleting a
|
|
30
|
+
* shell surface because no dogfood happens to use one yet is the weakest possible evidence; and
|
|
31
|
+
* not switched on, because doing so would mean inventing product concepts for a dogfood
|
|
32
|
+
* application in order to justify a surface.
|
|
33
|
+
*
|
|
34
|
+
* **It is switched on by the first application whose settings and actions genuinely want a
|
|
35
|
+
* persistent rail rather than the settings hub overlay.** Your Application does not — its settings
|
|
36
|
+
* reach is served by the hub — so enabling it there would demonstrate an empty rail, not the
|
|
37
|
+
* surface.
|
|
38
|
+
*/
|
|
25
39
|
CONTROL_PANEL = 'control_panel',
|
|
26
40
|
|
|
27
41
|
STATUS_BAR = 'status_bar',
|
|
@@ -31,18 +45,40 @@ export enum ApplicationLevelComponentType {
|
|
|
31
45
|
* renders the same preset. Exists to allow separate config entries while reusing
|
|
32
46
|
* the user dropdown component. For distinct UX, register a dedicated preset.
|
|
33
47
|
*/
|
|
34
|
-
SETTINGS_DROPDOWN = 'settings_dropdown',
|
|
35
48
|
NAVIGATION_CONTROL = 'navigation_control',
|
|
36
|
-
/**
|
|
49
|
+
/**
|
|
50
|
+
* Mode selector — renders available `AppMode`s as selectable icons.
|
|
51
|
+
*
|
|
52
|
+
* **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**
|
|
53
|
+
* Decided 2026-09-09, on the same reasoning as `CONTROL_PANEL`: neither withdrawn nor switched on.
|
|
54
|
+
*
|
|
55
|
+
* **Its condition is mechanical and checkable: it is switched on by the first application that
|
|
56
|
+
* declares more than one `AppMode`.** Your Application declares none, so the bar it would render is
|
|
57
|
+
* empty — enabling it there would demonstrate the gap rather than the surface, which is exactly
|
|
58
|
+
* what "switched on with something real in it" is meant to prevent.
|
|
59
|
+
*/
|
|
37
60
|
ACTIVITY_BAR = 'activity_bar',
|
|
38
61
|
/**
|
|
39
|
-
* Gmail-style right-side utility panel —
|
|
40
|
-
*
|
|
41
|
-
*
|
|
62
|
+
* Gmail-style right-side utility panel — renders configured components inside a collapsible
|
|
63
|
+
* side sheet.
|
|
64
|
+
*
|
|
65
|
+
* **Status, corrected 2026-09-09 (#504).** The panel renders its `items` INLINE and does not
|
|
66
|
+
* navigate at all: `useUtilityPanelBehavior` resolves an open/close state and a component list,
|
|
67
|
+
* and the preset renders each `componentRef` through the component registry. Nothing in the panel
|
|
68
|
+
* calls a navigation API.
|
|
69
|
+
*
|
|
70
|
+
* The previous wording said in-panel navigation "still needs its own dedicated navigation zone
|
|
71
|
+
* instead of reusing main navigation", which reads as a description of what the panel does today
|
|
72
|
+
* and is not one — there is no in-panel navigation, so nothing is reusing anything. Acting on it
|
|
73
|
+
* would mean adding a member to the closed `NavigationZoneName` vocabulary that no producer emits
|
|
74
|
+
* and no consumer reads: the declared-with-no-reader shape, created while removing it.
|
|
42
75
|
*
|
|
43
|
-
*
|
|
44
|
-
* side sheet
|
|
45
|
-
*
|
|
76
|
+
* A dedicated zone becomes real work the moment a panel item NAVIGATES. Then it is genuinely
|
|
77
|
+
* needed, because a push from inside a side sheet would otherwise land in `PRIMARY` and replace
|
|
78
|
+
* the workspace the panel is meant to sit beside. Design it then, against the zone vocabulary as
|
|
79
|
+
* it now stands (`maxDepth`, `responsiveCollapse`, `TABBED` all became live with #411) — and note
|
|
80
|
+
* `COMPANION` already describes "persistent supplementary content … a Slack thread panel", so the
|
|
81
|
+
* first question is whether the panel's zone IS `COMPANION` rather than a fourth member.
|
|
46
82
|
*/
|
|
47
83
|
UTILITY_PANEL = 'utility_panel',
|
|
48
84
|
}
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
# saas.frontend.billing-context
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
*
|
|
13
|
+
* Everything an application's own frontend reads or does about billing. Reached with `useBilling()`,
|
|
14
|
+
* which throws outside a `BillingProvider`; `useBillingSafe()` returns `undefined` instead, for a
|
|
15
|
+
* component that may render before the provider mounts or in an application where billing is off.
|
|
16
|
+
*
|
|
17
|
+
* The shipped billing components and the feature-gating hooks read this same context, so an
|
|
18
|
+
* application composing its own purchase flow works from exactly what they do — no application code
|
|
19
|
+
* builds the request.
|
|
20
|
+
*
|
|
21
|
+
* ## Starting a purchase
|
|
22
|
+
*
|
|
23
|
+
* `openCheckout(productKey, priceId, options)` posts to the scoped billing-account route and follows
|
|
24
|
+
* the returned URL; success and cancel destinations come from the application's own redirect base. A
|
|
25
|
+
* SECOND call while one is in flight is IGNORED, so a double-click cannot open two sessions — do not
|
|
26
|
+
* add your own guard expecting otherwise, and do not read the silence as a failure.
|
|
27
|
+
*
|
|
28
|
+
* The `priceId` must belong to the product named by `productKey`; the checkout operation refuses a
|
|
29
|
+
* mismatched pair. Resolve it through `getPricesForProduct` rather than assuming an ordering.
|
|
30
|
+
*
|
|
31
|
+
* `openCustomerPortal()` opens the provider's own portal — which is where payment methods, card
|
|
32
|
+
* updates and receipt downloads live. Those are deliberately NOT rendered by the framework, so an
|
|
33
|
+
* application that needs them links the portal rather than building them.
|
|
34
|
+
*
|
|
35
|
+
* ## What `usage` contains
|
|
36
|
+
*
|
|
37
|
+
* Metered consumption appears here only if the application RECORDS it. Nothing is automatic: a
|
|
38
|
+
* metered product with no recorded usage shows an empty dashboard rather than an error.
|
|
39
|
+
*
|
|
40
|
+
* ## Invoices are capped
|
|
41
|
+
*
|
|
42
|
+
* `invoices` carries the fifty most recent, which is what the shipped history component renders. An
|
|
43
|
+
* application needing more reads the invoices resource directly.
|
|
44
|
+
*/
|
|
45
|
+
export type BillingPlanChangeTarget = z.infer<typeof BillingSubscription_PreviewPlanChangeRequestDto>;
|
|
46
|
+
export type BillingPlanChangeConfirmation = z.infer<typeof BillingSubscription_ChangePlanRequestDto>;
|
|
47
|
+
export type BillingPlanChangePreviewResponse = z.infer<typeof BillingSubscription_PlanChangePreviewResponseDto>;
|
|
48
|
+
|
|
49
|
+
export interface BillingContextType {
|
|
50
|
+
// ── Configuration ──
|
|
51
|
+
isEnabled: boolean;
|
|
52
|
+
billingConfiguration: BillingConfiguration | undefined;
|
|
53
|
+
billingProvider: FrontendAppProviderModule | null;
|
|
54
|
+
|
|
55
|
+
// ── Billing State ──
|
|
56
|
+
billingAccount: BillingAccount | null;
|
|
57
|
+
subscription: BillingSubscriptionBase | null;
|
|
58
|
+
currentPlanKey: string | null;
|
|
59
|
+
currentPlanProduct: Product | null;
|
|
60
|
+
|
|
61
|
+
// ── Product Catalog ──
|
|
62
|
+
products: Product[];
|
|
63
|
+
prices: Price[];
|
|
64
|
+
productDefinitions: ProductDefinition[];
|
|
65
|
+
getPricesForProduct: (productId: string) => Price[];
|
|
66
|
+
getProductByKey: (key: string) => Product | undefined;
|
|
67
|
+
|
|
68
|
+
// ── Scope ──
|
|
69
|
+
currentScope: ResourcePrimaryScope | null;
|
|
70
|
+
|
|
71
|
+
// ── Invoices ──
|
|
72
|
+
invoices: InvoiceRef[];
|
|
73
|
+
|
|
74
|
+
// ── Promotions ──
|
|
75
|
+
activePromotions: Promotion[];
|
|
76
|
+
|
|
77
|
+
// ── Usage & Credits ──
|
|
78
|
+
usage: UsageSummary;
|
|
79
|
+
creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;
|
|
80
|
+
|
|
81
|
+
// ── Actions ──
|
|
82
|
+
openCheckout: (productKey: string, priceId: string, options?: {
|
|
83
|
+
quantity?: number;
|
|
84
|
+
promotionCode?: string;
|
|
85
|
+
}) => Promise<void>;
|
|
86
|
+
|
|
87
|
+
openCustomerPortal: () => Promise<void>;
|
|
88
|
+
/** Provider estimate bound to the current subscription and selected target; never commits a change. */
|
|
89
|
+
previewPlanChange: (target: BillingPlanChangeTarget, options?: { signal?: AbortSignal }) => Promise<BillingPlanChangePreviewResponse>;
|
|
90
|
+
/** Confirm only the server token returned for the displayed preview. Successful mutation refreshes billing state. */
|
|
91
|
+
confirmPlanChange: (confirmation: BillingPlanChangeConfirmation) => Promise<void>;
|
|
92
|
+
|
|
93
|
+
// ── State ──
|
|
94
|
+
isLoading: boolean;
|
|
95
|
+
error: Error | null;
|
|
96
|
+
/** Only a successful slice read establishes emptiness; failed or absent state is unavailable. */
|
|
97
|
+
availability: BillingStateAvailability | null;
|
|
98
|
+
isSliceAvailable: (slice: BillingStateSlice) => boolean;
|
|
99
|
+
|
|
100
|
+
// ── Actions ──
|
|
101
|
+
refetch: () => void;
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
// ── Default empty state ──
|
|
105
|
+
const EMPTY_USAGE: UsageSummary = {
|
|
106
|
+
byProduct: {},
|
|
107
|
+
};
|
|
108
|
+
```
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# saas.frontend.brand-identity
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Reads the application's brand identity for a shell surface.
|
|
14
|
+
*
|
|
15
|
+
* Owns ONE decision every brand-rendering surface would otherwise re-derive:
|
|
16
|
+
* how the active UI theme maps onto {@link BrandAssetTheme} (dark UI → `DARK`,
|
|
17
|
+
* light UI → `LIGHT`), unless the caller PINS a variant via `options.theme`.
|
|
18
|
+
* `resolveBrandAsset` then applies the framework's documented fallback chain, so
|
|
19
|
+
* an app that generated only a default-theme mark still gets it in dark mode
|
|
20
|
+
* instead of nothing.
|
|
21
|
+
*
|
|
22
|
+
* Must be used inside `ApplicationMainProvider` (it reads the application
|
|
23
|
+
* config) and inside `UIProvider` (it reads the resolved dark-mode state).
|
|
24
|
+
*
|
|
25
|
+
* ## Two things a caller does not have to solve
|
|
26
|
+
*
|
|
27
|
+
* The MARK VARIANT follows the active UI theme by default — dark UI asks for the dark mark, light UI
|
|
28
|
+
* for the light one, each falling back through the default. So an application that generated only a
|
|
29
|
+
* default-theme mark still gets it in dark mode rather than nothing. Pin `options.theme` only when a
|
|
30
|
+
* surface genuinely needs a fixed variant, such as a monochrome mark.
|
|
31
|
+
*
|
|
32
|
+
* WHOSE identity is rendered is decided here too, and it matters for any frontend that observes an
|
|
33
|
+
* application rather than being one — a creation tool, a back office. Such a frontend declares
|
|
34
|
+
* `shellIdentity` in its frontend configuration, and that identity WINS over the application config
|
|
35
|
+
* it reads. Without that precedence the tool renders its customer's brand as its own, because there
|
|
36
|
+
* is exactly one application-config endpoint and it belongs to the application.
|
|
37
|
+
*
|
|
38
|
+
```
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# saas.frontend.celebration-overlay-contract
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
*
|
|
13
|
+
* The props a celebration-overlay PRESET receives — the contract to implement when an application
|
|
14
|
+
* replaces how a celebration looks. Register the component as a preset for
|
|
15
|
+
* `FrontendComponentType.LOW_LEVEL_CELEBRATION_OVERLAY` (from `@wildo-ai/presets-components-models`);
|
|
16
|
+
* the framework's celebration wiring then renders yours with these props whenever a milestone with a
|
|
17
|
+
* `CELEBRATION` reward is achieved. Import the type from `@wildo-ai/saas-frontend-lib`.
|
|
18
|
+
*
|
|
19
|
+
* `notificationIdentifier` is `milestone.<identifier>` for a milestone celebration, which is how a
|
|
20
|
+
* preset can draw something different per milestone — typically for `mode === LOTTIE`.
|
|
21
|
+
*/
|
|
22
|
+
export interface CelebrationOverlayProps extends React.HTMLAttributes<HTMLDivElement> {
|
|
23
|
+
isActive: boolean
|
|
24
|
+
/** How to draw it — see `CelebrationDisplayMode`. Absent means the preset's own default. */
|
|
25
|
+
mode?: CelebrationDisplayMode
|
|
26
|
+
message?: string
|
|
27
|
+
/**
|
|
28
|
+
* Visible heading above the message — for a milestone, its own title. Not `title`: that is the
|
|
29
|
+
* HTML tooltip attribute inherited from `HTMLAttributes`.
|
|
30
|
+
*/
|
|
31
|
+
heading?: string
|
|
32
|
+
notificationIdentifier?: string
|
|
33
|
+
nextStep?: {
|
|
34
|
+
label: string
|
|
35
|
+
onClick: () => void
|
|
36
|
+
}
|
|
37
|
+
onDismiss?: () => void
|
|
38
|
+
dismissLabel?: string
|
|
39
|
+
ariaLabel?: string
|
|
40
|
+
}
|
|
41
|
+
```
|
|
@@ -31,6 +31,20 @@ export interface CompositeViewAuthoringConfig {
|
|
|
31
31
|
viewComponent: React.ComponentType<CompositeViewComponentProps>;
|
|
32
32
|
/** Companion-readable section refs used by the view's `<Section name="...">` nodes. */
|
|
33
33
|
sectionRefs?: string[];
|
|
34
|
+
/**
|
|
35
|
+
* View-local i18n label declarations (label refs + interpolation params) for this view's OWN
|
|
36
|
+
* text — the captions, KPI names and failure sentences its component renders, beyond the
|
|
37
|
+
* framework's baseline `title` / `description` (and each section's pair).
|
|
38
|
+
*
|
|
39
|
+
* The labelling pipeline plans `composite_views.<translationRef>.<labelRef>` from each entry, so
|
|
40
|
+
* the component resolves its words through the label tree and a translator can find them.
|
|
41
|
+
* Without a declaration there is no key, and the only remaining option is English written into
|
|
42
|
+
* the component — which no locale can translate and nobody who owns the wording can change.
|
|
43
|
+
*
|
|
44
|
+
* Item shape is `DeclaredViewLabel`; kept permissive like `viewComponent` — authored
|
|
45
|
+
* configuration, not user input.
|
|
46
|
+
*/
|
|
47
|
+
labels?: DeclaredViewLabel[];
|
|
34
48
|
/**
|
|
35
49
|
* Composite-view icon — `StandardIconReference` string or React component
|
|
36
50
|
* (Lucide / custom). Mirrored from authoring → {@link CompositeViewDefinition.icon},
|
|
@@ -39,6 +53,45 @@ export interface CompositeViewAuthoringConfig {
|
|
|
39
53
|
* overlays) render the authored icon.
|
|
40
54
|
*/
|
|
41
55
|
icon?: IconLike;
|
|
56
|
+
/**
|
|
57
|
+
* What happens to an ADJACENT zone (secondary / companion) this destination
|
|
58
|
+
* splits into, once that zone's last content is dismissed — overriding the
|
|
59
|
+
* zone's own `onEmpty` while this destination occupies primary.
|
|
60
|
+
*
|
|
61
|
+
* The zone-level `ZoneConfig.onEmpty` is one value for every destination that
|
|
62
|
+
* splits into that zone, and destinations legitimately disagree: a LIST wants
|
|
63
|
+
* the detail pane to stay put (`EMPTY_STATE`) so the layout does not reflow
|
|
64
|
+
* while a reviewer steps through rows, while a CANVAS wants its width back
|
|
65
|
+
* (`COLLAPSE`) the moment nothing is selected. Both share one secondary zone,
|
|
66
|
+
* so without this override one of them is always wrong.
|
|
67
|
+
*
|
|
68
|
+
* Omitted (the common case) defers to the zone, which itself defaults to
|
|
69
|
+
* `ZoneEmptyBehavior.COLLAPSE`. Resolution order is destination → zone →
|
|
70
|
+
* COLLAPSE; see `resolveZoneEmptyBehavior`.
|
|
71
|
+
*/
|
|
72
|
+
adjacentZoneOnEmpty?: ZoneEmptyBehavior;
|
|
73
|
+
/**
|
|
74
|
+
* How wide this destination's content may grow in the zone, in the framework's shared width
|
|
75
|
+
* vocabulary — the SAME `ResponsiveMaxWidth` a Surface, a `DisplayLayout` and a `FormLayout` use.
|
|
76
|
+
*
|
|
77
|
+
* Omitted (the common case) is `'content'`: capped and centred at `var(--content-max-width, 80rem)`,
|
|
78
|
+
* right for a form, a list or a detail page and wrong only for content whose value IS the space it
|
|
79
|
+
* occupies — a board, a wide table, a canvas — which declare `'none'`.
|
|
80
|
+
*/
|
|
81
|
+
zoneContentMaxWidth?: ResponsiveMaxWidth;
|
|
82
|
+
/**
|
|
83
|
+
* Whether this destination's content fills the zone's HEIGHT as well.
|
|
84
|
+
*
|
|
85
|
+
* `true` makes the zone's content boundary a definite-height flex column, so this view's root may use
|
|
86
|
+
* `flex-1 min-h-0` and resolve against something real. Without it a canvas has no intrinsic height
|
|
87
|
+
* and collapses to zero — which is why one had to hand-roll `h-[70vh]`, sizing against the WINDOW
|
|
88
|
+
* rather than the container it sits in. PRIMARY only: an adjacent zone scrolls, so a filling child
|
|
89
|
+
* and a scrolling parent contradict each other.
|
|
90
|
+
*
|
|
91
|
+
* Separate from the width above ON PURPOSE — see `zone-content-geometry.ts` for why the enum that
|
|
92
|
+
* fused them could not express a capped width with a definite height.
|
|
93
|
+
*/
|
|
94
|
+
zoneContentFillsHeight?: boolean;
|
|
42
95
|
}
|
|
43
96
|
|
|
44
97
|
/**
|
|
@@ -84,6 +137,11 @@ export interface CompositeViewDefinition {
|
|
|
84
137
|
operationLike: CoreResourceOperation;
|
|
85
138
|
primaryScope: ResourcePrimaryScope;
|
|
86
139
|
sectionRefs?: string[];
|
|
140
|
+
/**
|
|
141
|
+
* See {@link CompositeViewAuthoringConfig.labels}. Mirrored from authoring, and declared in the
|
|
142
|
+
* Zod schema too — the startup config parse strips schema-unknown keys.
|
|
143
|
+
*/
|
|
144
|
+
labels?: DeclaredViewLabel[];
|
|
87
145
|
viewComponent: React.ComponentType<CompositeViewComponentProps>;
|
|
88
146
|
/** Required features for this view — gates navigation + route access */
|
|
89
147
|
requiredFeatures?: RequiredFeaturesConfig;
|
|
@@ -94,6 +152,12 @@ export interface CompositeViewDefinition {
|
|
|
94
152
|
* `CoreIconRegistry.compositeView`, keyed by `ref`.
|
|
95
153
|
*/
|
|
96
154
|
icon?: IconLike;
|
|
155
|
+
/** See {@link CompositeViewAuthoringConfig.adjacentZoneOnEmpty}. Mirrored from authoring. */
|
|
156
|
+
adjacentZoneOnEmpty?: ZoneEmptyBehavior;
|
|
157
|
+
/** See {@link CompositeViewAuthoringConfig.zoneContentMaxWidth}. Mirrored from authoring. */
|
|
158
|
+
zoneContentMaxWidth?: ResponsiveMaxWidth;
|
|
159
|
+
/** See {@link CompositeViewAuthoringConfig.zoneContentFillsHeight}. Mirrored from authoring. */
|
|
160
|
+
zoneContentFillsHeight?: boolean;
|
|
97
161
|
}
|
|
98
162
|
|
|
99
163
|
export type AppCompositeViewsConfig = Record<string, CompositeViewAuthoringConfig>;
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# saas.frontend.display-layout.reading-measure
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
export interface DisplayLayoutProps {
|
|
13
|
+
/** Additional CSS classes for the root container. */
|
|
14
|
+
className?: string;
|
|
15
|
+
/**
|
|
16
|
+
* How wide the layout root lets its content grow, named in the framework's own vocabulary.
|
|
17
|
+
*
|
|
18
|
+
* Defaults to `'measure'` — the reading-measure cap (~42rem, themeable via `--measure-max-width`)
|
|
19
|
+
* that keeps a single-column stack of label/value pairs readable instead of stretched edge to edge.
|
|
20
|
+
* That default is right for what this layout was built for and is unchanged.
|
|
21
|
+
*
|
|
22
|
+
* It is WRONG for a composed document. A template that renders tabs, quote blocks, tables or regions
|
|
23
|
+
* is not a field stack: those set their own measure internally, and a 42rem cap around them squeezes
|
|
24
|
+
* the whole composition into a column with dead space beside it. Such a template declares `'none'`.
|
|
25
|
+
*
|
|
26
|
+
* `'none'` is not "uncapped" in practice — the zone content boundary above has already capped the
|
|
27
|
+
* area at the page-content width (`'content'`, ~80rem) and an adjacent pane is narrower still. This
|
|
28
|
+
* prop decides only whether a SECOND, tighter cap applies inside that, and the answer depends on what
|
|
29
|
+
* the template renders, which is why the template is the one asked.
|
|
30
|
+
*/
|
|
31
|
+
responsiveMaxWidth?: ResponsiveMaxWidth;
|
|
32
|
+
children?: ReactNode;
|
|
33
|
+
}
|
|
34
|
+
```
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# saas.frontend.errors.user-facing-error-message
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Turns a caught error into the words a person may read. Import it from `@wildo-ai/saas-frontend-lib`.
|
|
14
|
+
*
|
|
15
|
+
* Returns `(error, surfaceMessage?) => string`:
|
|
16
|
+
* - `error` — whatever was caught: a rejected request, a thrown `Error`, a failed action's `error`.
|
|
17
|
+
* - `surfaceMessage` — optional: your screen's own localized words for this failure, e.g.
|
|
18
|
+
* `t(MyViewLabel.SAVE_FAILED)`. It replaces a generic category ("validation", "not found") that would
|
|
19
|
+
* mislead on your screen, and is what shows when the error carries nothing displayable.
|
|
20
|
+
*
|
|
21
|
+
* The text comes from the application's error catalog, your surface words, or the backend's user
|
|
22
|
+
* guidance — never from the error's own `message`, which for a backend rejection is a reference key and
|
|
23
|
+
* for a thrown `Error` is developer text. Keep the error itself for logging; show only this.
|
|
24
|
+
*
|
|
25
|
+
* The returned function has a stable identity, so it is safe in `useCallback` / `useEffect` dependencies.
|
|
26
|
+
*
|
|
27
|
+
* @example
|
|
28
|
+
* const toUserFacingErrorMessage = useUserFacingErrorMessage();
|
|
29
|
+
* const [failure, setFailure] = useState<string | null>(null);
|
|
30
|
+
* try {
|
|
31
|
+
* await saveNote();
|
|
32
|
+
* } catch (error) {
|
|
33
|
+
* setFailure(toUserFacingErrorMessage(error, t(NoteViewLabel.SAVE_FAILED)));
|
|
34
|
+
* }
|
|
35
|
+
*/
|
|
36
|
+
export function useUserFacingErrorMessage(): (error: unknown, surfaceMessage?: string) => string {
|
|
37
|
+
const { tErrorMessage, tErrorGuidance } = useI18n();
|
|
38
|
+
const translatorsRef = useRef<ErrorMessageTranslators>({ tErrorMessage, tErrorGuidance });
|
|
39
|
+
translatorsRef.current = { tErrorMessage, tErrorGuidance };
|
|
40
|
+
|
|
41
|
+
return useCallback(
|
|
42
|
+
(error: unknown, surfaceMessage?: string) =>
|
|
43
|
+
resolveUserFacingErrorMessage(error, { translators: translatorsRef.current, surfaceMessage }),
|
|
44
|
+
[],
|
|
45
|
+
);
|
|
46
|
+
}
|
|
47
|
+
```
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
* **The pattern (single-action mutation surface):**
|
|
18
18
|
*
|
|
19
19
|
* ```tsx
|
|
20
|
+
* const toUserFacingErrorMessage = useUserFacingErrorMessage();
|
|
20
21
|
* const action = execution.actions.operation({
|
|
21
22
|
* resourceType: 'todos',
|
|
22
23
|
* resourceId,
|
|
@@ -34,7 +35,7 @@
|
|
|
34
35
|
* </Button>
|
|
35
36
|
* {action.status.latestFailure && (
|
|
36
37
|
* <Banner>
|
|
37
|
-
* {action.status.latestFailure.error
|
|
38
|
+
* {toUserFacingErrorMessage(action.status.latestFailure.error)}
|
|
38
39
|
* <Button onClick={() => { void action.retry(); }}>Retry</Button>
|
|
39
40
|
* <Button onClick={() => { action.clearMyFailures(); }}>Dismiss</Button>
|
|
40
41
|
* </Banner>
|
|
@@ -43,6 +44,11 @@
|
|
|
43
44
|
* );
|
|
44
45
|
* ```
|
|
45
46
|
*
|
|
47
|
+
* **Showing the failure.** `latestFailure.error` is the error the operation rejected with. Render it
|
|
48
|
+
* through `useUserFacingErrorMessage()` (from `@wildo-ai/saas-frontend-lib`), which yields the
|
|
49
|
+
* application's localized words for it. Never render `error.message`: for a backend rejection it is a
|
|
50
|
+
* reference key, and for a thrown `Error` it is developer text.
|
|
51
|
+
*
|
|
46
52
|
* The whole retry loop closes inside one `ExecutionOperationAction` value:
|
|
47
53
|
*
|
|
48
54
|
* 1. **Fail path.** `execute()` rejects → the shell appends a captured entry
|