@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# saas.backend.authorization.role-ceiling
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Role-ceiling gate — a principal may only grant roles it itself holds.
|
|
14
|
+
*
|
|
15
|
+
* WHY THIS EXISTS. Several resources carry a caller-settable `roles` array that becomes a principal's
|
|
16
|
+
* live authority. Two families:
|
|
17
|
+
*
|
|
18
|
+
* - **Machine credentials** (`organizationOAuthClients` / `applicationOAuthClients` and their api-key
|
|
19
|
+
* twins): the roles written at CREATE are exactly the roles every token minted for that client/key
|
|
20
|
+
* carries at the request-auth choke point (`oauth-provider-token` → `machine-token-issuer`).
|
|
21
|
+
* - **Organization membership** (`organizationMembers.roles`, and the per-unit roles nested in
|
|
22
|
+
* `organizationUnitsMembership`): a membership row's `roles` array is read verbatim by
|
|
23
|
+
* `execution-context-creator` to build `initiatorRoles` — the member's live authority on their very
|
|
24
|
+
* next request.
|
|
25
|
+
*
|
|
26
|
+
* The operation-authorization layer only checks whether the CALLER may run the write at all — it never
|
|
27
|
+
* compares the *requested* roles against the caller's own. Without this gate an `ORG_ADMIN` (the gate
|
|
28
|
+
* for both member UPDATE and org-client CREATE) could grant `ORG_OWNER` to themselves, or mint a
|
|
29
|
+
* credential carrying `APP_ADMIN_SUPER_ADMIN`. This is the missing "you cannot grant authority you do
|
|
30
|
+
* not hold" check.
|
|
31
|
+
*
|
|
32
|
+
* SEMANTICS. Every requested role must lie within the caller's EFFECTIVE authority — the union of the
|
|
33
|
+
* `inheritFrom` hierarchies of the roles the caller actually holds, each expanded within the scope of
|
|
34
|
+
* the membership that granted it. Hierarchy-awareness is not a convenience: with the default table
|
|
35
|
+
* (`ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`) an `ORG_ADMIN`'s membership row
|
|
36
|
+
* holds the literal string `ORG_ADMIN` and nothing else, so a raw set-membership test would reject
|
|
37
|
+
* that admin granting the DEFAULT `ORG_MEMBER` role and break the entire invite flow — while still
|
|
38
|
+
* correctly rejecting a grant of `ORG_OWNER`, which is UPSTREAM of the caller and therefore outside
|
|
39
|
+
* the expansion.
|
|
40
|
+
*
|
|
41
|
+
* Fail-closed: a caller whose roles cannot be resolved is treated as holding none, so any requested
|
|
42
|
+
* role is rejected.
|
|
43
|
+
*
|
|
44
|
+
* TWO DELIBERATE BYPASSES:
|
|
45
|
+
* - **Platform super-admin** — a caller holding `APP_ADMIN_SUPER_ADMIN` *at APPLICATION scope* may
|
|
46
|
+
* assign any role (that role IS the top of the ceiling). This also cleanly covers the cross-tenant
|
|
47
|
+
* `admin` operation variant of the machine-credential resources, which is itself gated by
|
|
48
|
+
* `APP_ADMIN_SUPER_ADMIN` and is meant to provision clients "for any org" — so no separate
|
|
49
|
+
* variant-detection is needed. The scope qualifier is load-bearing: `roles` on a membership row is
|
|
50
|
+
* a free-form string (`OrgRolesSchema` admits any `z.string().min(1)`), so without it a tenant
|
|
51
|
+
* admin who wrote the literal text `APP_ADMIN_SUPER_ADMIN` into an ORGANIZATIONS-scoped membership
|
|
52
|
+
* would unlock this bypass. The authorization layer already refuses to honour that string
|
|
53
|
+
* cross-scope (`getRoleHierarchy` partitions the two role tables); this gate must not be the
|
|
54
|
+
* weaker link.
|
|
55
|
+
* - **System / internal writes** — an `INTERNALLY_INITIATED_REQUEST` execution (seeds, provisioning,
|
|
56
|
+
* `createAsSystem`) is the framework itself, not a user principal (it synthesises a super-admin
|
|
57
|
+
* system EC), and carries no human ceiling — it is trusted to assign any role.
|
|
58
|
+
*
|
|
59
|
+
* SCOPE OF THE COMPARISON. The caller's effective roles are unioned across every membership they
|
|
60
|
+
* hold, without checking that the granting membership targets the same organization as the write.
|
|
61
|
+
* That is deliberate and safe HERE because the operation-authorization layer has already confined the
|
|
62
|
+
* write to a scope the caller may act in (`authorizeOrganizations` / the parent-scope filter); this
|
|
63
|
+
* gate answers "how high", not "where". A future units-aware authorization axis that narrows *within*
|
|
64
|
+
* an organization must revisit that assumption.
|
|
65
|
+
*
|
|
66
|
+
* EXTENDING. Wire this into the CREATE (and any roles-mutating UPDATE) path of ANY resource whose
|
|
67
|
+
* `roles` field is caller-settable, passing the roles AS AUTHORED BY THE CALLER — not the
|
|
68
|
+
* post-resolution set. Framework-injected defaults (e.g. an organization type's `defaultMemberRole`)
|
|
69
|
+
* are policy-derived, not a caller request, and must not be measured against the caller's ceiling.
|
|
70
|
+
*
|
|
71
|
+
* THE REFUSAL IS RECORDED — as a `RESOURCE_OPERATION_DENIED` audit event with
|
|
72
|
+
* `denialReason: role_ceiling_exceeded`, carrying the roles that were refused. A privilege-escalation
|
|
73
|
+
* attempt is the single refusal an access review most wants to see.
|
|
74
|
+
*
|
|
75
|
+
* Read the trail as the same DEDUPLICATED stream every other authorization refusal uses, not as one
|
|
76
|
+
* row per attempt: repeats by the same principal against the same operation are collapsed within a
|
|
77
|
+
* window and re-emitted at escalation checkpoints, each row carrying `occurrenceCount`. So a burst of
|
|
78
|
+
* attempts is visible as a burst — count with `occurrenceCount`, never by counting rows.
|
|
79
|
+
*
|
|
80
|
+
* Recording can never fail the request it observes. If the record is lost, that loss is itself
|
|
81
|
+
* counted (`audit_observation_dropped_total`, observation `authorization_denial`).
|
|
82
|
+
*
|
|
83
|
+
* assurance-control: WILDO.ACCESS.LEAST_PRIVILEGE — prevents a principal from granting authority it
|
|
84
|
+
* does not itself hold. The denial is an access-control decision, and it is recorded.
|
|
85
|
+
*
|
|
86
|
+
```
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# saas.backend.billing.catalog-sync-result
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Result of `ProductCatalogSyncBackendService.syncProductCatalog()`, exported from
|
|
14
|
+
* `@wildo-ai/saas-backend-lib`. Inspect errors even when the call returns normally: a complete
|
|
15
|
+
* pass reports individual failures alongside successful changes. `retired` records local
|
|
16
|
+
* deactivation, not provider archiving. `retiredWithLiveSubscribers` identifies customer decisions
|
|
17
|
+
* still owed; synchronization neither migrates nor cancels those subscriptions.
|
|
18
|
+
*/
|
|
19
|
+
export interface ProductCatalogSyncResult {
|
|
20
|
+
synced: number;
|
|
21
|
+
created: number;
|
|
22
|
+
updated: number;
|
|
23
|
+
featuresDirty: string[];
|
|
24
|
+
/**
|
|
25
|
+
* Keys that exist in the DATABASE and no longer in the code catalogue, and were soft-retired by
|
|
26
|
+
* this run (`isActive: false` on the product and every one of its prices).
|
|
27
|
+
*/
|
|
28
|
+
retired: string[];
|
|
29
|
+
/**
|
|
30
|
+
* Retired keys that STILL HAVE LIVE SUBSCRIBERS. Reported, never acted on — see
|
|
31
|
+
* {@link ProductCatalogSyncBackendService.reconcileRetiredProducts} for why the framework refuses
|
|
32
|
+
* to decide what happens to those customers.
|
|
33
|
+
*/
|
|
34
|
+
retiredWithLiveSubscribers: Array<{ productKey: string; liveSubscriptions: number }>;
|
|
35
|
+
errors: string[];
|
|
36
|
+
}
|
|
37
|
+
```
|
|
@@ -19,9 +19,10 @@
|
|
|
19
19
|
* Read this as a debugging map — the fatal startup message names the surface,
|
|
20
20
|
* and each reason below is the surface:
|
|
21
21
|
* - PROVIDER_REF_UNSET → `billing.providerRef` in `./backend-api/src/saas-config.backend.ts`
|
|
22
|
-
* - PROVIDER_NOT_REACHABLE_ON_BACKEND → author the ref under `providers.scopes.backend` in `./wildo.saas.config.ts`
|
|
22
|
+
* - PROVIDER_NOT_REACHABLE_ON_BACKEND → author the ref under `providers.scopes.backend` in `./wildo.saas.config.ts` (the classic trap: authored only in a frontend scope), then `wildo config sync`. An engine-shipped or package-shipped provider needs NO hand-authored contribution: discovery reads the provider package's own `./companion` barrel and derives the backend target from that scope
|
|
23
23
|
* - PROVIDER_DISABLED → the ref resolves but is disabled for the BILLING protocol in external-provider config
|
|
24
24
|
* - SECRET_MISSING → the env var named by the provider's `secretRef` is absent from the per-env `providerEnv` secrets
|
|
25
|
+
* - NO_ADAPTER_FOR_SDK_PACKAGE → the engine ships no billing adapter for the `sdkPackage` the provider declares. The one reason here that is NOT a config surface — no application edit fixes it
|
|
25
26
|
* - RESOLUTION_ERROR → the provider threw while resolving (registry / billing-SDK fault)
|
|
26
27
|
*/
|
|
27
28
|
enum BillingProviderResolutionFailureReason {
|
|
@@ -29,16 +30,34 @@ enum BillingProviderResolutionFailureReason {
|
|
|
29
30
|
PROVIDER_REF_UNSET = 'provider-ref-unset',
|
|
30
31
|
/**
|
|
31
32
|
* `providerRef` is set, but no billing runtime contract is exposed to the
|
|
32
|
-
* backend registry for it — the provider is not
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
33
|
+
* backend registry for it — the provider is not in the generated
|
|
34
|
+
* provider-runtime artifact this host loads, so it was filtered out of the
|
|
35
|
+
* active catalog.
|
|
36
|
+
*
|
|
37
|
+
* Almost always one of two things: the ref is not authored under
|
|
38
|
+
* `providers.scopes.backend` (the common trap — it is authored only in a
|
|
39
|
+
* frontend scope), or the artifact has not been regenerated since it was.
|
|
40
|
+
*
|
|
41
|
+
* A ref that is scoped but that discovery cannot supply for this runtime is
|
|
42
|
+
* NOT this reason: `validateDiscoveredSaasProviderContributions` refuses that
|
|
43
|
+
* at `wildo config sync`, naming the scope, long before a boot.
|
|
36
44
|
*/
|
|
37
45
|
PROVIDER_NOT_REACHABLE_ON_BACKEND = 'provider-not-reachable-on-backend',
|
|
38
46
|
/** The provider resolves but is disabled by external-provider configuration. */
|
|
39
47
|
PROVIDER_DISABLED = 'provider-disabled',
|
|
40
48
|
/** The provider resolves but its secret (env var `secretRef`) is absent. */
|
|
41
49
|
SECRET_MISSING = 'secret-missing',
|
|
50
|
+
/**
|
|
51
|
+
* The provider is reachable, enabled and holds its secret, but the engine ships no billing
|
|
52
|
+
* adapter for the `sdkPackage` its runtime contract declares.
|
|
53
|
+
*
|
|
54
|
+
* This is a FRAMEWORK gap rather than an application misconfiguration — the only one of these
|
|
55
|
+
* reasons the operator cannot fix by editing config — and it exists so that state is stated.
|
|
56
|
+
* Until this reason existed, that configuration silently received Stripe's adapter built over
|
|
57
|
+
* the other provider's secret, because the resolution narrowed on the protocol `kind` and then
|
|
58
|
+
* constructed one named class. `detail` carries the unserved `sdkPackage`.
|
|
59
|
+
*/
|
|
60
|
+
NO_ADAPTER_FOR_SDK_PACKAGE = 'no-adapter-for-sdk-package',
|
|
42
61
|
/** An unexpected error was thrown while resolving (registry/SDK fault). */
|
|
43
62
|
RESOLUTION_ERROR = 'resolution-error',
|
|
44
63
|
}
|
|
@@ -3,11 +3,167 @@
|
|
|
3
3
|
## Import Origins
|
|
4
4
|
|
|
5
5
|
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
- `@wildo-ai/saas-models`
|
|
6
7
|
|
|
7
8
|
## Source Excerpts
|
|
8
9
|
|
|
9
10
|
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
11
|
|
|
12
|
+
```typescript
|
|
13
|
+
/**
|
|
14
|
+
* The attribution and scope of a committed operation occurrence, persisted so an effect delivered later — by an outbox
|
|
15
|
+
* relay, possibly in another process — runs under the principal that performed the operation (#535).
|
|
16
|
+
*
|
|
17
|
+
* JSON-safe by construction. The framework's replay rebuilds the context from it with every principal-category validation
|
|
18
|
+
* re-run, inside the original request frame, so the rebuilt context — and every log line and audit row it produces —
|
|
19
|
+
* carries the original request's correlation id instead of a fresh one.
|
|
20
|
+
*
|
|
21
|
+
* SECURITY: persist it only in a server-owned row written in the operation's own transaction. It is not an
|
|
22
|
+
* authentication input; nothing a client authored may ever reach a replay.
|
|
23
|
+
*/
|
|
24
|
+
export interface ResourceOperationDeferredEffectContext {
|
|
25
|
+
/** The variant-resolved operation's path, which the replay resolves back to the operation. */
|
|
26
|
+
operationPath: {
|
|
27
|
+
resourceIdentifier: string;
|
|
28
|
+
operationIdentifier: string;
|
|
29
|
+
variantType: ResourceOperationVariantType;
|
|
30
|
+
variantKey?: string;
|
|
31
|
+
isOperationDefault?: boolean;
|
|
32
|
+
isBulkOperation?: boolean;
|
|
33
|
+
};
|
|
34
|
+
executionType: ExecutionContext_ExecutionType;
|
|
35
|
+
initiatorIds: ExecutionContext_InitiatorIds | null;
|
|
36
|
+
initiatorRoles: ExecutionContext_RoleInfo[];
|
|
37
|
+
relationshipContexts: ExecutionContext_RelationshipContext[];
|
|
38
|
+
/**
|
|
39
|
+
* The context's scope map as a record. A multi-valued entry stays an array — deliberately unlike the queue serializer's
|
|
40
|
+
* reconstruction, which keeps only the first value and would narrow the replay's scope.
|
|
41
|
+
*/
|
|
42
|
+
contextResourceIds: Record<string, string | string[]>;
|
|
43
|
+
auditActorUserId?: string;
|
|
44
|
+
requestFrame: { correlationId: string; frontendServiceName?: string; clientInstanceId?: string };
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* The inputs the notification phases read, captured from the committed attempt. JSON-safe: a `Date` arrives at the replay
|
|
49
|
+
* as its ISO string and a `bigint` as its decimal string, which is what the row's persisted form already carries.
|
|
50
|
+
*/
|
|
51
|
+
export interface ResourceOperationNotificationEffectInputs {
|
|
52
|
+
inputDto: unknown;
|
|
53
|
+
currentObject: unknown;
|
|
54
|
+
/** The attempt's prior row, or compact multi-id owner snapshots, for derived-badge recomputation. */
|
|
55
|
+
previousObject: unknown;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* What an implementation that owns its post-commit effects (`IMPLEMENTATION_OUTBOX`) captures inside the transactional
|
|
60
|
+
* core, so it can enqueue them in the same transaction and have them delivered later exactly as the framework would
|
|
61
|
+
* have delivered them (#535).
|
|
62
|
+
*
|
|
63
|
+
* Present on `utils` only under that ownership, and only in the core phases (PREFIX, REPLACE, POSTFIX), because only
|
|
64
|
+
* there does an enqueue share the commit. Each method answers from the CURRENT attempt, so a database-driver retry
|
|
65
|
+
* never enqueues what an aborted attempt saw.
|
|
66
|
+
*/
|
|
67
|
+
export interface ResourceOperationPostCommitEffectCapture {
|
|
68
|
+
/**
|
|
69
|
+
* The resource-operation audit record for `postOperationState`, or `null` when the operation is below the audit floor.
|
|
70
|
+
* Built by the same preparation as the framework's own emission, with one deliberate difference: its pre-image is the
|
|
71
|
+
* row THIS attempt read inside its transaction, where the framework's emission uses the row read before the transaction
|
|
72
|
+
* opened. Under a concurrent writer the two can disagree on `before` values, and this one is the accurate one.
|
|
73
|
+
*/
|
|
74
|
+
prepareAudit(postOperationState: unknown): ResourceOperationPerformedAuditData | null;
|
|
75
|
+
/** The occurrence's attribution, scope and request frame. */
|
|
76
|
+
deferredContext(): ResourceOperationDeferredEffectContext;
|
|
77
|
+
/** The notification phases' inputs for `postOperationState`. */
|
|
78
|
+
notificationInputs(postOperationState: unknown): ResourceOperationNotificationEffectInputs;
|
|
79
|
+
}
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
83
|
+
|
|
84
|
+
```typescript
|
|
85
|
+
/**
|
|
86
|
+
* What a `BEFORE_TRANSACTIONAL_CORE` handler decided (#535).
|
|
87
|
+
*
|
|
88
|
+
* `CONTINUE` runs the operation's transactional core with `coreInputPatch` merged into its input; the core phases read
|
|
89
|
+
* `continuation` from `utils.beforeTransactionalCore`. The patch's keys are server-owned for the whole core phase: their
|
|
90
|
+
* value after PREFIX persists, even for a field the request DTO seals.
|
|
91
|
+
*
|
|
92
|
+
* `ALREADY_COMPLETED` means an earlier request already committed this operation's effect. The framework skips core
|
|
93
|
+
* persistence, managed post-commit effects (so no second audit row) and token consumption; it applies the synchronous
|
|
94
|
+
* terminal result transforms, as it does for a reconciled conflict winner, and answers the target's CURRENT stored state
|
|
95
|
+
* through the operation's output transform. Two consequences of answering from stored state:
|
|
96
|
+
* - a DELETE replay answers `null`, because the row is gone (the original request answered the deleted state);
|
|
97
|
+
* - terminal transforms see the stored, POST-change row as `utils.currentObject`, not the pre-change row.
|
|
98
|
+
* It is refused without a single explicit target (a CREATE or a filter target; a bulk operation never reaches this
|
|
99
|
+
* point) and when a consumable token is presented.
|
|
100
|
+
*
|
|
101
|
+
* The phase as a whole is refused, before the handler runs, on a bulk operation, on a non-object input, on a missing
|
|
102
|
+
* explicit target, and on a caller's change to a read-only field — every refusal that does not depend on the handler's
|
|
103
|
+
* answer comes first, so a refused call never leaves an external effect behind.
|
|
104
|
+
*/
|
|
105
|
+
export enum ResourceOperationBeforeTransactionalCoreDisposition {
|
|
106
|
+
CONTINUE = 'continue',
|
|
107
|
+
ALREADY_COMPLETED = 'already_completed',
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
export type ResourceOperationBeforeTransactionalCoreResult =
|
|
111
|
+
| {
|
|
112
|
+
disposition: ResourceOperationBeforeTransactionalCoreDisposition.CONTINUE;
|
|
113
|
+
/** Merged into the core input before the transaction's pristine copy is taken, so every driver retry sees it. */
|
|
114
|
+
coreInputPatch: Record<string, unknown>;
|
|
115
|
+
/** Handed, frozen, to PREFIX/REPLACE/POSTFIX and a conflict resolver as `utils.beforeTransactionalCore.continuation`. */
|
|
116
|
+
continuation: unknown;
|
|
117
|
+
}
|
|
118
|
+
| {
|
|
119
|
+
disposition: ResourceOperationBeforeTransactionalCoreDisposition.ALREADY_COMPLETED;
|
|
120
|
+
};
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
124
|
+
|
|
125
|
+
```typescript
|
|
126
|
+
/**
|
|
127
|
+
* Present only on an operation whose `BEFORE_TRANSACTIONAL_CORE` handler answered `CONTINUE` (#535): the frozen
|
|
128
|
+
* continuation it returned, for the core phases to act on (for example, the claim a PREFIX locks). Absent in the
|
|
129
|
+
* `BEFORE_TRANSACTIONAL_CORE` handler itself.
|
|
130
|
+
*/
|
|
131
|
+
beforeTransactionalCore?: Readonly<{ continuation: unknown }>;
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
135
|
+
|
|
136
|
+
```typescript
|
|
137
|
+
/**
|
|
138
|
+
* Present only when this operation's post-commit effects are owned by the implementation (`IMPLEMENTATION_OUTBOX`),
|
|
139
|
+
* and only in the core phases (#535): what the implementation enqueues in the transaction so the effects survive a
|
|
140
|
+
* crash after commit. See {@link ResourceOperationPostCommitEffectCapture}.
|
|
141
|
+
*/
|
|
142
|
+
postCommitEffectCapture?: ResourceOperationPostCommitEffectCapture;
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
146
|
+
|
|
147
|
+
```typescript
|
|
148
|
+
/**
|
|
149
|
+
* Runs OUTSIDE any database transaction, after preflight and before the transactional core (#535). The phase for an
|
|
150
|
+
* external effect whose outcome feeds the core write. Requires `transactionalCore: true`; exactly one registration
|
|
151
|
+
* may declare it. Handler signature: `(id, input, executionContext, operationPath, utils)`, where `input` is parsed
|
|
152
|
+
* by the operation's request DTO and the answer is a `ResourceOperationBeforeTransactionalCoreResult`.
|
|
153
|
+
*/
|
|
154
|
+
beforeTransactionalCore :
|
|
155
|
+
(
|
|
156
|
+
_id: string | undefined,
|
|
157
|
+
input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.BEFORE_TRANSACTIONAL_CORE, TInput, TOutput>,
|
|
158
|
+
executionContext: ExecutionContext<any>,
|
|
159
|
+
operationPath: ResourceConfiguration_OperationPath<any, any>,
|
|
160
|
+
utils: ResourceOperation_CustomImplementation_Utils
|
|
161
|
+
) =>
|
|
162
|
+
Promise<ResourceOperationBeforeTransactionalCoreResult>;
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
166
|
+
|
|
11
167
|
```typescript
|
|
12
168
|
/**
|
|
13
169
|
* Explicit outcome of a conflict resolver invoked after the owned transaction
|
|
@@ -118,3 +274,34 @@ export type ResourceCustomServiceImplementationTransactionalCoreConfiguration =
|
|
|
118
274
|
transactionalCoreConflictResolver?: never;
|
|
119
275
|
};
|
|
120
276
|
```
|
|
277
|
+
|
|
278
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
279
|
+
|
|
280
|
+
```typescript
|
|
281
|
+
/**
|
|
282
|
+
* Who delivers an operation occurrence's post-commit effects: its resource-operation audit row and its notifications
|
|
283
|
+
* (resource-room broadcast and configured notifications).
|
|
284
|
+
*
|
|
285
|
+
* The framework delivers them after commit on a best-effort basis: a crash between the commit and the effects loses
|
|
286
|
+
* them. An operation whose effects must survive that crash declares `IMPLEMENTATION_OUTBOX` on its custom
|
|
287
|
+
* implementation. The implementation then writes the effects to its own outbox inside the operation's transaction, and
|
|
288
|
+
* the framework does not deliver them itself, so each is delivered once, by the outbox (#535).
|
|
289
|
+
*
|
|
290
|
+
* Reserved for engine-owned writers whose outbox an engine relay delivers. There is no application-facing delivery
|
|
291
|
+
* surface: an application declaring `IMPLEMENTATION_OUTBOX` would suppress its own audit rows and notifications with
|
|
292
|
+
* nothing to deliver them.
|
|
293
|
+
*/
|
|
294
|
+
export enum ResourceOperation_PostCommitEffectOwnership {
|
|
295
|
+
/** The framework emits the audit row and dispatches notifications after commit. The default. */
|
|
296
|
+
FRAMEWORK = "framework",
|
|
297
|
+
/**
|
|
298
|
+
* The custom implementation owns them: it captures their inputs inside the transactional core and enqueues them in
|
|
299
|
+
* that same transaction. The framework suppresses its own emission for the occurrence. Resource post-operation hooks
|
|
300
|
+
* still run and are told the ownership, so a hook whose work the outbox owns can stand down.
|
|
301
|
+
*
|
|
302
|
+
* Requires `transactionalCore: true`, because the enqueue must commit with the change. Refused for an operation that
|
|
303
|
+
* generates a consumable token, because a replayed notification would need the token's secret persisted.
|
|
304
|
+
*/
|
|
305
|
+
IMPLEMENTATION_OUTBOX = "implementation_outbox",
|
|
306
|
+
}
|
|
307
|
+
```
|
|
@@ -71,7 +71,7 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
71
71
|
* Aggregated by {@link mergeBackendDomainModules} into a single
|
|
72
72
|
* `Record<string, DataSeedScopeResolver>` and threaded through
|
|
73
73
|
* `ApplicationInitializationConfig.dataSeedScopeResolvers`. The
|
|
74
|
-
* data-seeding bootstrap (`
|
|
74
|
+
* data-seeding bootstrap (`wireDataSeedingDeclarations`) hands
|
|
75
75
|
* the merged map to
|
|
76
76
|
* {@link DataSeedScopeResolverRegistryBackendService.registerResolvers}
|
|
77
77
|
* once per boot.
|
|
@@ -84,6 +84,30 @@ export interface BackendDomainModule extends SharedDomainModule {
|
|
|
84
84
|
dataSeedScopeResolvers?: Record<string, DataSeedScopeResolver>;
|
|
85
85
|
}
|
|
86
86
|
|
|
87
|
+
/**
|
|
88
|
+
* Merge every module's backend contributions into one.
|
|
89
|
+
*
|
|
90
|
+
* ⚠️ **The fields do NOT all treat a cross-module duplicate the same way, and the difference is
|
|
91
|
+
* silent.** Three of them reject a duplicate at merge time with a `CONFIGURATION` error naming both
|
|
92
|
+
* contributors — `dataSeedScopeResolvers`, `pdfTemplateBindings` and `chartDefinitions`. Two of them
|
|
93
|
+
* do not:
|
|
94
|
+
*
|
|
95
|
+
* | field | duplicate across two modules |
|
|
96
|
+
* |---|---|
|
|
97
|
+
* | `resourceConfigurations` | **last module wins, silently** |
|
|
98
|
+
* | `resourceFieldIdentifiers` | **last module wins, silently** |
|
|
99
|
+
* | `dataSeedScopeResolvers` · `pdfTemplateBindings` · `chartDefinitions` | rejected, naming both modules |
|
|
100
|
+
* | `resourceRelationships` · `operations` · `controllers` · `seeds` | concatenated — both are kept |
|
|
101
|
+
*
|
|
102
|
+
* Do not generalise the rejection to the whole object. Two modules declaring the same resource
|
|
103
|
+
* identifier produce no error and no warning: whichever is later in the registry array replaces the
|
|
104
|
+
* earlier one entirely, and the application boots. That shadowing is what lets an application layer
|
|
105
|
+
* its own module over the engine's, so it cannot be made an error — which is exactly why an
|
|
106
|
+
* ACCIDENTAL collision is invisible.
|
|
107
|
+
*
|
|
108
|
+
* If a resource behaves as though its configuration were somebody else's, check for a second module
|
|
109
|
+
* declaring the same identifier before looking anywhere else.
|
|
110
|
+
*/
|
|
87
111
|
export function mergeBackendDomainModules(
|
|
88
112
|
...modules: BackendDomainModule[]
|
|
89
113
|
): BackendDomainModule {
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# saas.backend.error-builder.user-guidance
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-backend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Build an error with contextual user guidance.
|
|
14
|
+
*
|
|
15
|
+
* Reach for this instead of a bare `buildError` whenever the person who hits the failure could DO
|
|
16
|
+
* something about it. A typed error tells a caller what went wrong; guidance tells a human what to
|
|
17
|
+
* do next, and the frontend renders it from `ErrorResponse.error.userGuidance`.
|
|
18
|
+
*
|
|
19
|
+
* ⚠️ **Prefer `buildErrorWithGuidanceKey`.** The strings you pass here are rendered verbatim, so a
|
|
20
|
+
* guidance written this way is English forever — the key variant resolves labels under
|
|
21
|
+
* `errors_guidance.{guidanceKey}.{field}` and is translated like every other user-facing string.
|
|
22
|
+
* Use the raw form only for a failure no user will read, or as the fallback beneath a key.
|
|
23
|
+
*
|
|
24
|
+
* The guidance is attached to the error and will be included in the
|
|
25
|
+
* `ErrorResponse.error.userGuidance` field for the frontend to render.
|
|
26
|
+
*
|
|
27
|
+
* @example
|
|
28
|
+
* ```
|
|
29
|
+
* throw this.errorBuilder.buildErrorWithGuidance(
|
|
30
|
+
* ErrorType.CONFIGURATION,
|
|
31
|
+
* executionContext,
|
|
32
|
+
* {
|
|
33
|
+
* explanation: 'SMTP is not configured for this organization.',
|
|
34
|
+
* resolution: 'Go to Settings → Email and configure your SMTP provider.',
|
|
35
|
+
* nextAction: { label: 'Go to Settings', ref: '/settings/email', type: 'url' },
|
|
36
|
+
* missingConfiguration: ['smtp_host', 'smtp_port'],
|
|
37
|
+
* },
|
|
38
|
+
* { customMessageReference: ErrorCustomMessageReference.GENERIC_DETAIL }
|
|
39
|
+
* );
|
|
40
|
+
* ```
|
|
41
|
+
*/
|
|
42
|
+
public buildErrorWithGuidance(
|
|
43
|
+
errorType: ErrorType,
|
|
44
|
+
executionContext: ExecutionContext<any> | undefined,
|
|
45
|
+
guidance: ErrorUserGuidance,
|
|
46
|
+
options: {
|
|
47
|
+
customMessageReference?: ErrorCustomMessageReference;
|
|
48
|
+
context?: Record<string, any>;
|
|
49
|
+
stack?: string;
|
|
50
|
+
} = {}
|
|
51
|
+
): WildoError_Backend {
|
|
52
|
+
const error = this.buildError(errorType, executionContext, options);
|
|
53
|
+
error.userGuidance = guidance;
|
|
54
|
+
return error;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Build an error with a guidance key (i18n reference).
|
|
59
|
+
*
|
|
60
|
+
* Shorthand for `buildErrorWithGuidance` that sets the `guidanceKey` on the guidance object,
|
|
61
|
+
* enabling i18n label resolution under `errors_guidance.{guidanceKey}.{field}`.
|
|
62
|
+
*
|
|
63
|
+
* @param errorType - The error type
|
|
64
|
+
* @param executionContext - Current execution context
|
|
65
|
+
* @param guidanceKey - i18n lookup key (resolves labels under `errors_guidance.{guidanceKey}.*`)
|
|
66
|
+
* @param guidance - Guidance fields (explanation, resolution, etc.) — used as raw fallbacks
|
|
67
|
+
* @param options - Additional error options
|
|
68
|
+
*/
|
|
69
|
+
public buildErrorWithGuidanceKey(
|
|
70
|
+
errorType: ErrorType,
|
|
71
|
+
executionContext: ExecutionContext<any> | undefined,
|
|
72
|
+
guidanceKey: string,
|
|
73
|
+
guidance: Omit<ErrorUserGuidance, 'guidanceKey'> = {},
|
|
74
|
+
options: {
|
|
75
|
+
customMessageReference?: ErrorCustomMessageReference;
|
|
76
|
+
context?: Record<string, any>;
|
|
77
|
+
stack?: string;
|
|
78
|
+
} = {}
|
|
79
|
+
): WildoError_Backend {
|
|
80
|
+
return this.buildErrorWithGuidance(errorType, executionContext, { ...guidance, guidanceKey }, options);
|
|
81
|
+
}
|
|
82
|
+
```
|
|
@@ -23,6 +23,12 @@ export interface FunctionToolExecutionContext {
|
|
|
23
23
|
auth: SocketAuthResult;
|
|
24
24
|
/** Active organization scope for the call, when applicable. */
|
|
25
25
|
organizationId?: string;
|
|
26
|
+
/**
|
|
27
|
+
* The conversational execution (the thread) this call is a turn of, when the tool runs inside
|
|
28
|
+
* one. A tool that starts work elsewhere — a run, a task — stamps it onto that work so the thread
|
|
29
|
+
* can list what it started; the engine supplies it and reads nothing back from it.
|
|
30
|
+
*/
|
|
31
|
+
executionId?: string;
|
|
26
32
|
/** Backend services the tool may use. */
|
|
27
33
|
services: FunctionToolExecutionServices;
|
|
28
34
|
}
|
|
@@ -16,14 +16,32 @@
|
|
|
16
16
|
* it per resource an agent should be able to read (e.g. `resourceReadTool(TODOS)`),
|
|
17
17
|
* making any registered resource agent-readable without hand-writing a tool.
|
|
18
18
|
*
|
|
19
|
-
* The tool
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
19
|
+
* The tool dispatches the resource's PUBLIC, URL-bearing default LIST / SEARCH — the same
|
|
20
|
+
* operation a REST client reaches — under a user `ExecutionContext` rebuilt from the caller's
|
|
21
|
+
* socket auth, and applies that operation's own declared `roles` ACL through
|
|
22
|
+
* `AuthorizationsBackendService.authorizeInController` before dispatching it. So the framework's
|
|
23
|
+
* contextual filter AND the role ACL apply exactly as for the user's own request. (The role gate
|
|
24
|
+
* is named explicitly because it does NOT come free with the service path: the service tier
|
|
25
|
+
* applies tenancy and the operation pipeline and no role check, so a tool that merely dispatched
|
|
26
|
+
* would run with the ACL unread — which is what this factory did until 2026-09-08.) A resource
|
|
27
|
+
* that declares no URL-bearing default for the operation is REFUSED rather than served through its
|
|
28
|
+
* route-less internal variant. WHO the caller is is NEVER taken
|
|
29
|
+
* from the model — only the record `id`, `searchQuery` and `limit` args are. Its `functionRef`
|
|
23
30
|
* defaults to `resource.<resourceType>.read` — reference that exact string from
|
|
24
31
|
* your agent's `capabilities.tools.functionRefs`. Import path:
|
|
25
32
|
* `@wildo-ai/saas-backend-lib`.
|
|
26
33
|
*
|
|
34
|
+
* **Looking up one record by its id.** Pass `id` to read ONE record through the resource's
|
|
35
|
+
* URL-bearing default READ — the same operation a REST client reaches — authorized as a row
|
|
36
|
+
* call under the same role ACL and contextual filter. A record that does not exist and a record
|
|
37
|
+
* the caller may not see both answer an empty `data`, deliberately alike, so a lookup never tells
|
|
38
|
+
* a caller that a record they cannot see exists. When `id` is given, `searchQuery` is ignored.
|
|
39
|
+
* A `searchQuery` matches a resource's searchable TEXT and never an id: an agent told to
|
|
40
|
+
* "resolve the id" of a record the user already identified by id must pass it as `id`, because a
|
|
41
|
+
* search for an id finds nothing and reads, to the model and then to the user, as "no such
|
|
42
|
+
* record". A resource that declares no URL-bearing READ is refused, as for any operation it does
|
|
43
|
+
* not expose.
|
|
44
|
+
*
|
|
27
45
|
* @param resourceType the resource to expose (any registered `ResourceType`).
|
|
28
46
|
* @param options optional `functionRef` / `description` / `defaultLimit` / `maxLimit` overrides.
|
|
29
47
|
* @example
|
|
@@ -14,10 +14,23 @@
|
|
|
14
14
|
* Produces a {@link FunctionTool} that lets an agent CREATE or UPDATE ONE resource
|
|
15
15
|
* type **as the calling user**, under the caller's own `ExecutionContext` rebuilt
|
|
16
16
|
* from their verified socket auth — no `systemAccessPolicy` bypass, and identity is
|
|
17
|
-
* NEVER taken from the model.
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
*
|
|
17
|
+
* NEVER taken from the model. It dispatches the resource's PUBLIC, URL-bearing default CREATE /
|
|
18
|
+
* UPDATE — the same operation a REST client reaches, with the same request DTO validating the
|
|
19
|
+
* model's arguments and the same prefix / postfix side effects — and applies that operation's own
|
|
20
|
+
* `accessControl` (roles + parent scope, plus per-row access on UPDATE) through
|
|
21
|
+
* `AuthorizationsBackendService.authorizeInController` before the write. Authorization is therefore
|
|
22
|
+
* **fail-closed**: a caller lacking the operation's role gets a thrown authz error, not a silent
|
|
23
|
+
* write.
|
|
24
|
+
*
|
|
25
|
+
* Both halves of that are load-bearing and neither came free, so do not simplify them away. The
|
|
26
|
+
* service tier applies tenancy and the operation pipeline and NO role check, and the service
|
|
27
|
+
* layer's own default resolver PREFERS a route-less `INTERNAL_CALL` variant over the public one —
|
|
28
|
+
* so before 2026-09-08 this factory dispatched a different operation from the one it advertises,
|
|
29
|
+
* with the ACL unread. On `organizations` CREATE that combination created ownerless tenants.
|
|
30
|
+
*
|
|
31
|
+
* A resource that declares no URL-bearing default for the operation is REFUSED rather than written
|
|
32
|
+
* through its internal variant. So is an operation that requires an Idempotency-Key: the tool has no key
|
|
33
|
+
* to send, so it would be refused on every call — write a dedicated tool that passes one. Owner FKs and
|
|
21
34
|
* other server-set fields are EC-injected / `excludeFromCreate`, so the model can
|
|
22
35
|
* never spoof ownership through the tool arguments.
|
|
23
36
|
*
|