@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
|
@@ -36,12 +36,22 @@
|
|
|
36
36
|
* first; `customWindows` exists for the cases where those would be
|
|
37
37
|
* semantically wrong, NOT as a convenience for arbitrary tuning.
|
|
38
38
|
*
|
|
39
|
-
*
|
|
39
|
+
* Three consumption surfaces use this shape today:
|
|
40
40
|
* 1. **Resource operations** — `ResourceConfiguration_Operation_ApiCall.rateLimit?`
|
|
41
41
|
* on `API_CALL` / `API_CALL_WITH_CALLBACK` variants. Pre-flight enforced
|
|
42
42
|
* BEFORE execution-context creation, validation, and authorization. The
|
|
43
43
|
* bucket is always IP-keyed at this seam (authenticated identity is
|
|
44
44
|
* unknown by construction).
|
|
45
|
+
* 1b. **The SAME declaration, off HTTP.** An operation declaring a policy is
|
|
46
|
+
* also enforced wherever an AGENT dispatches it — as an MCP tool
|
|
47
|
+
* (`tools/call`) and as a Wildo function tool (`resourceReadTool` /
|
|
48
|
+
* `resourceWriteTool`). Those planes bypass Express, so they enforce the
|
|
49
|
+
* policy themselves and count the caller's CREDENTIAL rather than an IP:
|
|
50
|
+
* there is no socket, and the credential is the closest reading of the
|
|
51
|
+
* "per client" budget the IP expresses over HTTP. Each plane keeps its own
|
|
52
|
+
* bucket, so one client's agent traffic never spends another client's
|
|
53
|
+
* browser budget. Author the number once; it means the same thing on each
|
|
54
|
+
* plane rather than being split between them.
|
|
45
55
|
* 2. **Custom controllers** — `RateLimitBackendService.checkPolicy(req, res,
|
|
46
56
|
* policy, scopeKey, organizationId?, clientIdOverride?)` for hand-wired
|
|
47
57
|
* routes (auth, SCIM, marketing public endpoints). The bucket defaults
|
|
@@ -41,7 +41,29 @@ export type RelationshipHandlingMutationSettings = z.infer<typeof RelationshipHa
|
|
|
41
41
|
*/
|
|
42
42
|
export const RelationshipHandlingLifecycleOnParentDeleteSettingsSchema = z.object({
|
|
43
43
|
enabled: z.boolean().optional(),
|
|
44
|
-
/**
|
|
44
|
+
/**
|
|
45
|
+
* Execution TIMING of the cascade: `IMMEDIATE` inside the parent's own transaction, or `LAZY`
|
|
46
|
+
* deferred onto the background queue.
|
|
47
|
+
*
|
|
48
|
+
* ⚠️ **The two axes are NOT fully orthogonal — one combination refuses.** `LAZY` is implemented for
|
|
49
|
+
* the `DELETE` strategy only. Declaring `LAZY` beside `IMPERSONALIZE_AND_RETAIN` type-checks,
|
|
50
|
+
* configures, boots, and THROWS when a parent is actually deleted, because an asynchronous
|
|
51
|
+
* retain-and-scrub does not exist yet and the alternatives are both unacceptable (hard-deleting the
|
|
52
|
+
* child loses data the strategy exists to keep; skipping the scrub leaves personal data behind).
|
|
53
|
+
*
|
|
54
|
+
* | | `IMMEDIATE` | `LAZY` |
|
|
55
|
+
* |---|---|---|
|
|
56
|
+
* | `DELETE` | teardown inside the parent's transaction | deferred to the queue |
|
|
57
|
+
* | `IMPERSONALIZE_AND_RETAIN` | scrub + keep, direct children only | **refuses at cascade time** |
|
|
58
|
+
*
|
|
59
|
+
* What `LAZY` changes, and what it does not: the teardown is re-derived from the parent's CURRENT
|
|
60
|
+
* configuration when the job runs and goes through the same path `IMMEDIATE` uses, so grandchild
|
|
61
|
+
* recursion, file teardown and retrieval-chunk removal all still happen. It moves WHEN the teardown
|
|
62
|
+
* happens, never whether it happens — and if the job cannot be enqueued the parent's delete fails
|
|
63
|
+
* rather than silently orphaning the children.
|
|
64
|
+
*
|
|
65
|
+
* Omitted ⇒ `IMMEDIATE`.
|
|
66
|
+
*/
|
|
45
67
|
mode: z.enum(ChildLifecycleMode).optional(),
|
|
46
68
|
/**
|
|
47
69
|
* What the cascade DOES to the child — hard-delete vs impersonalize-and-retain (scrub the personal
|
|
@@ -78,6 +78,101 @@ export enum ResourceSystemAccessMode {
|
|
|
78
78
|
* framework infrastructure does NOT imply that an ACL bypass is acceptable
|
|
79
79
|
* for its data. Keep the two concepts separate.
|
|
80
80
|
*/
|
|
81
|
+
/**
|
|
82
|
+
* Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
|
|
83
|
+
*
|
|
84
|
+
* ## Why the application declares it rather than the framework knowing it
|
|
85
|
+
*
|
|
86
|
+
* The erasure lane is application-owned — four of the five marked sites for
|
|
87
|
+
* `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
|
|
88
|
+
* (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
|
|
89
|
+
* status vocabulary are the application's, so a collector queries it against that application's
|
|
90
|
+
* specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
|
|
91
|
+
* that is one application's modelling choice"*.
|
|
92
|
+
*
|
|
93
|
+
* So a collector may not know that a request is raised through a field called `channel` carrying a
|
|
94
|
+
* value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
|
|
95
|
+
* existed, three clauses of that demand had a durable row holding every fact they wanted and no way
|
|
96
|
+
* to find it (#1209): not a missing control, a control nobody could point at.
|
|
97
|
+
*
|
|
98
|
+
* ## It binds FIELDS, never values the framework invents
|
|
99
|
+
*
|
|
100
|
+
* Every member below names something the application already authored. The one value the
|
|
101
|
+
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
|
|
102
|
+
* application's OWN enum member, quoted back so a reader can tell the two populations apart. The
|
|
103
|
+
* framework supplies no vocabulary here and must never grow one.
|
|
104
|
+
*
|
|
105
|
+
* ## What is deliberately NOT declared
|
|
106
|
+
*
|
|
107
|
+
* The SCHEDULE. C3 asks that requests be executed on the declared schedule, and that schedule is
|
|
108
|
+
* already on the executing operation's `CRON_JOB` variant (`cronExpression`) — declaring it again
|
|
109
|
+
* here would be a second copy that can only ever disagree with the one the scheduler reads.
|
|
110
|
+
* `executionOperationIdentifier` names the operation; the schedule is read from it.
|
|
111
|
+
*/
|
|
112
|
+
export type ResourceSubjectErasureLane = {
|
|
113
|
+
/**
|
|
114
|
+
* How a row says WHO raised the request — the subject exercising their own right, or the
|
|
115
|
+
* controller acting on their behalf. C1's whole obligation is that the two are distinguishable.
|
|
116
|
+
*/
|
|
117
|
+
raisedBy: {
|
|
118
|
+
/** The field carrying it. Must be a persisted field of this resource. */
|
|
119
|
+
fieldName: string,
|
|
120
|
+
/**
|
|
121
|
+
* The value of that field meaning the SUBJECT raised it themselves. Every other value is read as
|
|
122
|
+
* controller-raised — stated this way round because a lane may grow a second controller channel
|
|
123
|
+
* without the declaration going stale, whereas enumerating the controller values could not.
|
|
124
|
+
*/
|
|
125
|
+
subjectValue: string,
|
|
126
|
+
},
|
|
127
|
+
/**
|
|
128
|
+
* The field carrying WHICH user raised a controller-raised request.
|
|
129
|
+
*
|
|
130
|
+
* Omitting it is a positive claim, not a gap: it says this lane admits no controller-raised
|
|
131
|
+
* request at all. A collector reads it that way and a row carrying a non-subject value then
|
|
132
|
+
* contradicts the declaration, which is a finding about the application rather than about the
|
|
133
|
+
* evidence.
|
|
134
|
+
*/
|
|
135
|
+
requesterFieldName?: string,
|
|
136
|
+
/** The field carrying the justification a controller-raised request was made on, where the lane records one. */
|
|
137
|
+
justificationFieldName?: string,
|
|
138
|
+
/** The field carrying the instant the request was executed or failed. C3 judges execution against it. */
|
|
139
|
+
completedAtFieldName: string,
|
|
140
|
+
/** The field carrying what the execution did. Its vocabulary is the application's. */
|
|
141
|
+
outcomeFieldName: string,
|
|
142
|
+
/**
|
|
143
|
+
* The operation a SUBJECT uses to withdraw their own pending request (C2). Named rather than
|
|
144
|
+
* inferred: "the operation that cancels" is not derivable from an operation vocabulary, and
|
|
145
|
+
* guessing it would make the evidence depend on a naming convention no application agreed to.
|
|
146
|
+
*/
|
|
147
|
+
withdrawalOperationIdentifier: string,
|
|
148
|
+
/**
|
|
149
|
+
* How a WITHDRAWN row is recognisable afterwards — the same shape as {@link raisedBy}, and for the
|
|
150
|
+
* same reason: the vocabulary is the application's.
|
|
151
|
+
*
|
|
152
|
+
* C2 asks for the withdrawal door AND for "any cancelled rows", and those are two different
|
|
153
|
+
* questions. The door is answered from {@link withdrawalOperationIdentifier} — is the operation
|
|
154
|
+
* reachable to a subject while the request is pending — and needs no data at all. The rows need a
|
|
155
|
+
* marker, and there is nothing to derive one from: withdrawal and execution both leave a request in
|
|
156
|
+
* a terminal state, so a reader that knows only `completedAtFieldName` cannot tell "the subject
|
|
157
|
+
* changed their mind" from "the sweep ran".
|
|
158
|
+
*
|
|
159
|
+
* OPTIONAL, because an application may not model withdrawal as a value at all — it may delete the
|
|
160
|
+
* row, or move it. Omitting it says the count is unavailable, and a collector reports that rather
|
|
161
|
+
* than guessing; it never turns into a zero, which would read as "nobody withdrew anything".
|
|
162
|
+
*
|
|
163
|
+
* Note an EMPTY withdrawal set is explicitly not a deficiency in the demand — people do not have
|
|
164
|
+
* to change their minds — so this exists to make the number REPORTABLE, never to make it a target.
|
|
165
|
+
*/
|
|
166
|
+
withdrawnMarker?: {
|
|
167
|
+
/** The field carrying it. Must be a persisted field of this resource. */
|
|
168
|
+
fieldName: string,
|
|
169
|
+
/** The value of that field meaning the SUBJECT withdrew the request before it executed. */
|
|
170
|
+
withdrawnValue: string,
|
|
171
|
+
},
|
|
172
|
+
/** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
|
|
173
|
+
executionOperationIdentifier: string,
|
|
174
|
+
};
|
|
175
|
+
|
|
81
176
|
export type ResourceSystemAccessPolicy = {
|
|
82
177
|
/** Governs `readAsSystem`. Omitted ⇒ FORBIDDEN. */
|
|
83
178
|
read?: ResourceSystemAccessMode,
|
|
@@ -101,10 +196,22 @@ export type ResourceSystemAccessPolicy = {
|
|
|
101
196
|
* Auto-derived to `ALLOWED` by the factory when a resource opts into
|
|
102
197
|
* `retentionPolicy`; never authored by hand in the common case.
|
|
103
198
|
*
|
|
104
|
-
* **LIVE.** `readRetainedAsSystem` / `listRetainedAsSystem` exist and are enforced:
|
|
105
|
-
* asserted fail-closed, a privileged human role is required, and every reveal emits a
|
|
106
|
-
* human-attributed `RETAINED_DATA_ACCESS` audit event.
|
|
107
|
-
*
|
|
199
|
+
* **LIVE, and REACHABLE.** `readRetainedAsSystem` / `listRetainedAsSystem` exist and are enforced:
|
|
200
|
+
* the verb is asserted fail-closed, a privileged human role is required, and every reveal emits a
|
|
201
|
+
* human-attributed `RETAINED_DATA_ACCESS` audit event.
|
|
202
|
+
*
|
|
203
|
+
* "Reachable" is the half that was missing until #490, and the distinction is worth keeping. The
|
|
204
|
+
* primitives were correct and enforced from the day M5b landed — and had **no caller**, so the only
|
|
205
|
+
* route an operator actually had to a retained record was a database console: the unaudited path
|
|
206
|
+
* they were built to replace. `users | read_retained` is the operator surface that closes it, an
|
|
207
|
+
* authenticated `APP_ADMIN_SUPER_ADMIN` operation carrying a mandatory justification.
|
|
208
|
+
*
|
|
209
|
+
* A resource that derives this grant and exposes no such operation is reachable by nothing. That
|
|
210
|
+
* is a defensible state — not every retention resource needs an operator door — but it should be a
|
|
211
|
+
* decision rather than an oversight, and `retained-see-through-operator-surface.test.ts` is what
|
|
212
|
+
* makes it one.
|
|
213
|
+
*
|
|
214
|
+
* (This block previously said the primitives were "wired in a later phase" — false since M5b.)
|
|
108
215
|
*/
|
|
109
216
|
seeRetained?: ResourceSystemAccessMode,
|
|
110
217
|
|
|
@@ -308,6 +415,9 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
308
415
|
*/
|
|
309
416
|
httpApiBinding?: HttpApiResourceBindingAuthored,
|
|
310
417
|
|
|
418
|
+
/** REQUIRED when `persistenceAdapter` is INTROSPECTION; meaningless otherwise. */
|
|
419
|
+
introspectionBinding?: IntrospectionResourceBinding,
|
|
420
|
+
|
|
311
421
|
/**
|
|
312
422
|
* OPTIONAL inbound ETL pipeline on an ordinary LOCAL resource — "some resources local, some
|
|
313
423
|
* remote, ETL between them" (partial-resource coverage, model v3; PR-3). FORBIDDEN on an
|
|
@@ -366,6 +476,14 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
366
476
|
* explicit alternative authorization.
|
|
367
477
|
*/
|
|
368
478
|
systemAccessPolicy?: ResourceSystemAccessPolicy,
|
|
479
|
+
|
|
480
|
+
/**
|
|
481
|
+
* Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
|
|
482
|
+
* evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
|
|
483
|
+
* most resources are not, and an application that never built an erasure lane has declared none
|
|
484
|
+
* rather than failed a control. See {@link ResourceSubjectErasureLane}.
|
|
485
|
+
*/
|
|
486
|
+
subjectErasureLane?: ResourceSubjectErasureLane,
|
|
369
487
|
coreOperations: TCoreOperationEnum[],
|
|
370
488
|
customOperation?: TCustomOperationEnum, // default undefined
|
|
371
489
|
operationsConfiguration : { [K in ValidOperationKeys<TCustomOperationEnum, TCoreOperationEnum>]: OperationConfig_ForKey<K, TMainSchema> }
|
|
@@ -31,10 +31,11 @@
|
|
|
31
31
|
* relies on, mirrored for reads. The viewer therefore needs no read access to the
|
|
32
32
|
* related row itself (e.g. another member's `user_profile`).
|
|
33
33
|
*
|
|
34
|
-
* @remarks
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
34
|
+
* @remarks Both persistence adapters resolve it: the MongoDB and PostgreSQL resource
|
|
35
|
+
* repositories each implement `findFieldValuesByJoinField` with the same contract
|
|
36
|
+
* (the PostgreSQL half landed with #1100; until then a PostgreSQL-backed related
|
|
37
|
+
* resource silently degraded every label to `fallback`). Import from
|
|
38
|
+
* `@wildo-ai/saas-models`.
|
|
38
39
|
*
|
|
39
40
|
* @example
|
|
40
41
|
* // organizationMembers labels itself by the linked user's name. firstName/
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
# saas.models.resource-config.metered-usage-recording
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Declares that a successful operation CONSUMES a metered product, so the engine records usage
|
|
14
|
+
* against the caller's billing account (#415).
|
|
15
|
+
*
|
|
16
|
+
* Before this existed, `UsageMeteringBackendService.recordUsage` had no caller anywhere: a product
|
|
17
|
+
* could be declared METERED, priced and synced to the billing provider, and nothing in the framework
|
|
18
|
+
* ever wrote a usage row. An application could only meter by reaching into a backend service by hand
|
|
19
|
+
* from a custom implementation, which is not an authoring surface — it is a workaround.
|
|
20
|
+
*
|
|
21
|
+
* Declared per OPERATION, beside `userNotifications` and `m2mNotifications`, because it is the same
|
|
22
|
+
* kind of thing: an authored consequence of an operation succeeding, expressed where the operation is
|
|
23
|
+
* expressed rather than buried in a handler.
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* // One unit per successful export, whatever the export contains.
|
|
27
|
+
* [CoreResourceOperation.CREATE]: {
|
|
28
|
+
* variants: [ ... ],
|
|
29
|
+
* recordsUsage: { productKey: 'report_exports' },
|
|
30
|
+
* }
|
|
31
|
+
*
|
|
32
|
+
* @example
|
|
33
|
+
* // Usage that VARIES per operation, read from the row that was written.
|
|
34
|
+
* [Reports_Operations.RENDER]: {
|
|
35
|
+
* variants: [ ... ],
|
|
36
|
+
* recordsUsage: { productKey: 'rendered_pages', quantityFromResultField: 'pageCount' },
|
|
37
|
+
* }
|
|
38
|
+
*/
|
|
39
|
+
export interface MeteredUsageRecordingDefinition {
|
|
40
|
+
/**
|
|
41
|
+
* The METERED product's key.
|
|
42
|
+
*
|
|
43
|
+
* Convention, unchanged from the flush: the product key IS the provider's meter event name. Usage
|
|
44
|
+
* is only recorded when the caller's billing account holds an ACTIVE or TRIALING subscription
|
|
45
|
+
* containing a METERED product with this key — an operation declared against a product nobody has
|
|
46
|
+
* bought records nothing, and warns.
|
|
47
|
+
*/
|
|
48
|
+
productKey: string;
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* Fixed units per successful operation. Defaults to 1.
|
|
52
|
+
*
|
|
53
|
+
* Mutually exclusive with {@link quantityFromResultField}: a usage amount has one source, and
|
|
54
|
+
* letting both apply would make "which one wins" a rule nobody could read off the declaration.
|
|
55
|
+
*/
|
|
56
|
+
quantity?: number;
|
|
57
|
+
|
|
58
|
+
/**
|
|
59
|
+
* Dot path to a NUMERIC field on the written row, for usage that varies per operation — pages
|
|
60
|
+
* rendered, bytes stored, rows exported.
|
|
61
|
+
*
|
|
62
|
+
* Read from the operation's RESULT rather than its input, deliberately: the input is what was
|
|
63
|
+
* asked for and the result is what happened, and only the second is what a customer should be
|
|
64
|
+
* billed for. A path that resolves to a non-number records nothing and warns, rather than
|
|
65
|
+
* defaulting to 1 — silently billing the wrong amount is worse than billing nothing and saying so.
|
|
66
|
+
*/
|
|
67
|
+
quantityFromResultField?: string;
|
|
68
|
+
}
|
|
69
|
+
```
|
|
@@ -54,6 +54,8 @@ export type ResourceConfiguration_Operation_ApiCall<
|
|
|
54
54
|
httpVerb: HttpMethod;
|
|
55
55
|
isApiKeyAccessDisabled: boolean; // default false
|
|
56
56
|
isBulkOperation: boolean; // default false
|
|
57
|
+
/** On a bulk twin: the resolved limit on rows per request (`resolveBulkOperationMaxSelection`). */
|
|
58
|
+
bulkOperationMaxSelection?: number;
|
|
57
59
|
initiatorInfos?: ResourceConfiguration_Operation_UrlInitiatorInfo[];
|
|
58
60
|
|
|
59
61
|
tokenAuthentication?: TokenAuthenticationConfig; // default undefined
|
|
@@ -62,9 +64,20 @@ export type ResourceConfiguration_Operation_ApiCall<
|
|
|
62
64
|
/**
|
|
63
65
|
* Resolved per-endpoint rate-limit policy (forwarded by the resource
|
|
64
66
|
* configuration factory from the variant builder parameters). Read at
|
|
65
|
-
* runtime by
|
|
67
|
+
* runtime by three enforcers, one per plane that can dispatch this
|
|
68
|
+
* operation: `RateLimitBackendService.checkPolicyForVariant` at the
|
|
66
69
|
* controller pre-flight seam (`controller-resource.backend.service.ts`
|
|
67
|
-
* → `doOperation`).
|
|
70
|
+
* → `doOperation`), `McpServerBackendService.assertOperationRateLimitPolicy`
|
|
71
|
+
* on the MCP tool plane, and `assertDeclaredOperationRateLimit` on the agent
|
|
72
|
+
* function-tool plane (`function-tools.backend.definitions.ts`). Only the
|
|
73
|
+
* first is IP-keyed; the other two count the caller's credential, because
|
|
74
|
+
* there is no socket to key on.
|
|
75
|
+
*
|
|
76
|
+
* **A new plane that dispatches a resource operation off HTTP owes its own
|
|
77
|
+
* call to `checkPolicyForSubject`.** Nothing structural enforces that — the
|
|
78
|
+
* field is simply not read where nobody reads it — which is how the MCP and
|
|
79
|
+
* function-tool planes each shipped unthrottled for the operations that
|
|
80
|
+
* declare a budget.
|
|
68
81
|
*
|
|
69
82
|
* Auto-variants (`SUMMARY` / `CONTEXT` for READ/LIST) inherit this
|
|
70
83
|
* field from their default URL-bearing variant (`API_CALL` or
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# saas.models.resource-config.operation-auditable-event
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Declarative control over this variant's audit emission.
|
|
14
|
+
*
|
|
15
|
+
* **The baseline needs no declaration.** Every framework-managed write-shaped `HIGH` / `CRITICAL` variant emits
|
|
16
|
+
* `RESOURCE_OPERATION_PERFORMED` automatically — `riskLevel` is already the framework's canonical
|
|
17
|
+
* danger axis (it drives MCP destructive hints, frontend danger-zone placement and CRITICAL typed
|
|
18
|
+
* confirmation), and a risk-driven floor is fail-closed by omission. A declarative-ONLY mechanism
|
|
19
|
+
* was rejected for exactly that reason: it fails OPEN when an author forgets, which is how 20 event
|
|
20
|
+
* types came to be declared in `CoreAuditableEventType` and wired to nothing.
|
|
21
|
+
*
|
|
22
|
+
* This declaration selects below-floor writes and explicit operator justification evidence.
|
|
23
|
+
*/
|
|
24
|
+
export type ResourceOperation_AuditableEvent = {
|
|
25
|
+
/**
|
|
26
|
+
* Emit for this variant even though its `riskLevel` is below the automatic floor.
|
|
27
|
+
*
|
|
28
|
+
* For a `MEDIUM` / `LOW` verb whose danger is not proportional to its blast radius — the risk
|
|
29
|
+
* level answers "how alarming is the UI affordance", which is a related but not identical
|
|
30
|
+
* question to "is this evidence an auditor needs".
|
|
31
|
+
*/
|
|
32
|
+
auditBelowRiskFloor?: boolean;
|
|
33
|
+
/**
|
|
34
|
+
* Top-level request string carrying the operator's justification, e.g. `reasonField: 'reason'`.
|
|
35
|
+
* Captured before custom input transformations and recorded as `eventData.reason` after commit.
|
|
36
|
+
* This explicitly authorizes retaining that text in audit destinations; do not select a secret
|
|
37
|
+
* or an unrestricted business-data field. Bound the text in the request DTO and tell callers
|
|
38
|
+
* to supply an operational justification. Other request values are never copied by this option.
|
|
39
|
+
* This does not change the risk floor: below-floor writes still need `auditBelowRiskFloor`.
|
|
40
|
+
* OVERRIDE_ALL implementations own their persistence and must emit their committed audit event.
|
|
41
|
+
*/
|
|
42
|
+
reasonField?: string;
|
|
43
|
+
};
|
|
44
|
+
|
|
45
|
+
/*
|
|
46
|
+
* Three consequences of the risk-driven floor an author has to design around.
|
|
47
|
+
*
|
|
48
|
+
* - **A high-risk READ leaves no operation-level row here.** The exclusion is deliberate and is
|
|
49
|
+
* guarded by a test rather than merely noted: the event asserts an EFFECT, and a read had none.
|
|
50
|
+
* Neither risk nor `auditBelowRiskFloor` overrides this exclusion. `.isAuditEvidence()` selects
|
|
51
|
+
* write-evidence values; it does not trigger read auditing. One-time response disclosure is a
|
|
52
|
+
* separate controller mechanism for backend-only fields returned at creation and ephemeral
|
|
53
|
+
* response fields. Ordinary business reads needing evidence require an appropriate explicit
|
|
54
|
+
* audit event at their owning service, not a misleading field marker.
|
|
55
|
+
* - **A bulk write records submitted field NAMES without prior values.** The before-image is fetched
|
|
56
|
+
* only when exactly one row is selected, so a bulk update cannot tell a reviewer what a field
|
|
57
|
+
* used to hold.
|
|
58
|
+
* - **There is no suppression, and the second row is not a duplicate.** An operation with its own
|
|
59
|
+
* purpose-built event emits BOTH. The generic row carries the operation identity, the cascade
|
|
60
|
+
* correlation, the actor's roles as they stood and the execution type — and no purpose-built
|
|
61
|
+
* event carries any of those, so the two state different facts about one action.
|
|
62
|
+
*
|
|
63
|
+
* Note `riskLevel` drives audit emission and the interface's danger affordances, and drives NO
|
|
64
|
+
* authorization decision — re-authentication is `requiresStepUpAuthentication`, declared separately.
|
|
65
|
+
*/
|
|
66
|
+
```
|
|
@@ -33,6 +33,8 @@ export type ResourceConfiguration_Operation_Base<
|
|
|
33
33
|
operationIdentifier : TCustomOperationEnum | TCoreOperationEnum,
|
|
34
34
|
isOperationDefault : boolean, // default true
|
|
35
35
|
serviceRuntimeMode: ResourceOperation_ServiceRuntimeMode; //default ResourceOperation_ServiceRuntimeMode.INLINE
|
|
36
|
+
/** Validated operation policy, shared by authored and generated variants. */
|
|
37
|
+
queueConfig?: ResourceConfiguration_QueueConfig;
|
|
36
38
|
generatedOperation?: ResourceConfiguration_GeneratedOperationMetadata;
|
|
37
39
|
|
|
38
40
|
requestDto?: z.ZodSchema<any>;
|
|
@@ -72,8 +74,29 @@ export type ResourceConfiguration_Operation_Base<
|
|
|
72
74
|
*/
|
|
73
75
|
repositoryDto?: z.ZodSchema<any>;
|
|
74
76
|
|
|
75
|
-
|
|
77
|
+
/**
|
|
78
|
+
* `EVENT_COUNTER` badge writes this operation performs after it succeeds.
|
|
79
|
+
*
|
|
80
|
+
* `badgeRef` is a badge KEY (`<scope>:<identifier>`), NOT a bare identifier, and it is what
|
|
81
|
+
* decides which badge is written — including at WHICH SCOPE. The scope used to be inferred from
|
|
82
|
+
* this operation's own `resourcePrimaryScope`, which meant an operation on a user-scoped
|
|
83
|
+
* resource wrote a user-scoped counter even when the definition it named lived at organization
|
|
84
|
+
* scope: a row no definition declared, that no screen could render, reported nowhere.
|
|
85
|
+
*
|
|
86
|
+
* Every `badgeRef` is resolved against the registered `notificationBadgeDefinitions` at
|
|
87
|
+
* CONFIGURATION time and the application refuses to start when one does not resolve. Only the
|
|
88
|
+
* scopeId — whose badge — is left to the request.
|
|
89
|
+
*/
|
|
90
|
+
notificationBadgeOperations: { badgeRef: NotificationBadgeKey, operation: NotificationBadgeOperation }[];
|
|
76
91
|
userNotifications: UserNotificationDefinition[];
|
|
77
92
|
m2mNotifications: M2MNotificationDefinitionWithoutIdentifier[];
|
|
93
|
+
/** Authored metered-usage recording for this operation; `undefined` when it consumes nothing. */
|
|
94
|
+
recordsUsage?: MeteredUsageRecordingDefinition;
|
|
95
|
+
/**
|
|
96
|
+
* The purpose this operation's own processing rests on, and what a missing grant costs (#1258
|
|
97
|
+
* Step 3). `undefined` means this operation declares nothing beyond whatever
|
|
98
|
+
* `serviceConsentRequirement` already requires application-wide.
|
|
99
|
+
*/
|
|
100
|
+
consentGate?: ResourceOperationConsentGateDeclaration;
|
|
78
101
|
}
|
|
79
102
|
```
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# saas.models.resource-config.operation-cron-job
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* A CRON_JOB variant — the declaration that makes an operation run on a schedule.
|
|
14
|
+
*
|
|
15
|
+
* The job does not run inside your application's own process on a timer. Your application PUBLISHES
|
|
16
|
+
* its declared schedules to the platform scheduler at startup, and the scheduler later delivers a
|
|
17
|
+
* signed tick back onto your application's queue. Four consequences follow, and none of them is
|
|
18
|
+
* visible from this type:
|
|
19
|
+
*
|
|
20
|
+
* **This declaration is interpreted in UTC.** There is no timezone field here: automatic resource
|
|
21
|
+
* schedule extraction sends `UTC`. `'0 3 * * *'` is 03:00 UTC wherever your users are. The lower-level
|
|
22
|
+
* authenticated jobs-sync API supports an explicit timezone; that does not give this declaration
|
|
23
|
+
* local-time or daylight-saving behavior.
|
|
24
|
+
*
|
|
25
|
+
* **Editing this declaration takes effect through startup synchronization.** There is no file watch
|
|
26
|
+
* that retimes a running application's jobs when its source changes. The lower-level synchronization
|
|
27
|
+
* API can update jobs while the application is running; its full replacement contract is distinct
|
|
28
|
+
* from this declaration-driven startup path. Keep one owner for the complete submitted schedule set.
|
|
29
|
+
*
|
|
30
|
+
* **A failed sync does not fail startup.** The application boots, one capped in-process retry is kept
|
|
31
|
+
* pending, and until it succeeds the scheduler keeps running the schedule it was last given. So a
|
|
32
|
+
* retimed job that appears not to have moved is the expected shape of a sync that has not landed yet,
|
|
33
|
+
* not a broken expression.
|
|
34
|
+
*
|
|
35
|
+
* **The scheduler records that it PUBLISHED the tick, never that your application ran it.** A tick
|
|
36
|
+
* that reached the broker and then failed inside the application still reads as a successful run on
|
|
37
|
+
* the scheduler's side, so verify a scheduled job by its effect in your own storage rather than by
|
|
38
|
+
* the platform's execution record.
|
|
39
|
+
*/
|
|
40
|
+
type ResourceConfiguration_OperationVariant_CronJob_BuilderParameters = ResourceConfiguration_OperationVariant_Base & {
|
|
41
|
+
/** Recovery contract for this exact scheduled handler; undeclared effects require manual review after an unknown outcome. */
|
|
42
|
+
scheduledRecovery?: Partial<ScheduledRecoveryPolicy>;
|
|
43
|
+
variantType : ResourceOperationVariantType.CRON_JOB,
|
|
44
|
+
/** Standard five-field cron expression, interpreted in UTC. See the note above this type. */
|
|
45
|
+
cronExpression: string,
|
|
46
|
+
/**
|
|
47
|
+
* Explicit response contract for a CRON_JOB custom operation whose return shape
|
|
48
|
+
* is NOT the resource row implied by `resourceOperationLike`. A scheduled
|
|
49
|
+
* generator/sweeper (e.g. a recurring-occurrence generator) borrows a core verb
|
|
50
|
+
* (UPDATE/CREATE) for its repo/DTO semantics but returns a RUN SUMMARY, not an
|
|
51
|
+
* occurrence. The factory already reads `customResponseDto` off any variant
|
|
52
|
+
* params (`resources-config.shared.factory.ts`) and warns when a borrowed-verb
|
|
53
|
+
* custom op omits it — this exposes it on the CRON_JOB params so the cron op can
|
|
54
|
+
* declare its true return shape instead of inheriting the verb's occurrence
|
|
55
|
+
* -shaped envelope (which the executor would reject the summary against).
|
|
56
|
+
*/
|
|
57
|
+
customResponseDto?: z.ZodSchema<any>,
|
|
58
|
+
}
|
|
59
|
+
```
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# saas.models.resource-config.operation-idempotency-key
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Whether this variant takes the `Idempotency-Key` request header, so a caller's retry receives the first request's
|
|
14
|
+
* outcome instead of running the effect again.
|
|
15
|
+
*
|
|
16
|
+
* Declare it on a mutation whose effect happens OUTSIDE your database — a payment provider, an email, a third-party
|
|
17
|
+
* write — where a retry after a lost response is the duplicate you cannot roll back. A pure database write already
|
|
18
|
+
* gets optimistic locking from `If-Match`; this is for what a transaction cannot undo.
|
|
19
|
+
*
|
|
20
|
+
* - `ACCEPTED`: the header is honored when sent, and a request without it runs unkeyed. Right for an effect that
|
|
21
|
+
* converges when repeated (cancelling something twice leaves it cancelled).
|
|
22
|
+
* - `REQUIRED`: a request without the header is refused with 400 (`idempotency_key_required`). Right for an effect
|
|
23
|
+
* whose repeat is a second, different effect (adding an item twice adds two).
|
|
24
|
+
*
|
|
25
|
+
* What the framework does for you: parses and bounds the header (a quoted String or a bare token of 1 to 200 printable
|
|
26
|
+
* ASCII characters, otherwise 400 `idempotency_key_malformed`); refuses the header on a MUTATION that does not declare
|
|
27
|
+
* this (400 `idempotency_key_not_accepted` — ignoring it would silently leave the caller's retry undeduplicated), while a
|
|
28
|
+
* read ignores it; documents the header in the OpenAPI reference; makes the framework's own HTTP client send one key per
|
|
29
|
+
* call and reuse it on its automatic retries; and hands the key to your implementation as `utils.requestIdempotencyKey`,
|
|
30
|
+
* removing it from the options so that forwarding `utils.serviceOptions` to another operation never passes your caller's
|
|
31
|
+
* key along.
|
|
32
|
+
*
|
|
33
|
+
* Honored on the `INLINE` runtime mode only: a key sent to a queued or background variant is refused, because those
|
|
34
|
+
* paths cannot carry it to the implementation.
|
|
35
|
+
*
|
|
36
|
+
* Mutations only: a read-shaped variant (a read, list, search or count, or a custom operation borrowing one of those
|
|
37
|
+
* verbs) that declares it stops the application from starting. A read-shaped variant claims that repeating it changes
|
|
38
|
+
* nothing, so the key would protect no retry and `REQUIRED` would only refuse harmless repeats. A custom operation whose
|
|
39
|
+
* effect must not run twice is not a read: borrow a mutation verb in `resourceOperationLike` and declare the key there.
|
|
40
|
+
*
|
|
41
|
+
* What it does NOT do: remember outcomes. Deciding that a key was seen, replaying its result and refusing the same key
|
|
42
|
+
* sent with a different request (422, `ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`) is the implementation's
|
|
43
|
+
* job, because only it knows what "the same request" and "its result" mean for its effect.
|
|
44
|
+
*
|
|
45
|
+
* @example a provider-backed mutation that must not run twice
|
|
46
|
+
* variants: [{
|
|
47
|
+
* variantType: ResourceOperationVariantType.API_CALL,
|
|
48
|
+
* roles: [CORE_ORG_ROLES.ORG_OWNER],
|
|
49
|
+
* riskLevel: ResourceOperationRiskLevel.HIGH,
|
|
50
|
+
* idempotencyKey: ResourceOperationIdempotencyKeyRequirement.REQUIRED,
|
|
51
|
+
* requestDto: AddSeatRequest_Schema,
|
|
52
|
+
* }]
|
|
53
|
+
*/
|
|
54
|
+
idempotencyKey?: ResourceOperationIdempotencyKeyRequirement;
|
|
55
|
+
```
|
|
@@ -16,10 +16,11 @@
|
|
|
16
16
|
* — this is a field on an operation variant inside a resource's `operations` config.
|
|
17
17
|
*
|
|
18
18
|
* Opt-in + FAIL-CLOSED: absent or `false` ⇒ the operation is NOT a tool. Only DEFAULT,
|
|
19
|
-
* non-bulk, URL-bearing
|
|
20
|
-
*
|
|
21
|
-
*
|
|
22
|
-
*
|
|
19
|
+
* non-bulk, URL-bearing API_CALL or API_CALL_WITH_CALLBACK operations are eligible.
|
|
20
|
+
* Machine principals reach ORGANIZATIONS / APPLICATION resources; user-delegated principals
|
|
21
|
+
* additionally reach USER_SELF. The verified principal selects the discovery scope set;
|
|
22
|
+
* anonymous discovery has no reachable tools. A USER_SELF opt-in therefore has no machine-callable
|
|
23
|
+
* effect but can be listed for a delegated user, subject to the remaining eligibility gates.
|
|
23
24
|
*
|
|
24
25
|
* `description` is the agent-facing tool description — the prose the calling agent reads to
|
|
25
26
|
* decide when to use the tool. When omitted, the tool description falls back to the resource
|