@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
|
@@ -57,19 +57,21 @@ export const WildoSaasConfigSchema = z.strictObject({
|
|
|
57
57
|
/**
|
|
58
58
|
* Long-running "minion" actor hosts (scheduled or always-up).
|
|
59
59
|
*
|
|
60
|
-
* Each entry
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
*
|
|
60
|
+
* Each entry declares the `resourceAccess` read/write allowlists consumed by
|
|
61
|
+
* the minion runtime's scoped services-registry proxy. Missing lists deny
|
|
62
|
+
* resource calls; unknown declared resource names fail startup. This is
|
|
63
|
+
* runtime containment, separate from the operation's own authorization and
|
|
64
|
+
* the minion's provider and platform-access scopes.
|
|
64
65
|
*/
|
|
65
66
|
minions: z.record(z.string(), MinionBucketEntrySchema).optional(),
|
|
66
67
|
/**
|
|
67
68
|
* HTTP-only "worker" subprocesses (compute-heavy, often Rust/Go).
|
|
68
69
|
*
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
*
|
|
72
|
-
*
|
|
70
|
+
* Node workers use `defineWorkerInit` from `@wildo-ai/saas-workers-node-lib`;
|
|
71
|
+
* other languages implement the same HTTP and token-verification contract.
|
|
72
|
+
* Workers have no `resourceAccess` field: they are not backend queue consumers
|
|
73
|
+
* and do not receive application repository access. Pass the data required
|
|
74
|
+
* by their request contract instead of treating them as minions.
|
|
73
75
|
*/
|
|
74
76
|
workers: z.record(z.string(), AppRefSchema).optional(),
|
|
75
77
|
|
|
@@ -90,9 +92,120 @@ export const WildoSaasConfigSchema = z.strictObject({
|
|
|
90
92
|
*/
|
|
91
93
|
providers: SaasConfigProvidersBlockSchema,
|
|
92
94
|
|
|
95
|
+
/**
|
|
96
|
+
* The application's organization types — required, and at least one (#1032, decided 2026-09-14).
|
|
97
|
+
*
|
|
98
|
+
* Authored HERE rather than in `backend-api/src/saas-config.backend.ts`, where it used to live,
|
|
99
|
+
* because the platform needs it and cannot read backend-authored configuration: apps-manager seeds
|
|
100
|
+
* the organization of the application's first administrator, and that organization must carry one
|
|
101
|
+
* of these types. It reaches the platform inside the declaration, like `providers` and
|
|
102
|
+
* `engineCapabilities`, and the backend refuses to author it.
|
|
103
|
+
*
|
|
104
|
+
* Every organization carries a type, and a member of an organization whose type names no entry here
|
|
105
|
+
* cannot sign in — which is why this is not optional.
|
|
106
|
+
*/
|
|
107
|
+
organizationTypes: OrganizationTypesConfigSchema,
|
|
108
|
+
|
|
93
109
|
bootstrap: AppBootstrapSchema.optional(),
|
|
94
110
|
dataServices: AppDataServicesSchema,
|
|
95
111
|
|
|
112
|
+
/**
|
|
113
|
+
* The systems of record this application reads its own business rows out of — Odoo, an S/4HANA
|
|
114
|
+
* OData service, a Dynamics deployment — each a NAMED INSTANCE that resources bind by name.
|
|
115
|
+
*
|
|
116
|
+
* Declared HERE, beside `dataServices`, because it answers the same question from the other side:
|
|
117
|
+
* `dataServices` says which stores this application OWNS, and this says which stores it READS and
|
|
118
|
+
* does not own. Both are application-wide operator decisions rather than per-resource authoring.
|
|
119
|
+
*
|
|
120
|
+
* Declaring the block is what ENABLES the external-data lane (#1055 D3); there is no capability
|
|
121
|
+
* flag, because the lane has no meaning without an instance to point at. Each instance's ADDRESS
|
|
122
|
+
* and SECRETS live in the environment (`wildo.infra.<location>.config.ts` and `secrets.json`) under
|
|
123
|
+
* names DERIVED from the instance name — `WILDO_SOR_<NAME>__<SLOT>` — never authored, so renaming an
|
|
124
|
+
* instance renames its variables and `wildo config sync` reports the ones that went missing.
|
|
125
|
+
*
|
|
126
|
+
* Not `providers`, deliberately (#1055 D10). A provider is selected through the capability plane and
|
|
127
|
+
* may carry a person's lent credential; a system of record is a deployment the application reads with
|
|
128
|
+
* its OWN service identity, and nothing serves both.
|
|
129
|
+
*/
|
|
130
|
+
systemsOfRecord: SystemsOfRecordConfigSchema.optional(),
|
|
131
|
+
|
|
132
|
+
/**
|
|
133
|
+
* How long this application keeps each class of data, and why.
|
|
134
|
+
*
|
|
135
|
+
* Declared HERE, beside `dataServices`, because the two describe the same thing from opposite ends:
|
|
136
|
+
* `dataServices` says which stores exist, and this says how long what is in them is kept. Both are
|
|
137
|
+
* application-wide operator decisions rather than per-resource authoring.
|
|
138
|
+
*
|
|
139
|
+
* Optional as a whole, and partial within itself. An application that has decided nothing omits it;
|
|
140
|
+
* one that has decided only its customer-data period declares only that. Absence is never read as
|
|
141
|
+
* "kept forever" — a compliance document states the classes that ARE declared and marks the rest as
|
|
142
|
+
* needing an operator decision, which is what lets the document be produced today rather than
|
|
143
|
+
* waiting on a number nobody has yet.
|
|
144
|
+
*
|
|
145
|
+
* Two consumers, and the second is why the classes are the STORES: a privacy notice's retention
|
|
146
|
+
* paragraph (issue #89, which is why this exists), and the backup-and-restore inventory a remote
|
|
147
|
+
* environment still has none of (issue #8) — one declaration answers both instead of two that drift.
|
|
148
|
+
*/
|
|
149
|
+
dataRetention: ApplicationRetentionScheduleSchema.optional(),
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* How often this application re-reviews its compliance programme.
|
|
153
|
+
*
|
|
154
|
+
* A COMMITMENT, and that is why it is declared rather than asked. `top_down.compliance-conception`
|
|
155
|
+
* used to elicit a next-review DATE in free text — "answer as an ISO date, after today's" — which is
|
|
156
|
+
* three things wrong at once: a date goes stale the moment it passes, it has to be re-answered on
|
|
157
|
+
* every run, and it is a proxy for the thing actually being promised. The promise is the CADENCE;
|
|
158
|
+
* the date is an output (`deriveNextReviewOn`), computed from the instant the programme was drafted.
|
|
159
|
+
* The general form: a date is a PROXY for "an input may have changed", and where every input is
|
|
160
|
+
* enumerable the trigger is computable and the date is an output, never a question.
|
|
161
|
+
*
|
|
162
|
+
* Optional, and an absent cadence is NOT a default. A programme produced without one is still
|
|
163
|
+
* produced: no obligation carries a next-review date, and the programme states in a stamped limitation
|
|
164
|
+
* that no schedule is committed. Committing to one is a workflow, and a workflow MARKS rather than
|
|
165
|
+
* standing in front of the mechanism. Declaring it here is still the better place than any form: the
|
|
166
|
+
* answer is committed, diffable, and reused by every later run.
|
|
167
|
+
*
|
|
168
|
+
* `AS_NEEDED` is a legitimate value for the vocabulary and schedules nothing, so it produces the same
|
|
169
|
+
* marked programme as no declaration — never a silently chosen far-future date.
|
|
170
|
+
*
|
|
171
|
+
* The vocabulary is `ReviewCadence`, shared with market/roadmap/brand authoring rather than
|
|
172
|
+
* re-declared — one closed vocabulary, one runtime source (CLAUDE.md).
|
|
173
|
+
*/
|
|
174
|
+
assuranceReviewCadence: z.enum(ReviewCadence).optional(),
|
|
175
|
+
|
|
176
|
+
/**
|
|
177
|
+
* Whether each AI capability this application enables DECIDES something about a person, and who
|
|
178
|
+
* reviews it if so.
|
|
179
|
+
*
|
|
180
|
+
* A capability establishes that AI is in use and for what function; it cannot establish consequence,
|
|
181
|
+
* because the same `AI_LLM` backs a summariser that decides nothing and a screener that decides a
|
|
182
|
+
* great deal (issue #92).
|
|
183
|
+
*
|
|
184
|
+
* Optional and partial, like `dataRetention` — but the silence here is the more dangerous one. A
|
|
185
|
+
* notice describing AI use without addressing consequence does not read as "unknown", it reads as
|
|
186
|
+
* "nothing significant happens", which silently claims an exemption. So an enabled AI capability with
|
|
187
|
+
* no entry is REPORTED as outstanding rather than assumed harmless.
|
|
188
|
+
*/
|
|
189
|
+
aiUsePosture: ApplicationAiUsePostureSchema.optional(),
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* What this application stores in a visitor's browser, per FRONTEND SURFACE — the itemised table a
|
|
193
|
+
* cookie notice IS (issue #91).
|
|
194
|
+
*
|
|
195
|
+
* Per surface because a public marketing site and the authenticated application set different things,
|
|
196
|
+
* and one merged list would be wrong for both. The FRAMEWORK's own cookies are not declared here:
|
|
197
|
+
* every application inherits them and none authored them, so they are answered by
|
|
198
|
+
* `ENGINE_CLIENT_STORAGE_ENTRIES` and reported separately.
|
|
199
|
+
*
|
|
200
|
+
* Optional and partial. A surface with no entry has not been inventoried and is reported as such; an
|
|
201
|
+
* empty ARRAY is the different, positive answer — this surface sets nothing of its own.
|
|
202
|
+
*/
|
|
203
|
+
clientStorage: ApplicationClientStorageInventorySchema.optional(),
|
|
204
|
+
operatingJurisdictions: ApplicationOperatingJurisdictionsSchema.optional(),
|
|
205
|
+
operatorComplianceIdentity: ApplicationOperatorComplianceIdentitySchema.optional(),
|
|
206
|
+
providerComplianceChoices: ApplicationProviderComplianceChoicesSchema.optional(),
|
|
207
|
+
riskPosture: ApplicationRiskPostureSchema.optional(),
|
|
208
|
+
|
|
96
209
|
/**
|
|
97
210
|
* Module registries the app pulls modules from. Each entry pairs a
|
|
98
211
|
* stable id (used by lockfile entries + the `--registry <id>` CLI
|
|
@@ -121,6 +234,97 @@ export const WildoSaasConfigSchema = z.strictObject({
|
|
|
121
234
|
// below guarantees that "the TECH_DOC service folder" and "the
|
|
122
235
|
// STATIC_WEBSITE service folder" are unambiguous.
|
|
123
236
|
}).superRefine((config, ctx) => {
|
|
237
|
+
/*
|
|
238
|
+
* The first administrator's organization type must be DERIVABLE, and this is the earliest place to
|
|
239
|
+
* say so. apps-manager derives it at initialization with the same function; refusing here turns a
|
|
240
|
+
* failure midway through provisioning into an authoring error at the moment the file is loaded.
|
|
241
|
+
*/
|
|
242
|
+
const firstAdministratorUserTypes = config.bootstrap?.firstAdmin?.userTypes;
|
|
243
|
+
if (firstAdministratorUserTypes !== undefined) {
|
|
244
|
+
const derivation = deriveFirstAdministratorOrganizationType(config.organizationTypes, firstAdministratorUserTypes);
|
|
245
|
+
if (derivation.outcome === OrganizationTypeDerivationOutcome.NONE) {
|
|
246
|
+
ctx.addIssue({
|
|
247
|
+
code: 'custom',
|
|
248
|
+
path: ['bootstrap', 'firstAdmin', 'userTypes'],
|
|
249
|
+
message:
|
|
250
|
+
`No organization type covers the first administrator's user types (${firstAdministratorUserTypes.join(', ')}). `
|
|
251
|
+
+ 'The platform seeds the first administrator into an organization of the type whose `userTypes` include all of '
|
|
252
|
+
+ 'them; declare one in `organizationTypes`.',
|
|
253
|
+
});
|
|
254
|
+
} else if (derivation.outcome === OrganizationTypeDerivationOutcome.AMBIGUOUS) {
|
|
255
|
+
ctx.addIssue({
|
|
256
|
+
code: 'custom',
|
|
257
|
+
path: ['bootstrap', 'firstAdmin', 'userTypes'],
|
|
258
|
+
message:
|
|
259
|
+
`Several organization types cover the first administrator's user types (${derivation.candidates.join(', ')}), `
|
|
260
|
+
+ 'so the type of the organization the platform seeds for them cannot be derived. Narrow the `userTypes` of all '
|
|
261
|
+
+ 'but one of them.',
|
|
262
|
+
});
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
/*
|
|
266
|
+
* A declared OWNER type must be able to take the bootstrap organization (#1054).
|
|
267
|
+
*
|
|
268
|
+
* The organization the platform seeds for the first administrator IS the organization that owns
|
|
269
|
+
* the application, so a marked type whose `userTypes` do not cover the administrator's is a
|
|
270
|
+
* declaration that cannot be satisfied. Without this the failure is SILENT rather than loud: the
|
|
271
|
+
* derivation above finds no marked type among the fitting ones, falls through to the unmarked
|
|
272
|
+
* candidates, and seeds the administrator into a customer-shaped tenant — leaving an application
|
|
273
|
+
* that declares an owner type and has no owner organization, with no door that could type one
|
|
274
|
+
* afterwards (`Organization.type` is creation-time identity).
|
|
275
|
+
*
|
|
276
|
+
* Checked here rather than in `OrganizationTypesConfigSchema`, because it is a statement about
|
|
277
|
+
* TWO top-level blocks — `organizationTypes` and `bootstrap` — and the types schema can only see
|
|
278
|
+
* its own.
|
|
279
|
+
*/
|
|
280
|
+
const ownerTypeDerivation = resolveApplicationOwnerOrganizationType(config.organizationTypes);
|
|
281
|
+
if (ownerTypeDerivation.outcome === OrganizationTypeDerivationOutcome.DERIVED) {
|
|
282
|
+
const ownerTypeUserTypes = config.organizationTypes?.[ownerTypeDerivation.organizationType]?.userTypes ?? [];
|
|
283
|
+
const uncoveredUserTypes = firstAdministratorUserTypes.filter((userType) => !ownerTypeUserTypes.includes(userType));
|
|
284
|
+
if (uncoveredUserTypes.length > 0) {
|
|
285
|
+
ctx.addIssue({
|
|
286
|
+
code: 'custom',
|
|
287
|
+
path: ['organizationTypes', ownerTypeDerivation.organizationType, 'userTypes'],
|
|
288
|
+
message:
|
|
289
|
+
`Organization type '${ownerTypeDerivation.organizationType}' declares \`ownsApplication\` but its \`userTypes\` `
|
|
290
|
+
+ `do not include ${uncoveredUserTypes.map((userType) => `'${userType}'`).join(', ')}, which the first administrator holds `
|
|
291
|
+
+ `(bootstrap.firstAdmin.userTypes: ${firstAdministratorUserTypes.join(', ')}). The organization seeded for the first `
|
|
292
|
+
+ 'administrator is the organization that owns the application, so the owner type must grant everything that '
|
|
293
|
+
+ 'administrator is. Add the missing user types to it, or move the marker to the type that already covers them.',
|
|
294
|
+
});
|
|
295
|
+
}
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
|
|
299
|
+
/*
|
|
300
|
+
* A declared system of record needs an organization to belong to (#1055, resting on #1054).
|
|
301
|
+
*
|
|
302
|
+
* Rows read out of a system of record are stamped with the OWNER organization's id, which is what
|
|
303
|
+
* lets the per-row tenant gate pass with no exemption. An application that declares an instance and
|
|
304
|
+
* no `ownsApplication` type has nothing to stamp with, so every read of every bound resource would
|
|
305
|
+
* refuse at request time with `owner_organization_absent` — a runtime failure whose cause is an
|
|
306
|
+
* authoring omission three layers up.
|
|
307
|
+
*
|
|
308
|
+
* Refused here rather than at boot because this is exactly the kind of contradiction one file can
|
|
309
|
+
* see: both blocks are in scope, and turning it into an authoring error means nobody can commit it.
|
|
310
|
+
* The DERIVATION being ambiguous (two marked types) is refused by `OrganizationTypesConfigSchema`
|
|
311
|
+
* itself, so only the NONE outcome is left to answer here.
|
|
312
|
+
*/
|
|
313
|
+
if (config.systemsOfRecord !== undefined && Object.keys(config.systemsOfRecord).length > 0) {
|
|
314
|
+
const ownerTypeForSystemsOfRecord = resolveApplicationOwnerOrganizationType(config.organizationTypes);
|
|
315
|
+
if (ownerTypeForSystemsOfRecord.outcome === OrganizationTypeDerivationOutcome.NONE) {
|
|
316
|
+
ctx.addIssue({
|
|
317
|
+
code: 'custom',
|
|
318
|
+
path: ['systemsOfRecord'],
|
|
319
|
+
message:
|
|
320
|
+
`This application declares ${Object.keys(config.systemsOfRecord).map((name) => `'${name}'`).join(', ')} as a system of record, `
|
|
321
|
+
+ 'but no organization type declares `ownsApplication`. Rows read out of a system of record are stamped with the owning '
|
|
322
|
+
+ "organization's id — that stamp is what makes them belong to a tenant at all — so without one every read would refuse. "
|
|
323
|
+
+ 'Mark the organization type whose organization operates this application.',
|
|
324
|
+
});
|
|
325
|
+
}
|
|
326
|
+
}
|
|
327
|
+
|
|
124
328
|
const availableServiceKeys = new Set(Object.keys(config.services));
|
|
125
329
|
const frontendServiceKeys = new Set(
|
|
126
330
|
Object.entries(config.services)
|
|
@@ -224,6 +428,54 @@ export const WildoSaasConfigSchema = z.strictObject({
|
|
|
224
428
|
});
|
|
225
429
|
}
|
|
226
430
|
}
|
|
431
|
+
|
|
432
|
+
/*
|
|
433
|
+
* The two capability lists must AGREE (#438). `providerCapabilities` are vendor-side tokens;
|
|
434
|
+
* `PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY` projects each into the engine slot it fills, and
|
|
435
|
+
* `engineCapabilities` is the application's statement of which slots this provider serves in
|
|
436
|
+
* this scope. Two statements about one fact, and nothing compared them.
|
|
437
|
+
*
|
|
438
|
+
* Measured on Your Application before this check existed: the companion scope declared
|
|
439
|
+
* `providerCapabilities: ['CODING_AGENT']` under `engineCapabilities: [AI_LLM]` — a token
|
|
440
|
+
* that projects to AI_CODING_AGENT, claiming a slot it does not fill and omitting the one it
|
|
441
|
+
* does. It was invisible because a coding agent resolves its provider by `providerRef`, never
|
|
442
|
+
* through the slot, so nothing ever asked the projection whether it agreed.
|
|
443
|
+
*
|
|
444
|
+
* A token with NO slot (`SSO_OAUTH2`, `FRONTEND_FILE_PICKER`, `FRONTEND_CAPTCHA`) projects to
|
|
445
|
+
* nothing and is not an omission — those providers legitimately declare no engine capability.
|
|
446
|
+
* Only tokens that DO map participate, which is why this compares sets rather than counts.
|
|
447
|
+
*/
|
|
448
|
+
const projectedCapabilities = new Set(
|
|
449
|
+
selection.providerCapabilities
|
|
450
|
+
.map((token) => PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY[token as BuiltinProviderCapability])
|
|
451
|
+
.filter((capability): capability is EngineCapability => Boolean(capability)),
|
|
452
|
+
);
|
|
453
|
+
const declaredCapabilities = new Set<EngineCapability>(selection.engineCapabilities as EngineCapability[]);
|
|
454
|
+
|
|
455
|
+
const claimedButNotProjected = [...declaredCapabilities].filter((capability) => !projectedCapabilities.has(capability));
|
|
456
|
+
const projectedButNotClaimed = [...projectedCapabilities].filter((capability) => !declaredCapabilities.has(capability));
|
|
457
|
+
|
|
458
|
+
if (claimedButNotProjected.length > 0 || projectedButNotClaimed.length > 0) {
|
|
459
|
+
const parts: string[] = [];
|
|
460
|
+
if (projectedButNotClaimed.length > 0) {
|
|
461
|
+
parts.push(
|
|
462
|
+
`providerCapabilities project ${projectedButNotClaimed.join(', ')} which engineCapabilities does not declare`,
|
|
463
|
+
);
|
|
464
|
+
}
|
|
465
|
+
if (claimedButNotProjected.length > 0) {
|
|
466
|
+
parts.push(
|
|
467
|
+
`engineCapabilities declares ${claimedButNotProjected.join(', ')} which no declared providerCapability projects`,
|
|
468
|
+
);
|
|
469
|
+
}
|
|
470
|
+
ctx.addIssue({
|
|
471
|
+
code: 'custom',
|
|
472
|
+
path: [...scopePath, 'providers', providerRef, 'engineCapabilities'],
|
|
473
|
+
message:
|
|
474
|
+
`Provider "${providerRef}" declares capability lists that disagree: ${parts.join('; ')}. `
|
|
475
|
+
+ 'The two lists describe one fact — which engine slots this provider serves in this scope — '
|
|
476
|
+
+ 'so make them agree by adding the missing engineCapabilities, or by removing a providerCapability the provider does not serve here.',
|
|
477
|
+
});
|
|
478
|
+
}
|
|
227
479
|
}
|
|
228
480
|
|
|
229
481
|
for (const [capability, policy] of Object.entries(scope.selection ?? {})) {
|
|
@@ -242,7 +494,7 @@ export const WildoSaasConfigSchema = z.strictObject({
|
|
|
242
494
|
});
|
|
243
495
|
continue;
|
|
244
496
|
}
|
|
245
|
-
for (const providerRef of [policy.primary, ...(policy.
|
|
497
|
+
for (const providerRef of [policy.primary, ...(policy.whenUnavailable ?? [])]) {
|
|
246
498
|
const providerSelection = scope.providers[providerRef];
|
|
247
499
|
if (providerSelection && !providerSelection.engineCapabilities.includes(capability as EngineCapability)) {
|
|
248
500
|
ctx.addIssue({
|
|
@@ -16,6 +16,19 @@ export enum LabellingTypes {
|
|
|
16
16
|
ERRORS_MESSAGES = "errors_messages",
|
|
17
17
|
ERRORS_GUIDANCE = "errors_guidance",
|
|
18
18
|
ERRORS_VALIDATION = "errors_validation",
|
|
19
|
+
/**
|
|
20
|
+
* Words for a DECLARED REFUSAL — an operation's `errorScenarios[].errorCode` in its resource
|
|
21
|
+
* specification (#1048). A refusal such as "this credential slot is not declared by the provider"
|
|
22
|
+
* reaches the browser as a machine code in the error's `details`, and nothing gave that code words:
|
|
23
|
+
* `errors_messages` is the generic `ErrorCustomMessageReference` vocabulary, so a form showed the
|
|
24
|
+
* generic "Some information is invalid" and the remedy the specification documents was lost.
|
|
25
|
+
*
|
|
26
|
+
* Planned TOTAL over the declared codes (a code declared tomorrow is planned by construction),
|
|
27
|
+
* except a code that is already an `ErrorCustomMessageReference` value, which already has words in
|
|
28
|
+
* `errors_messages`. Each code's `when` text is the generation context. Keys are
|
|
29
|
+
* `errors_refusals.<CODE>.msg`.
|
|
30
|
+
*/
|
|
31
|
+
ERRORS_REFUSALS = "errors_refusals",
|
|
19
32
|
NOTIFICATIONS_CUSTOM = "notifications_custom",
|
|
20
33
|
COMPONENTS= "components",
|
|
21
34
|
RESOURCES_FIELDS = "resources_fields",
|
|
@@ -48,6 +61,7 @@ export const EAGER_I18N_SECTIONS: LabellingTypes[] = [
|
|
|
48
61
|
LabellingTypes.SYSTEM_ENUMS,
|
|
49
62
|
LabellingTypes.ERRORS_MESSAGES,
|
|
50
63
|
LabellingTypes.ERRORS_VALIDATION,
|
|
64
|
+
LabellingTypes.ERRORS_REFUSALS,
|
|
51
65
|
LabellingTypes.ERRORS_GUIDANCE,
|
|
52
66
|
LabellingTypes.SIDEBAR_SECTIONS,
|
|
53
67
|
LabellingTypes.SETTINGS_HUB,
|
|
@@ -370,20 +370,29 @@ export interface A11yPolicy {
|
|
|
370
370
|
* disable). When a finite tier is set the surface is also centered in its
|
|
371
371
|
* container (`margin-inline: auto`).
|
|
372
372
|
*/
|
|
373
|
-
export
|
|
374
|
-
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
373
|
+
export const RESPONSIVE_MAX_WIDTH_VALUES = [
|
|
374
|
+
'full',
|
|
375
|
+
'sm',
|
|
376
|
+
'md',
|
|
377
|
+
'lg',
|
|
378
|
+
'xl',
|
|
379
379
|
// Reading-measure cap (~42rem) for single-column FORM / field stacks (T4c),
|
|
380
380
|
// so detail/settings forms stop stretching edge-to-edge inside a wide content
|
|
381
381
|
// zone. Wider than the component tiers (`sm`–`xl`, dialog-scale) but far tighter
|
|
382
382
|
// than `content`/`centered-readable`. Retune via `--measure-max-width`.
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
383
|
+
'measure',
|
|
384
|
+
'centered-readable',
|
|
385
|
+
'content',
|
|
386
|
+
'none',
|
|
387
|
+
] as const;
|
|
388
|
+
|
|
389
|
+
/**
|
|
390
|
+
* The RUNTIME source for the width vocabulary, so a schema that must validate a declared tier can
|
|
391
|
+
* name it instead of re-listing the members. It became necessary the moment width stopped being a
|
|
392
|
+
* surface-only concern: the zone content boundary, `DisplayLayout` and `FormLayout` all select a tier
|
|
393
|
+
* now, and a second hand-written list of the same nine values is a list that drifts.
|
|
394
|
+
*/
|
|
395
|
+
export type ResponsiveMaxWidth = (typeof RESPONSIVE_MAX_WIDTH_VALUES)[number];
|
|
387
396
|
|
|
388
397
|
export type MobileShape = 'inline' | 'drawer' | 'sheet';
|
|
389
398
|
|
|
@@ -47,14 +47,14 @@ export const RequirementsAuthoredMetadataSchema = z.object({
|
|
|
47
47
|
/** ISO-8601 timestamp of the last meaningful authoring touch. */
|
|
48
48
|
lastAuthoredAt: z.iso.datetime(),
|
|
49
49
|
/** Author's self-assessed confidence in the current content. */
|
|
50
|
-
confidence: z.enum(AuthoredConfidence),
|
|
50
|
+
confidence: z.enum(AuthoredConfidence).systemEnum('AuthoredConfidence'),
|
|
51
51
|
/**
|
|
52
52
|
* Cadence at which the entity should be re-reviewed. When set, the
|
|
53
53
|
* snapshot validator emits `STALE_AUTHORED` if `lastAuthoredAt +
|
|
54
54
|
* cadence < now`. When omitted, no staleness check runs (same
|
|
55
55
|
* semantics as the market / vision / assertions families).
|
|
56
56
|
*/
|
|
57
|
-
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
57
|
+
reviewCadence: z.enum(ReviewCadence).systemEnum('ReviewCadence').optional(),
|
|
58
58
|
/** Owner accountable for the entity's content. Free-form name/handle. */
|
|
59
59
|
reviewer: NonEmptyStringSchema.optional(),
|
|
60
60
|
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
@@ -99,6 +99,21 @@ export interface RequirementsSnapshotValidationResult {
|
|
|
99
99
|
issues: RequirementsSnapshotIssue[];
|
|
100
100
|
}
|
|
101
101
|
|
|
102
|
+
/**
|
|
103
|
+
* Options for this family validator.
|
|
104
|
+
*
|
|
105
|
+
* ## The cross-family sets are OPT-IN, and omitting one SKIPS its check
|
|
106
|
+
*
|
|
107
|
+
* A family validator sees one family. It cannot resolve a reference into another family's
|
|
108
|
+
* vocabulary unless you hand it that family's refs — so each `available*Refs` option is the caller
|
|
109
|
+
* saying "I have this context, use it". Omit one and the matching check does not run: no issue is
|
|
110
|
+
* reported, and the absence looks exactly like a snapshot with no such reference.
|
|
111
|
+
*
|
|
112
|
+
* That is deliberate — the families are decoupled on purpose — but it means a validator called with
|
|
113
|
+
* the snapshot alone is checking this family's INTERNAL consistency only. If you want dangling
|
|
114
|
+
* cross-family references caught, supply the sets; if you validate one family in isolation, expect
|
|
115
|
+
* them to be found later by whatever holds every family at once.
|
|
116
|
+
*/
|
|
102
117
|
export interface ValidateRequirementsSnapshotOptions {
|
|
103
118
|
/** Override "now" for `STALE_AUTHORED` checks (test affordance). Defaults to `new Date()`. */
|
|
104
119
|
now?: Date;
|
|
@@ -47,14 +47,14 @@ export const RoadmapAuthoredMetadataSchema = z.object({
|
|
|
47
47
|
/** ISO-8601 timestamp of the last meaningful authoring touch. */
|
|
48
48
|
lastAuthoredAt: z.iso.datetime(),
|
|
49
49
|
/** Author's self-assessed confidence in the current content. */
|
|
50
|
-
confidence: z.enum(AuthoredConfidence),
|
|
50
|
+
confidence: z.enum(AuthoredConfidence).systemEnum('AuthoredConfidence'),
|
|
51
51
|
/**
|
|
52
52
|
* Cadence at which the entity should be re-reviewed. When set, the
|
|
53
53
|
* snapshot validator emits `STALE_AUTHORED` if `lastAuthoredAt +
|
|
54
54
|
* cadence < now`. When omitted, no staleness check runs (same semantics
|
|
55
55
|
* as the market / vision / requirements / assertions families).
|
|
56
56
|
*/
|
|
57
|
-
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
57
|
+
reviewCadence: z.enum(ReviewCadence).systemEnum('ReviewCadence').optional(),
|
|
58
58
|
/** Owner accountable for the entity's content. Free-form name/handle. */
|
|
59
59
|
reviewer: NonEmptyStringSchema.optional(),
|
|
60
60
|
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
@@ -108,6 +108,21 @@ export interface RoadmapSnapshotValidationResult {
|
|
|
108
108
|
issues: RoadmapSnapshotIssue[];
|
|
109
109
|
}
|
|
110
110
|
|
|
111
|
+
/**
|
|
112
|
+
* Options for this family validator.
|
|
113
|
+
*
|
|
114
|
+
* ## The cross-family sets are OPT-IN, and omitting one SKIPS its check
|
|
115
|
+
*
|
|
116
|
+
* A family validator sees one family. It cannot resolve a reference into another family's
|
|
117
|
+
* vocabulary unless you hand it that family's refs — so each `available*Refs` option is the caller
|
|
118
|
+
* saying "I have this context, use it". Omit one and the matching check does not run: no issue is
|
|
119
|
+
* reported, and the absence looks exactly like a snapshot with no such reference.
|
|
120
|
+
*
|
|
121
|
+
* That is deliberate — the families are decoupled on purpose — but it means a validator called with
|
|
122
|
+
* the snapshot alone is checking this family's INTERNAL consistency only. If you want dangling
|
|
123
|
+
* cross-family references caught, supply the sets; if you validate one family in isolation, expect
|
|
124
|
+
* them to be found later by whatever holds every family at once.
|
|
125
|
+
*/
|
|
111
126
|
export interface ValidateRoadmapSnapshotOptions {
|
|
112
127
|
/** Override "now" for `STALE_AUTHORED` checks (test affordance). Defaults to `new Date()`. */
|
|
113
128
|
now?: Date;
|
|
@@ -132,13 +147,6 @@ export interface ValidateRoadmapSnapshotOptions {
|
|
|
132
147
|
* requirements / assertions validators (module-local there too — a shared
|
|
133
148
|
* promotion is part of the deferred authored-metadata generalization).
|
|
134
149
|
*/
|
|
135
|
-
const REVIEW_CADENCE_TO_DAYS: Record<ReviewCadence, number> = {
|
|
136
|
-
[ReviewCadence.WEEKLY]: 7,
|
|
137
|
-
[ReviewCadence.MONTHLY]: 31,
|
|
138
|
-
[ReviewCadence.QUARTERLY]: 92,
|
|
139
|
-
[ReviewCadence.YEARLY]: 366,
|
|
140
|
-
[ReviewCadence.AS_NEEDED]: Number.POSITIVE_INFINITY,
|
|
141
|
-
};
|
|
142
150
|
|
|
143
151
|
export function validateRoadmapSnapshot(
|
|
144
152
|
snapshot: RoadmapSnapshot,
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# saas.backend.a2a.token-budget
|
|
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
|
+
* Capping what external agent callers may SPEND on a tenant's behalf.
|
|
14
|
+
*
|
|
15
|
+
* An application declares the allowance as a numeric LIMIT on a billing product, and nothing else:
|
|
16
|
+
* the transport resolves it live from the plan, so an upgrade or downgrade takes effect immediately
|
|
17
|
+
* with no copy to keep in sync. The burst throttle beside it needs no declaration at all.
|
|
18
|
+
*
|
|
19
|
+
* ⚠️ **Declare it with `CEILING` semantics.** This is a consumption cap, and under the default
|
|
20
|
+
* `FLOOR` an unlimited default absorbs every finite plan grant — so the cap silently never engages.
|
|
21
|
+
* That is the same trap the limit builders record, and this is the surface where it costs money.
|
|
22
|
+
*
|
|
23
|
+
* Two scopes, and they are not the same one: the BUDGET is per TENANT, the burst throttle is per
|
|
24
|
+
* PRINCIPAL. An organization holding several machine credentials therefore gets that many throttle
|
|
25
|
+
* windows against one shared budget.
|
|
26
|
+
*
|
|
27
|
+
* Per-tenant LLM **token budget** for the inbound A2A transport — the sustained cost control
|
|
28
|
+
* that complements the per-principal BURST throttle (`external-turn-rate-limit`). The burst
|
|
29
|
+
* throttle caps turns-per-minute; this caps tokens **per budget period** against the allowance the
|
|
30
|
+
* tenant's plan grants, and DENIES further turns once exhausted. The period is a UTC calendar
|
|
31
|
+
* month in v1 (see {@link A2ATokenBudgetBackendService.currentPeriodKey}) — deliberately NOT the
|
|
32
|
+
* tenant's billing window, which would cost a billing-account lookup on every turn.
|
|
33
|
+
*
|
|
34
|
+
* ## Two halves, deliberately separated
|
|
35
|
+
*
|
|
36
|
+
* - **Allowance** (the cap) is NOT stored here — it is resolved live from the billing plan via
|
|
37
|
+
* `FeatureResolution.resolveForScope(...).limits[{@link A2A_TOKEN_BUDGET_FEATURE_ID}]`, so a plan
|
|
38
|
+
* upgrade/downgrade takes effect immediately with no copy to keep in sync.
|
|
39
|
+
* - **Consumption** is accumulated in the `a2aTokenBudgetState` polymorphic SINGLETON (exactly one
|
|
40
|
+
* row per tenant; the period lives inside the row and is rolled in place). One row per tenant
|
|
41
|
+
* makes double-counting structurally impossible.
|
|
42
|
+
*
|
|
43
|
+
* ## Error policy (two distinct axes — do not conflate)
|
|
44
|
+
*
|
|
45
|
+
* The BUDGET SEMANTIC is fail-closed: exhausted allowance ⇒ hard deny (HTTP 402 at the transport),
|
|
46
|
+
* never a soft warning. The ERROR policy is split by what we can actually prove:
|
|
47
|
+
*
|
|
48
|
+
* - **Allowance resolution fails** → DENY with `ALLOWANCE_UNVERIFIABLE`. An unreadable
|
|
49
|
+
* allowance is not proof that the tenant has no cap. The transport returns HTTP 503 and no turn
|
|
50
|
+
* is dispatched. Once resolution recovers, the next request checks the actual allowance again.
|
|
51
|
+
* Successfully resolved absent or explicitly unlimited allowances still permit the turn.
|
|
52
|
+
* - **A budget IS configured but consumption is unreadable** → DENY
|
|
53
|
+
* ({@link A2ATokenBudgetDenialReason.CONSUMPTION_UNVERIFIABLE}). Here a cap demonstrably exists and
|
|
54
|
+
* we cannot prove the tenant is under it — the coherent choice for a spend boundary. This is safe
|
|
55
|
+
* to fail closed precisely because the counter lives in the application's primary datastore: if
|
|
56
|
+
* that is unreachable the application is down anyway, so this can never be the *sole* cause of an
|
|
57
|
+
* outage (unlike a Redis blip, which is why the burst throttle fails OPEN instead).
|
|
58
|
+
*
|
|
59
|
+
* ## Overage tolerance
|
|
60
|
+
*
|
|
61
|
+
* Token usage is only known AFTER a turn completes, so the gate compares ALREADY-ACCUMULATED
|
|
62
|
+
* consumption against the allowance — chosen over pre-charging an estimate, which would need a
|
|
63
|
+
* refund/reconcile path on every turn.
|
|
64
|
+
*
|
|
65
|
+
* The overage this admits is NOT "one turn": recording is fire-and-forget and the response returns
|
|
66
|
+
* before it lands, so every turn already in flight when the allowance is reached passes the gate on
|
|
67
|
+
* the same stale reading. The real bound is therefore the concurrency the burst throttle permits ×
|
|
68
|
+
* the size of those turns. That is acceptable for a spend cap (it is bounded and self-correcting on
|
|
69
|
+
* the next turn) but it must not be described as a single-turn guarantee.
|
|
70
|
+
*
|
|
71
|
+
```
|
|
@@ -27,6 +27,5 @@
|
|
|
27
27
|
* here — those are platform-managed and the mutation-boundary rules reject
|
|
28
28
|
* them.
|
|
29
29
|
*/
|
|
30
|
-
export
|
|
31
|
-
DeepPartial<BackendAuthoredManagedSections>;
|
|
30
|
+
export interface AppConfiguration_BackendAuthored extends DeepPartial<BackendAuthoredManagedSections> {}
|
|
32
31
|
```
|
package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md
ADDED
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# saas.backend.auth.federated-identity-provider-private-networks
|
|
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
|
+
* `auth.federatedIdentityProviderPrivateNetworks` — the network ranges a SELF-HOSTED identity provider
|
|
14
|
+
* (Keycloak, ADFS, an internal OIDC server) may live in, so this server can reach it from inside a
|
|
15
|
+
* private network.
|
|
16
|
+
*
|
|
17
|
+
* ── What it admits ─────────────────────────────────────────────────────────
|
|
18
|
+
* Every server-side request to an identity provider — OIDC discovery, the token exchange, userinfo, the
|
|
19
|
+
* JWKS key set, SAML metadata discovery and the SAML test-connection probe — refuses a private address
|
|
20
|
+
* by default in staging and production (and admits only loopback in development and test). Each range
|
|
21
|
+
* listed here widens that, for identity-provider requests only, to addresses inside the range. Every
|
|
22
|
+
* address a host name resolves to is checked at the moment of connection, and a redirect is never
|
|
23
|
+
* followed.
|
|
24
|
+
*
|
|
25
|
+
* ── What it can never admit, however broad ─────────────────────────────────
|
|
26
|
+
* Link-local addresses (`169.254.0.0/16`, `fe80::/10` — where the cloud instance-metadata service
|
|
27
|
+
* lives), unspecified and multicast space, and this machine's loopback unless the range is itself
|
|
28
|
+
* inside loopback (`127.0.0.1/32`). So even `0.0.0.0/0` does not expose the metadata service.
|
|
29
|
+
*
|
|
30
|
+
* ── Why a list of ranges, and not an on/off switch ─────────────────────────
|
|
31
|
+
* "Any private address" would also admit the metadata service and every cluster-internal service. A
|
|
32
|
+
* self-hosted identity provider lives in ONE known range; name that range (`10.20.0.0/16`, or a single
|
|
33
|
+
* host as `10.20.4.7/32`).
|
|
34
|
+
*
|
|
35
|
+
* ── Why CIDR only ──────────────────────────────────────────────────────────
|
|
36
|
+
* The decision is made on the ADDRESS each connection is opened to, which is what defeats DNS rebinding.
|
|
37
|
+
* A host name here would have to be resolved separately, reopening that gap — so write the addresses
|
|
38
|
+
* the name resolves to, as ranges.
|
|
39
|
+
*
|
|
40
|
+
* ── Why it is set by whoever deploys the application, and never on an SSO connection ──
|
|
41
|
+
* An SSO connection is authored by an organization or application administrator — the party this
|
|
42
|
+
* refusal protects the deployment against. A private address is reachable only when the DEPLOYMENT sits
|
|
43
|
+
* inside that network, and only the operator arranges that; so the escape belongs here, in the
|
|
44
|
+
* backend-authored configuration, not on the connection row. It is backend-only and never sent to the
|
|
45
|
+
* browser.
|
|
46
|
+
*
|
|
47
|
+
* Absent or empty means no private network is admitted — the fail-closed default. A SAML sign-in does
|
|
48
|
+
* not need this: it reaches the identity provider through the user's browser. Only what the SERVER
|
|
49
|
+
* fetches does.
|
|
50
|
+
*
|
|
51
|
+
* @example
|
|
52
|
+
* auth: {
|
|
53
|
+
* // The corporate Keycloak lives in the identity VLAN; nothing else private is reachable.
|
|
54
|
+
* federatedIdentityProviderPrivateNetworks: ['10.20.0.0/16'],
|
|
55
|
+
* }
|
|
56
|
+
*/
|
|
57
|
+
export const FederatedIdentityProviderPrivateNetworksSchema = z.array(
|
|
58
|
+
z.union([z.cidrv4(), z.cidrv6()]).refine((range) => parseDeclaredNetworkRange(range) !== undefined, {
|
|
59
|
+
error: 'Expected a CIDR range such as 10.20.0.0/16 (a single host is /32 or /128)',
|
|
60
|
+
}),
|
|
61
|
+
);
|
|
62
|
+
```
|