@wildo-ai/framework-knowledge 1.1.3 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +349 -17
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
# Framework Error User-Guidance API
|
|
2
|
+
|
|
3
|
+
Throwing an error the person who hit it can act on.
|
|
4
|
+
|
|
5
|
+
`buildError(...)` produces a typed failure with a stable code — that is what a CALLER needs. When the
|
|
6
|
+
person reading the message could do something about it, use the guidance pair instead: the frontend
|
|
7
|
+
renders `explanation`, `resolution` and a `nextAction` from `ErrorResponse.error.userGuidance`.
|
|
8
|
+
|
|
9
|
+
## Prefer the KEY variant
|
|
10
|
+
|
|
11
|
+
| method | labels |
|
|
12
|
+
|---|---|
|
|
13
|
+
| `buildErrorWithGuidanceKey(type, ctx, guidanceKey, guidance, options)` | resolved from i18n under `errors_guidance.{guidanceKey}.{field}` — translated like every other user-facing string |
|
|
14
|
+
| `buildErrorWithGuidance(type, ctx, guidance, options)` | rendered VERBATIM — English forever |
|
|
15
|
+
|
|
16
|
+
Use the raw form only for a failure no user will read, or as the fallback beneath a key. A guidance
|
|
17
|
+
string authored inline is a user-facing string that escaped the i18n tree, and nothing will flag it.
|
|
18
|
+
|
|
19
|
+
## What guidance is for
|
|
20
|
+
|
|
21
|
+
Guidance answers "what do I do now", not "what went wrong". A `nextAction` that points somewhere the
|
|
22
|
+
person can actually reach — a settings route, a document — is what turns a dead end into a step.
|
|
23
|
+
`missingConfiguration` names the specific keys that are absent, so the message does not make somebody
|
|
24
|
+
hunt for them.
|
|
25
|
+
|
|
26
|
+
## Related
|
|
27
|
+
|
|
28
|
+
- `references/operation-file-conventions.md` — `isWildoBackendError` in a `catch`, and the typed
|
|
29
|
+
`buildError` surface this extends.
|
|
30
|
+
|
|
31
|
+
## Error User Guidance
|
|
32
|
+
|
|
33
|
+
## Import Origins
|
|
34
|
+
|
|
35
|
+
- `@wildo-ai/saas-backend-lib`
|
|
36
|
+
|
|
37
|
+
## Source Excerpts
|
|
38
|
+
|
|
39
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
40
|
+
|
|
41
|
+
```typescript
|
|
42
|
+
*
|
|
43
|
+
* Build an error with contextual user guidance.
|
|
44
|
+
*
|
|
45
|
+
* Reach for this instead of a bare `buildError` whenever the person who hits the failure could DO
|
|
46
|
+
* something about it. A typed error tells a caller what went wrong; guidance tells a human what to
|
|
47
|
+
* do next, and the frontend renders it from `ErrorResponse.error.userGuidance`.
|
|
48
|
+
*
|
|
49
|
+
* ⚠️ **Prefer `buildErrorWithGuidanceKey`.** The strings you pass here are rendered verbatim, so a
|
|
50
|
+
* guidance written this way is English forever — the key variant resolves labels under
|
|
51
|
+
* `errors_guidance.{guidanceKey}.{field}` and is translated like every other user-facing string.
|
|
52
|
+
* Use the raw form only for a failure no user will read, or as the fallback beneath a key.
|
|
53
|
+
*
|
|
54
|
+
* The guidance is attached to the error and will be included in the
|
|
55
|
+
* `ErrorResponse.error.userGuidance` field for the frontend to render.
|
|
56
|
+
*
|
|
57
|
+
* @example
|
|
58
|
+
* ```
|
|
59
|
+
* throw this.errorBuilder.buildErrorWithGuidance(
|
|
60
|
+
* ErrorType.CONFIGURATION,
|
|
61
|
+
* executionContext,
|
|
62
|
+
* {
|
|
63
|
+
* explanation: 'SMTP is not configured for this organization.',
|
|
64
|
+
* resolution: 'Go to Settings → Email and configure your SMTP provider.',
|
|
65
|
+
* nextAction: { label: 'Go to Settings', ref: '/settings/email', type: 'url' },
|
|
66
|
+
* missingConfiguration: ['smtp_host', 'smtp_port'],
|
|
67
|
+
* },
|
|
68
|
+
* { customMessageReference: ErrorCustomMessageReference.GENERIC_DETAIL }
|
|
69
|
+
* );
|
|
70
|
+
* ```
|
|
71
|
+
*/
|
|
72
|
+
public buildErrorWithGuidance(
|
|
73
|
+
errorType: ErrorType,
|
|
74
|
+
executionContext: ExecutionContext<any> | undefined,
|
|
75
|
+
guidance: ErrorUserGuidance,
|
|
76
|
+
options: {
|
|
77
|
+
customMessageReference?: ErrorCustomMessageReference;
|
|
78
|
+
context?: Record<string, any>;
|
|
79
|
+
stack?: string;
|
|
80
|
+
} = {}
|
|
81
|
+
): WildoError_Backend {
|
|
82
|
+
const error = this.buildError(errorType, executionContext, options);
|
|
83
|
+
error.userGuidance = guidance;
|
|
84
|
+
return error;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
/**
|
|
88
|
+
* Build an error with a guidance key (i18n reference).
|
|
89
|
+
*
|
|
90
|
+
* Shorthand for `buildErrorWithGuidance` that sets the `guidanceKey` on the guidance object,
|
|
91
|
+
* enabling i18n label resolution under `errors_guidance.{guidanceKey}.{field}`.
|
|
92
|
+
*
|
|
93
|
+
* @param errorType - The error type
|
|
94
|
+
* @param executionContext - Current execution context
|
|
95
|
+
* @param guidanceKey - i18n lookup key (resolves labels under `errors_guidance.{guidanceKey}.*`)
|
|
96
|
+
* @param guidance - Guidance fields (explanation, resolution, etc.) — used as raw fallbacks
|
|
97
|
+
* @param options - Additional error options
|
|
98
|
+
*/
|
|
99
|
+
public buildErrorWithGuidanceKey(
|
|
100
|
+
errorType: ErrorType,
|
|
101
|
+
executionContext: ExecutionContext<any> | undefined,
|
|
102
|
+
guidanceKey: string,
|
|
103
|
+
guidance: Omit<ErrorUserGuidance, 'guidanceKey'> = {},
|
|
104
|
+
options: {
|
|
105
|
+
customMessageReference?: ErrorCustomMessageReference;
|
|
106
|
+
context?: Record<string, any>;
|
|
107
|
+
stack?: string;
|
|
108
|
+
} = {}
|
|
109
|
+
): WildoError_Backend {
|
|
110
|
+
return this.buildErrorWithGuidance(errorType, executionContext, { ...guidance, guidanceKey }, options);
|
|
111
|
+
}
|
|
112
|
+
```
|
|
@@ -36,6 +36,8 @@ export type ResourceConfiguration_Operation_Base<
|
|
|
36
36
|
operationIdentifier : TCustomOperationEnum | TCoreOperationEnum,
|
|
37
37
|
isOperationDefault : boolean, // default true
|
|
38
38
|
serviceRuntimeMode: ResourceOperation_ServiceRuntimeMode; //default ResourceOperation_ServiceRuntimeMode.INLINE
|
|
39
|
+
/** Validated operation policy, shared by authored and generated variants. */
|
|
40
|
+
queueConfig?: ResourceConfiguration_QueueConfig;
|
|
39
41
|
generatedOperation?: ResourceConfiguration_GeneratedOperationMetadata;
|
|
40
42
|
|
|
41
43
|
requestDto?: z.ZodSchema<any>;
|
|
@@ -75,11 +77,80 @@ export type ResourceConfiguration_Operation_Base<
|
|
|
75
77
|
*/
|
|
76
78
|
repositoryDto?: z.ZodSchema<any>;
|
|
77
79
|
|
|
78
|
-
|
|
80
|
+
/**
|
|
81
|
+
* `EVENT_COUNTER` badge writes this operation performs after it succeeds.
|
|
82
|
+
*
|
|
83
|
+
* `badgeRef` is a badge KEY (`<scope>:<identifier>`), NOT a bare identifier, and it is what
|
|
84
|
+
* decides which badge is written — including at WHICH SCOPE. The scope used to be inferred from
|
|
85
|
+
* this operation's own `resourcePrimaryScope`, which meant an operation on a user-scoped
|
|
86
|
+
* resource wrote a user-scoped counter even when the definition it named lived at organization
|
|
87
|
+
* scope: a row no definition declared, that no screen could render, reported nowhere.
|
|
88
|
+
*
|
|
89
|
+
* Every `badgeRef` is resolved against the registered `notificationBadgeDefinitions` at
|
|
90
|
+
* CONFIGURATION time and the application refuses to start when one does not resolve. Only the
|
|
91
|
+
* scopeId — whose badge — is left to the request.
|
|
92
|
+
*/
|
|
93
|
+
notificationBadgeOperations: { badgeRef: NotificationBadgeKey, operation: NotificationBadgeOperation }[];
|
|
79
94
|
userNotifications: UserNotificationDefinition[];
|
|
80
95
|
m2mNotifications: M2MNotificationDefinitionWithoutIdentifier[];
|
|
96
|
+
/** Authored metered-usage recording for this operation; `undefined` when it consumes nothing. */
|
|
97
|
+
recordsUsage?: MeteredUsageRecordingDefinition;
|
|
98
|
+
/**
|
|
99
|
+
* The purpose this operation's own processing rests on, and what a missing grant costs (#1258
|
|
100
|
+
* Step 3). `undefined` means this operation declares nothing beyond whatever
|
|
101
|
+
* `serviceConsentRequirement` already requires application-wide.
|
|
102
|
+
*/
|
|
103
|
+
consentGate?: ResourceOperationConsentGateDeclaration;
|
|
81
104
|
}
|
|
82
105
|
```
|
|
106
|
+
|
|
107
|
+
## Import Origins
|
|
108
|
+
|
|
109
|
+
- `@wildo-ai/saas-models`
|
|
110
|
+
|
|
111
|
+
## Source Excerpts
|
|
112
|
+
|
|
113
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
114
|
+
|
|
115
|
+
```typescript
|
|
116
|
+
*
|
|
117
|
+
* Queue policy for an operation declared with createResourceConfiguration_Initialization
|
|
118
|
+
* from @wildo-ai/saas-models. Set queueConfig beside serviceRuntimeMode, outside variants.
|
|
119
|
+
* Omitted fields take the schema defaults. timeoutMs limits caller waiting, not execution.
|
|
120
|
+
* Priority selects the initial queue lane; retries do not promise permanent priority ordering.
|
|
121
|
+
* maxRetries limits additional attempts after an actual failure, not duplicate broker deliveries.
|
|
122
|
+
*
|
|
123
|
+
* @example
|
|
124
|
+
* // Inside an operation configuration:
|
|
125
|
+
* // serviceRuntimeMode: ResourceOperation_ServiceRuntimeMode.QUEUED,
|
|
126
|
+
* // queueConfig: { timeoutMs: 30000, maxRetries: 0 },
|
|
127
|
+
*/
|
|
128
|
+
export const ResourceConfiguration_QueueConfigSchema = z.object({
|
|
129
|
+
/** Priority for queue routing (HIGH/CRITICAL → priority queue) */
|
|
130
|
+
priority: z.enum(JobPriority).default(JobPriority.NORMAL),
|
|
131
|
+
|
|
132
|
+
/** Maximum retry attempts before dead-letter */
|
|
133
|
+
maxRetries: z.number().int().min(0).default(3),
|
|
134
|
+
|
|
135
|
+
/** Caller reply-wait deadline in milliseconds (default: 5 minutes). Does not cancel worker execution. */
|
|
136
|
+
timeoutMs: z.number().int().min(1000).max(2147483647).default(300000),
|
|
137
|
+
|
|
138
|
+
/**
|
|
139
|
+
* Retry backoff timing (base delay, cap, curve). Controls how long a failed
|
|
140
|
+
* job of this operation waits before each re-attempt. Optional — unset fields
|
|
141
|
+
* fall back to `QUEUE_RETRY_DEFAULTS`. Honored by the queue worker via a
|
|
142
|
+
* durable broker delay queue (see `QueueRetryBackoffConfig`). Distinct from
|
|
143
|
+
* `maxRetries` (how many attempts) and `timeoutMs` (caller reply-wait deadline).
|
|
144
|
+
*/
|
|
145
|
+
retryConfig: QueueRetryBackoffConfigSchema.optional(),
|
|
146
|
+
|
|
147
|
+
}).strict().optional();
|
|
148
|
+
|
|
149
|
+
export type ResourceConfiguration_QueueConfig = z.infer<typeof ResourceConfiguration_QueueConfigSchema>;
|
|
150
|
+
|
|
151
|
+
/** Application input accepts omitted defaulted fields; the resource factory validates and resolves them. */
|
|
152
|
+
export type ResourceConfiguration_QueueConfigAuthored = z.input<typeof ResourceConfiguration_QueueConfigSchema>;
|
|
153
|
+
```
|
|
83
154
|
## Import Origins
|
|
84
155
|
|
|
85
156
|
- `@wildo-ai/saas-models`
|
|
@@ -14,14 +14,190 @@ Conflict handling is equally explicit: a resolver must return `RECONCILED`,
|
|
|
14
14
|
`RETRY_TRANSACTION`, or `UNHANDLED`; the framework never interprets an absent
|
|
15
15
|
winner as permission to retry.
|
|
16
16
|
|
|
17
|
+
The `BEFORE_TRANSACTIONAL_CORE` result types appear in the same excerpt: the
|
|
18
|
+
disposition vocabulary (`CONTINUE`, `ALREADY_COMPLETED`) and the result union a
|
|
19
|
+
`beforeTransactionalCore` handler returns. A result that is neither is refused
|
|
20
|
+
before any transaction opens.
|
|
21
|
+
|
|
22
|
+
Post-commit effect ownership is in the excerpt too, so you can recognize it —
|
|
23
|
+
an application does not declare it. By default (`FRAMEWORK`) the framework
|
|
24
|
+
writes an operation's audit row and dispatches its notifications after commit.
|
|
25
|
+
`IMPLEMENTATION_OUTBOX` is reserved for engine-owned writers whose effects an
|
|
26
|
+
engine relay delivers from an outbox: the framework suppresses its own delivery
|
|
27
|
+
for the occurrence and hands the core phases `utils.postCommitEffectCapture`
|
|
28
|
+
(`prepareAudit`, `deferredContext`, `notificationInputs`), which that writer
|
|
29
|
+
enqueues in its transaction. Delivery is engine-internal; there is no
|
|
30
|
+
application-facing relay, so an application declaring it would lose its audit
|
|
31
|
+
rows and notifications.
|
|
32
|
+
|
|
33
|
+
What does reach application code: every resource post-operation hook receives
|
|
34
|
+
a fifth argument, `{ postCommitEffectOwnership }`, which a hook that does not
|
|
35
|
+
own outbox-delivered work ignores.
|
|
36
|
+
|
|
17
37
|
## Import Origins
|
|
18
38
|
|
|
19
39
|
- `@wildo-ai/saas-backend-lib`
|
|
40
|
+
- `@wildo-ai/saas-models`
|
|
20
41
|
|
|
21
42
|
## Source Excerpts
|
|
22
43
|
|
|
23
44
|
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
24
45
|
|
|
46
|
+
```typescript
|
|
47
|
+
/**
|
|
48
|
+
* The attribution and scope of a committed operation occurrence, persisted so an effect delivered later — by an outbox
|
|
49
|
+
* relay, possibly in another process — runs under the principal that performed the operation (#535).
|
|
50
|
+
*
|
|
51
|
+
* JSON-safe by construction. The framework's replay rebuilds the context from it with every principal-category validation
|
|
52
|
+
* re-run, inside the original request frame, so the rebuilt context — and every log line and audit row it produces —
|
|
53
|
+
* carries the original request's correlation id instead of a fresh one.
|
|
54
|
+
*
|
|
55
|
+
* SECURITY: persist it only in a server-owned row written in the operation's own transaction. It is not an
|
|
56
|
+
* authentication input; nothing a client authored may ever reach a replay.
|
|
57
|
+
*/
|
|
58
|
+
export interface ResourceOperationDeferredEffectContext {
|
|
59
|
+
/** The variant-resolved operation's path, which the replay resolves back to the operation. */
|
|
60
|
+
operationPath: {
|
|
61
|
+
resourceIdentifier: string;
|
|
62
|
+
operationIdentifier: string;
|
|
63
|
+
variantType: ResourceOperationVariantType;
|
|
64
|
+
variantKey?: string;
|
|
65
|
+
isOperationDefault?: boolean;
|
|
66
|
+
isBulkOperation?: boolean;
|
|
67
|
+
};
|
|
68
|
+
executionType: ExecutionContext_ExecutionType;
|
|
69
|
+
initiatorIds: ExecutionContext_InitiatorIds | null;
|
|
70
|
+
initiatorRoles: ExecutionContext_RoleInfo[];
|
|
71
|
+
relationshipContexts: ExecutionContext_RelationshipContext[];
|
|
72
|
+
/**
|
|
73
|
+
* The context's scope map as a record. A multi-valued entry stays an array — deliberately unlike the queue serializer's
|
|
74
|
+
* reconstruction, which keeps only the first value and would narrow the replay's scope.
|
|
75
|
+
*/
|
|
76
|
+
contextResourceIds: Record<string, string | string[]>;
|
|
77
|
+
auditActorUserId?: string;
|
|
78
|
+
requestFrame: { correlationId: string; frontendServiceName?: string; clientInstanceId?: string };
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* The inputs the notification phases read, captured from the committed attempt. JSON-safe: a `Date` arrives at the replay
|
|
83
|
+
* as its ISO string and a `bigint` as its decimal string, which is what the row's persisted form already carries.
|
|
84
|
+
*/
|
|
85
|
+
export interface ResourceOperationNotificationEffectInputs {
|
|
86
|
+
inputDto: unknown;
|
|
87
|
+
currentObject: unknown;
|
|
88
|
+
/** The attempt's prior row, or compact multi-id owner snapshots, for derived-badge recomputation. */
|
|
89
|
+
previousObject: unknown;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* What an implementation that owns its post-commit effects (`IMPLEMENTATION_OUTBOX`) captures inside the transactional
|
|
94
|
+
* core, so it can enqueue them in the same transaction and have them delivered later exactly as the framework would
|
|
95
|
+
* have delivered them (#535).
|
|
96
|
+
*
|
|
97
|
+
* Present on `utils` only under that ownership, and only in the core phases (PREFIX, REPLACE, POSTFIX), because only
|
|
98
|
+
* there does an enqueue share the commit. Each method answers from the CURRENT attempt, so a database-driver retry
|
|
99
|
+
* never enqueues what an aborted attempt saw.
|
|
100
|
+
*/
|
|
101
|
+
export interface ResourceOperationPostCommitEffectCapture {
|
|
102
|
+
/**
|
|
103
|
+
* The resource-operation audit record for `postOperationState`, or `null` when the operation is below the audit floor.
|
|
104
|
+
* Built by the same preparation as the framework's own emission, with one deliberate difference: its pre-image is the
|
|
105
|
+
* row THIS attempt read inside its transaction, where the framework's emission uses the row read before the transaction
|
|
106
|
+
* opened. Under a concurrent writer the two can disagree on `before` values, and this one is the accurate one.
|
|
107
|
+
*/
|
|
108
|
+
prepareAudit(postOperationState: unknown): ResourceOperationPerformedAuditData | null;
|
|
109
|
+
/** The occurrence's attribution, scope and request frame. */
|
|
110
|
+
deferredContext(): ResourceOperationDeferredEffectContext;
|
|
111
|
+
/** The notification phases' inputs for `postOperationState`. */
|
|
112
|
+
notificationInputs(postOperationState: unknown): ResourceOperationNotificationEffectInputs;
|
|
113
|
+
}
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
117
|
+
|
|
118
|
+
```typescript
|
|
119
|
+
/**
|
|
120
|
+
* What a `BEFORE_TRANSACTIONAL_CORE` handler decided (#535).
|
|
121
|
+
*
|
|
122
|
+
* `CONTINUE` runs the operation's transactional core with `coreInputPatch` merged into its input; the core phases read
|
|
123
|
+
* `continuation` from `utils.beforeTransactionalCore`. The patch's keys are server-owned for the whole core phase: their
|
|
124
|
+
* value after PREFIX persists, even for a field the request DTO seals.
|
|
125
|
+
*
|
|
126
|
+
* `ALREADY_COMPLETED` means an earlier request already committed this operation's effect. The framework skips core
|
|
127
|
+
* persistence, managed post-commit effects (so no second audit row) and token consumption; it applies the synchronous
|
|
128
|
+
* terminal result transforms, as it does for a reconciled conflict winner, and answers the target's CURRENT stored state
|
|
129
|
+
* through the operation's output transform. Two consequences of answering from stored state:
|
|
130
|
+
* - a DELETE replay answers `null`, because the row is gone (the original request answered the deleted state);
|
|
131
|
+
* - terminal transforms see the stored, POST-change row as `utils.currentObject`, not the pre-change row.
|
|
132
|
+
* It is refused without a single explicit target (a CREATE or a filter target; a bulk operation never reaches this
|
|
133
|
+
* point) and when a consumable token is presented.
|
|
134
|
+
*
|
|
135
|
+
* The phase as a whole is refused, before the handler runs, on a bulk operation, on a non-object input, on a missing
|
|
136
|
+
* explicit target, and on a caller's change to a read-only field — every refusal that does not depend on the handler's
|
|
137
|
+
* answer comes first, so a refused call never leaves an external effect behind.
|
|
138
|
+
*/
|
|
139
|
+
export enum ResourceOperationBeforeTransactionalCoreDisposition {
|
|
140
|
+
CONTINUE = 'continue',
|
|
141
|
+
ALREADY_COMPLETED = 'already_completed',
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
export type ResourceOperationBeforeTransactionalCoreResult =
|
|
145
|
+
| {
|
|
146
|
+
disposition: ResourceOperationBeforeTransactionalCoreDisposition.CONTINUE;
|
|
147
|
+
/** Merged into the core input before the transaction's pristine copy is taken, so every driver retry sees it. */
|
|
148
|
+
coreInputPatch: Record<string, unknown>;
|
|
149
|
+
/** Handed, frozen, to PREFIX/REPLACE/POSTFIX and a conflict resolver as `utils.beforeTransactionalCore.continuation`. */
|
|
150
|
+
continuation: unknown;
|
|
151
|
+
}
|
|
152
|
+
| {
|
|
153
|
+
disposition: ResourceOperationBeforeTransactionalCoreDisposition.ALREADY_COMPLETED;
|
|
154
|
+
};
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
158
|
+
|
|
159
|
+
```typescript
|
|
160
|
+
/**
|
|
161
|
+
* Present only on an operation whose `BEFORE_TRANSACTIONAL_CORE` handler answered `CONTINUE` (#535): the frozen
|
|
162
|
+
* continuation it returned, for the core phases to act on (for example, the claim a PREFIX locks). Absent in the
|
|
163
|
+
* `BEFORE_TRANSACTIONAL_CORE` handler itself.
|
|
164
|
+
*/
|
|
165
|
+
beforeTransactionalCore?: Readonly<{ continuation: unknown }>;
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
169
|
+
|
|
170
|
+
```typescript
|
|
171
|
+
/**
|
|
172
|
+
* Present only when this operation's post-commit effects are owned by the implementation (`IMPLEMENTATION_OUTBOX`),
|
|
173
|
+
* and only in the core phases (#535): what the implementation enqueues in the transaction so the effects survive a
|
|
174
|
+
* crash after commit. See {@link ResourceOperationPostCommitEffectCapture}.
|
|
175
|
+
*/
|
|
176
|
+
postCommitEffectCapture?: ResourceOperationPostCommitEffectCapture;
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
180
|
+
|
|
181
|
+
```typescript
|
|
182
|
+
/**
|
|
183
|
+
* Runs OUTSIDE any database transaction, after preflight and before the transactional core (#535). The phase for an
|
|
184
|
+
* external effect whose outcome feeds the core write. Requires `transactionalCore: true`; exactly one registration
|
|
185
|
+
* may declare it. Handler signature: `(id, input, executionContext, operationPath, utils)`, where `input` is parsed
|
|
186
|
+
* by the operation's request DTO and the answer is a `ResourceOperationBeforeTransactionalCoreResult`.
|
|
187
|
+
*/
|
|
188
|
+
beforeTransactionalCore :
|
|
189
|
+
(
|
|
190
|
+
_id: string | undefined,
|
|
191
|
+
input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.BEFORE_TRANSACTIONAL_CORE, TInput, TOutput>,
|
|
192
|
+
executionContext: ExecutionContext<any>,
|
|
193
|
+
operationPath: ResourceConfiguration_OperationPath<any, any>,
|
|
194
|
+
utils: ResourceOperation_CustomImplementation_Utils
|
|
195
|
+
) =>
|
|
196
|
+
Promise<ResourceOperationBeforeTransactionalCoreResult>;
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
200
|
+
|
|
25
201
|
```typescript
|
|
26
202
|
/**
|
|
27
203
|
* Explicit outcome of a conflict resolver invoked after the owned transaction
|
|
@@ -132,3 +308,34 @@ export type ResourceCustomServiceImplementationTransactionalCoreConfiguration =
|
|
|
132
308
|
transactionalCoreConflictResolver?: never;
|
|
133
309
|
};
|
|
134
310
|
```
|
|
311
|
+
|
|
312
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
313
|
+
|
|
314
|
+
```typescript
|
|
315
|
+
/**
|
|
316
|
+
* Who delivers an operation occurrence's post-commit effects: its resource-operation audit row and its notifications
|
|
317
|
+
* (resource-room broadcast and configured notifications).
|
|
318
|
+
*
|
|
319
|
+
* The framework delivers them after commit on a best-effort basis: a crash between the commit and the effects loses
|
|
320
|
+
* them. An operation whose effects must survive that crash declares `IMPLEMENTATION_OUTBOX` on its custom
|
|
321
|
+
* implementation. The implementation then writes the effects to its own outbox inside the operation's transaction, and
|
|
322
|
+
* the framework does not deliver them itself, so each is delivered once, by the outbox (#535).
|
|
323
|
+
*
|
|
324
|
+
* Reserved for engine-owned writers whose outbox an engine relay delivers. There is no application-facing delivery
|
|
325
|
+
* surface: an application declaring `IMPLEMENTATION_OUTBOX` would suppress its own audit rows and notifications with
|
|
326
|
+
* nothing to deliver them.
|
|
327
|
+
*/
|
|
328
|
+
export enum ResourceOperation_PostCommitEffectOwnership {
|
|
329
|
+
/** The framework emits the audit row and dispatches notifications after commit. The default. */
|
|
330
|
+
FRAMEWORK = "framework",
|
|
331
|
+
/**
|
|
332
|
+
* The custom implementation owns them: it captures their inputs inside the transactional core and enqueues them in
|
|
333
|
+
* that same transaction. The framework suppresses its own emission for the occurrence. Resource post-operation hooks
|
|
334
|
+
* still run and are told the ownership, so a hook whose work the outbox owns can stand down.
|
|
335
|
+
*
|
|
336
|
+
* Requires `transactionalCore: true`, because the enqueue must commit with the change. Refused for an operation that
|
|
337
|
+
* generates a consumable token, because a replayed notification would need the token's secret persisted.
|
|
338
|
+
*/
|
|
339
|
+
IMPLEMENTATION_OUTBOX = "implementation_outbox",
|
|
340
|
+
}
|
|
341
|
+
```
|
|
@@ -64,7 +64,8 @@ Classify → author name → direct the mark → set the visual tone → verify.
|
|
|
64
64
|
|
|
65
65
|
### Step 1: Locate / create the brand snapshot
|
|
66
66
|
|
|
67
|
-
|
|
67
|
+
Current landed value, live: `wildo context info specification-artifacts` (find the `brand-brief`
|
|
68
|
+
family row — landed state, validator verdict, rendered outline).
|
|
68
69
|
Author (or open) `specifications/src/brand/index.ts` — the single
|
|
69
70
|
`BrandSnapshot` instance, wired to the companion via the `brandSpecification`
|
|
70
71
|
slot in `specifications/src/companion-exports.ts` (mirrors how
|
|
@@ -106,6 +107,35 @@ and populates the single source of truth. Consumers (app shell, website, docs,
|
|
|
106
107
|
email, PDF, schema.org) resolve their asset by `(composition, theme)` — no
|
|
107
108
|
per-consumer logo URLs.
|
|
108
109
|
|
|
110
|
+
**Generating is not placing. `wildo brand propagate` is a step you must RUN**, at
|
|
111
|
+
the application root, and nothing runs it for you — not the companion, not
|
|
112
|
+
`wildo config sync`. Until you do, the assets exist only in the source of truth:
|
|
113
|
+
no origin serves the bytes, and the backend's `brandAssets` slot is never
|
|
114
|
+
written, so the surfaces that resolve at runtime resolve nothing.
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
wildo brand propagate --dry-run # prints the whole plan, writes nothing
|
|
118
|
+
wildo brand propagate # apply
|
|
119
|
+
wildo brand propagate --only <key> # one destination
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
It reaches five destinations, and knowing which is which explains what breaks
|
|
123
|
+
when you skip it:
|
|
124
|
+
|
|
125
|
+
| destination | what it does |
|
|
126
|
+
|---|---|
|
|
127
|
+
| `app-public` | copies the bytes into the application's served `public/` |
|
|
128
|
+
| `website-public` | the marketing site's served assets |
|
|
129
|
+
| `website-og` | the marketing site's social-preview images |
|
|
130
|
+
| `technical-doc-static` | the documentation site's static assets |
|
|
131
|
+
| `runtime-app-config` | **not a file copy** — stamps the runtime projection into a generated module the backend config composes into its `brandAssets` slot |
|
|
132
|
+
|
|
133
|
+
That last row is the one to remember: the BACKEND consumers — organization
|
|
134
|
+
branding on the auth response, and the email primary-scope context — resolve from
|
|
135
|
+
`config.brandAssets`, so they depend on `runtime-app-config` having run. An
|
|
136
|
+
authored brief with no propagation gives an application logo-less emails while
|
|
137
|
+
every file on disk looks correct.
|
|
138
|
+
|
|
109
139
|
## Worked Example
|
|
110
140
|
|
|
111
141
|
An application-owned `BrandSnapshot` is the preferred live reference once it
|
|
@@ -67,11 +67,10 @@ they never reach for a favicon slot as an in-app UI mark.
|
|
|
67
67
|
* fact and `purpose` is a CONSUMPTION fact: they coincide for `MASTER` in
|
|
68
68
|
* the normal pipeline, but a brand whose derivation degraded ships its
|
|
69
69
|
* generated primary AT `PRIMARY`, so the two must not be conflated.
|
|
70
|
-
* - **`generatedAt`**
|
|
71
|
-
*
|
|
72
|
-
* regeneration
|
|
73
|
-
*
|
|
74
|
-
* the i18n-labelling step).
|
|
70
|
+
* - **`generatedAt`** — when it was produced. The validator flags assets
|
|
71
|
+
* older than a re-authored direction from this timestamp (`STALE_ASSETS`).
|
|
72
|
+
* Skipping regeneration is the companion's own throwaway-staging concern
|
|
73
|
+
* and records nothing on the committed asset.
|
|
75
74
|
*/
|
|
76
75
|
export enum BrandAssetComposition {
|
|
77
76
|
/** The symbol/icon alone — square-ish; favicons, app icons, sidebar rail. */
|
|
@@ -145,15 +144,15 @@ export const BrandAssetConfigSchema = z.object({
|
|
|
145
144
|
/** Stable kebab-case identity, unique within `resolvedAssets`. `derivedFrom` addresses it. */
|
|
146
145
|
ref: NonEmptyStringSchema,
|
|
147
146
|
/** The FORM axis — symbol, wordmark, or locked-up. */
|
|
148
|
-
composition: z.enum(BrandAssetComposition),
|
|
147
|
+
composition: z.enum(BrandAssetComposition).systemEnum('BrandAssetComposition'),
|
|
149
148
|
/** The color-context axis. Defaults to the intended full-color mark. */
|
|
150
|
-
theme: z.enum(BrandAssetTheme).default(BrandAssetTheme.DEFAULT),
|
|
149
|
+
theme: z.enum(BrandAssetTheme).systemEnum('BrandAssetTheme').default(BrandAssetTheme.DEFAULT),
|
|
151
150
|
/** The technical consumption axis. Defaults to the base DISPLAY form, never the `MASTER` source. */
|
|
152
|
-
purpose: z.enum(BrandAssetPurpose).default(BrandAssetPurpose.PRIMARY),
|
|
151
|
+
purpose: z.enum(BrandAssetPurpose).systemEnum('BrandAssetPurpose').default(BrandAssetPurpose.PRIMARY),
|
|
153
152
|
/** `APPLICATION`-scoped stored-file reference (never a loose CDN URL). */
|
|
154
153
|
storageRef: NonEmptyStringSchema,
|
|
155
154
|
/** Concrete file format. */
|
|
156
|
-
format: z.enum(BrandAssetFormat),
|
|
155
|
+
format: z.enum(BrandAssetFormat).systemEnum('BrandAssetFormat'),
|
|
157
156
|
/** Pixel width (undefined for scalable SVG). */
|
|
158
157
|
width: z.number().int().positive().optional(),
|
|
159
158
|
/** Pixel height (undefined for scalable SVG). */
|
|
@@ -166,13 +165,6 @@ export const BrandAssetConfigSchema = z.object({
|
|
|
166
165
|
derivedFrom: NonEmptyStringSchema.optional(),
|
|
167
166
|
/** ISO-8601 timestamp the asset was produced. */
|
|
168
167
|
generatedAt: z.iso.datetime(),
|
|
169
|
-
/**
|
|
170
|
-
* Stable digest of the generation inputs (brand direction + tone +
|
|
171
|
-
* enrichment). Lets the companion skip regeneration when nothing
|
|
172
|
-
* upstream changed, and lets the validator flag assets older than a
|
|
173
|
-
* re-authored direction — freshness-lock parity with i18n-labelling.
|
|
174
|
-
*/
|
|
175
|
-
promptDigest: NonEmptyStringSchema.optional(),
|
|
176
168
|
});
|
|
177
169
|
export type BrandAssetConfig = z.infer<typeof BrandAssetConfigSchema>;
|
|
178
170
|
```
|
package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md
CHANGED
|
@@ -33,8 +33,16 @@ export enum BrandSnapshotVersion {
|
|
|
33
33
|
* exactly one brand identity per application. It is the visual-identity
|
|
34
34
|
* definition artifact the app-creation top-down catalog reads/writes,
|
|
35
35
|
* and — via `resolvedAssets` — the **single source of truth for every
|
|
36
|
-
* logo/favicon/brand-image consumer in the app**
|
|
37
|
-
*
|
|
36
|
+
* logo/favicon/brand-image consumer in the app** that is actually wired:
|
|
37
|
+
* the app shell, the website, the docs site, the website OG image, and the
|
|
38
|
+
* backend runtime configuration that transactional email resolves its logo
|
|
39
|
+
* from.
|
|
40
|
+
*
|
|
41
|
+
* PDF templates and schema.org are NOT among them. The pdf-templates tree
|
|
42
|
+
* contains no brand or logo reference at all, and the website's structured-data
|
|
43
|
+
* payloads are authored by each section's `getStructuredData()` hook rather than
|
|
44
|
+
* resolved from here. Both would arrive as new propagation destinations; until
|
|
45
|
+
* they do, a PDF or a JSON-LD payload that needs the mark carries it by hand.
|
|
38
46
|
*
|
|
39
47
|
* **Artifact-family id: `brand-brief`.** This schema is the shape of the
|
|
40
48
|
* journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===
|
|
@@ -72,6 +80,12 @@ export const BrandSnapshotSchema = z.object({
|
|
|
72
80
|
logoDirection: BrandLogoDirectionConfigSchema.optional(),
|
|
73
81
|
/** The visual aesthetic register — elicited progressively; WARNed when absent. */
|
|
74
82
|
visualTone: BrandVisualToneConfigSchema.optional(),
|
|
83
|
+
/**
|
|
84
|
+
* WHO the brand is for: the market ICPs (`targetIcpRefs`) its name and tone were chosen to speak to
|
|
85
|
+
* (#1424). Optional, like the two directions — a brand elicited before its market exists has none —
|
|
86
|
+
* and cross-checked against the market by the coherence report, which reports a ref naming no ICP.
|
|
87
|
+
*/
|
|
88
|
+
audience: BrandAudienceConfigSchema.optional(),
|
|
75
89
|
/**
|
|
76
90
|
* The generated + derived assets, each described by the three
|
|
77
91
|
* orthogonal axes (composition × theme × purpose). Populated by the
|
|
@@ -166,8 +180,9 @@ export type BrandNameConfig = z.infer<typeof BrandNameConfigSchema>;
|
|
|
166
180
|
* `gpt-image` output usable.
|
|
167
181
|
* - **`backgroundTreatment`** — how the master must be composed so the
|
|
168
182
|
* Layer-4 derivations (favicon/mono/dark-light) are clean. Defaults
|
|
169
|
-
* to a transparent isolated mark
|
|
170
|
-
*
|
|
183
|
+
* to a transparent isolated mark so derived assets do not inherit an unwanted
|
|
184
|
+
* background. Raster resolution and the target role still constrain usable size
|
|
185
|
+
* and detail; transparency does not make enlargement lossless.
|
|
171
186
|
*/
|
|
172
187
|
export enum BrandLogoMarkType {
|
|
173
188
|
/** Text-only, styled name (e.g. "Google"). */
|
|
@@ -188,9 +203,10 @@ export enum BrandLogoMarkType {
|
|
|
188
203
|
|
|
189
204
|
/**
|
|
190
205
|
* How the master logo raster must be composed. Only `TRANSPARENT_ISOLATED`
|
|
191
|
-
*
|
|
192
|
-
* monochrome, dark/light)
|
|
193
|
-
*
|
|
206
|
+
* provides a background-free starting point for Layer-4 derivations (favicon,
|
|
207
|
+
* maskable, monochrome, dark/light). Each role still needs suitable resolution
|
|
208
|
+
* and composition; the raster master is not a resolution-independent vector.
|
|
209
|
+
* Other treatments require background handling and are WARNed by the validator.
|
|
194
210
|
*/
|
|
195
211
|
export enum BrandLogoBackgroundTreatment {
|
|
196
212
|
/** Mark isolated on a transparent canvas. The clean default. */
|
|
@@ -203,7 +219,7 @@ export enum BrandLogoBackgroundTreatment {
|
|
|
203
219
|
|
|
204
220
|
export const BrandLogoDirectionConfigSchema = z.object({
|
|
205
221
|
/** Which of the seven canonical mark archetypes to render. */
|
|
206
|
-
markType: z.enum(BrandLogoMarkType),
|
|
222
|
+
markType: z.enum(BrandLogoMarkType).systemEnum('BrandLogoMarkType'),
|
|
207
223
|
/** Concrete visual elements to include — short noun phrases, not sentences. */
|
|
208
224
|
motifs: z.array(NonEmptyStringSchema).default([]),
|
|
209
225
|
/** The meaning the mark should evoke, derived from mission/idea. */
|
|
@@ -212,7 +228,7 @@ export const BrandLogoDirectionConfigSchema = z.object({
|
|
|
212
228
|
avoid: z.array(NonEmptyStringSchema).default([]),
|
|
213
229
|
/** How the master raster is composed so derivations stay clean. */
|
|
214
230
|
backgroundTreatment: z
|
|
215
|
-
.enum(BrandLogoBackgroundTreatment)
|
|
231
|
+
.enum(BrandLogoBackgroundTreatment).systemEnum('BrandLogoBackgroundTreatment')
|
|
216
232
|
.default(BrandLogoBackgroundTreatment.TRANSPARENT_ISOLATED),
|
|
217
233
|
/** Optional per-entity authoring provenance. */
|
|
218
234
|
authored: BrandAuthoredMetadataSchema.optional(),
|