@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -0,0 +1,246 @@
|
|
|
1
|
+
# File upload grant — the contract behind `…__upload_grant__<field>` tools
|
|
2
|
+
|
|
3
|
+
Read this when an exposed CREATE or UPDATE carries a `z_file()` field and you need to know what an
|
|
4
|
+
agent receives from the derived upload-grant tool, what it does with it, and what bounds apply.
|
|
5
|
+
|
|
6
|
+
- Every exposed default CREATE / UPDATE whose request carries a user-uploadable file field ALSO
|
|
7
|
+
advertises `<resource>__<operation>__upload_grant__<fieldSegment>` (e.g.
|
|
8
|
+
`todos__create__upload_grant__attachments`). You author nothing for it — it is derived from the same
|
|
9
|
+
`mcp: { exposed: true }` opt-in and inherits the parent's gating.
|
|
10
|
+
- Calling it mints a single-use grant and returns the object below. Two ways to redeem it, in order of
|
|
11
|
+
preference: `uploadCommand` when the agent's host can execute a command (the bytes never cross the
|
|
12
|
+
model channel); `uploadPageUrl` when it cannot — the agent shows that link to the person, who drops
|
|
13
|
+
the file in their browser. The page is the FALLBACK, not the design: it reads the grant, shows the
|
|
14
|
+
target field, size limit, accepted types and expiry, accepts exactly one file, and then reports what
|
|
15
|
+
the application recorded. `uploadPageUrl` is `null` on a headless application.
|
|
16
|
+
- The returned `uploadUrl` is paired with `uploadHeader`: the generated commands send the token in
|
|
17
|
+
that header. This is not a guarantee that tokens never occur in URLs. `uploadPageUrl` and
|
|
18
|
+
`statusUrl` carry the token, and query-token redemption is also supported. Treat those links as
|
|
19
|
+
bearer credentials: share them only with the intended uploader and keep them out of public logs.
|
|
20
|
+
- Declare what you know when minting — `name`, `mimeType`, `size` are optional inputs. A declared file
|
|
21
|
+
the field could never accept (too large, wrong type) is refused at mint time, before a grant is
|
|
22
|
+
spent; undeclared facts are simply checked on receipt.
|
|
23
|
+
- The agent then reads the produced `fileId` (from the upload response, or from `statusUrl` when a
|
|
24
|
+
person uploaded — the status turns `redeemed` and carries `file.fileId`) and passes it as the field's
|
|
25
|
+
`fileId` / `fileIds` in the parent tool.
|
|
26
|
+
|
|
27
|
+
## Import Origins
|
|
28
|
+
|
|
29
|
+
- `@wildo-ai/saas-models`
|
|
30
|
+
|
|
31
|
+
## Source Excerpts
|
|
32
|
+
|
|
33
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
34
|
+
|
|
35
|
+
```typescript
|
|
36
|
+
*
|
|
37
|
+
* Lifetime bounds of an upload grant, in minutes. The ceiling is fixed by the framework and enforced
|
|
38
|
+
* when the grant is minted — a request above it is REFUSED, never clamped, so a caller that asked for
|
|
39
|
+
* two hours learns from an error that the bound is sixty minutes rather than from an expiry it did not
|
|
40
|
+
* expect. The bound is the framework's to own because the grant is designed to leave the trust
|
|
41
|
+
* boundary: it lands in an AI agent's transcript, a model provider's logs, a shell history.
|
|
42
|
+
*/
|
|
43
|
+
export const FILE_UPLOAD_GRANT_DEFAULT_MINUTES = 15;
|
|
44
|
+
export const FILE_UPLOAD_GRANT_ABSOLUTE_MAX_MINUTES = 60;
|
|
45
|
+
|
|
46
|
+
/**
|
|
47
|
+
* Which write the grant is for. A grant minted on the CREATE upload route uploads a file that a
|
|
48
|
+
* later CREATE will reference; one minted on the UPDATE route (`…/{resourceId}/files/<field>`) is
|
|
49
|
+
* bound to that row. The two routes authorize differently, so a grant may not cross from one to the
|
|
50
|
+
* other — the upload middleware checks this against the route it is presented on.
|
|
51
|
+
*/
|
|
52
|
+
export const FILE_UPLOAD_GRANT_OPERATIONS = [CoreResourceOperation.CREATE, CoreResourceOperation.UPDATE] as const;
|
|
53
|
+
export type FileUploadGrantOperation = (typeof FILE_UPLOAD_GRANT_OPERATIONS)[number];
|
|
54
|
+
/** Derived from `CoreResourceOperation` — the named source — rather than a second enum spelling the same two words. */
|
|
55
|
+
export const FileUploadGrantOperationSchema: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }> = z.enum(FILE_UPLOAD_GRANT_OPERATIONS);
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* Lifecycle of a grant as the status read reports it. Derived from the token row — `isConsumed`,
|
|
59
|
+
* `expiresAt`, `revokedAt` — never stored, so it cannot drift from the row.
|
|
60
|
+
*/
|
|
61
|
+
export enum FileUploadGrantState {
|
|
62
|
+
/** Minted, unexpired, unrevoked, not yet redeemed: an upload will be accepted. */
|
|
63
|
+
PENDING = 'pending',
|
|
64
|
+
/** Redeemed by exactly one upload. `file` names what it produced when the write-back succeeded. */
|
|
65
|
+
REDEEMED = 'redeemed',
|
|
66
|
+
/** Past `expiresAt` without being redeemed. Mint a new one. */
|
|
67
|
+
EXPIRED = 'expired',
|
|
68
|
+
/** Revoked by the minter or an administrator before redemption. */
|
|
69
|
+
REVOKED = 'revoked',
|
|
70
|
+
}
|
|
71
|
+
export const FileUploadGrantStateSchema: z.ZodEnum<typeof FileUploadGrantState> = z.enum(FileUploadGrantState);
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* The `metadata` a FILE_UPLOAD_GRANT token carries — the ROUTE binding, as opposed to the identity
|
|
75
|
+
* the typed token fields carry. The upload middleware reads this; the execution-context creator
|
|
76
|
+
* deliberately does not.
|
|
77
|
+
*/
|
|
78
|
+
export const FileUploadGrantMetadataSchema: z.ZodObject<{
|
|
79
|
+
fieldName: z.ZodString;
|
|
80
|
+
operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
|
|
81
|
+
minter: z.ZodObject<{ entityType: z.ZodEnum<typeof FileUploaderEntityType>; id: z.ZodString }>;
|
|
82
|
+
uploadUrl: z.ZodString;
|
|
83
|
+
producedFileId: z.ZodOptional<z.ZodString>;
|
|
84
|
+
}> = z.object({
|
|
85
|
+
/** The `z_file()` field the upload lands on, as authored (dotted for nested fields). */
|
|
86
|
+
fieldName: z.string().min(1),
|
|
87
|
+
operation: FileUploadGrantOperationSchema,
|
|
88
|
+
/**
|
|
89
|
+
* Who minted — recorded so the uploaded file is attributed to a PERSON or MACHINE, not to the
|
|
90
|
+
* grant.
|
|
91
|
+
*
|
|
92
|
+
* `entityType` is the ENUM, not a string. It was `z.string().min(1)` until 2026-09-08, with the
|
|
93
|
+
* stated reason that "the uploader enum lives in `zod-decorators`, upstream of this package" —
|
|
94
|
+
* which is exactly backwards: upstream is what a package MAY import, and this one already does.
|
|
95
|
+
* `files.shared.schemas.ts` in this very directory imports `FileUploaderEntityType` from
|
|
96
|
+
* `@wildo-ai/zod-decorators`, re-exports it, and writes `z.enum(FileUploaderEntityType)` on the
|
|
97
|
+
* FILES row's own `uploadedByEntityType`. So the vocabulary was one import away the whole time and
|
|
98
|
+
* the metadata's copy of the same field was the only one left open.
|
|
99
|
+
*
|
|
100
|
+
* What the enum buys: `metadata` is an UNTYPED bag on the token row, so nothing between the write
|
|
101
|
+
* and the read guarantees its shape — the read is the only place that can. Every reader here goes
|
|
102
|
+
* through `FileUploadGrantMetadataSchema.safeParse`, so an out-of-vocabulary entity type now makes
|
|
103
|
+
* the whole metadata unparseable and the redemption path refuses the grant instead of casting the
|
|
104
|
+
* value into `FileUploaderPrincipal` and carrying it three layers to `validateUploadedByEntityType`.
|
|
105
|
+
*
|
|
106
|
+
* NOT narrowed to the three values `mint` can actually produce (mint refuses an anonymous and a
|
|
107
|
+
* token-borne minter, so `ANONYMOUS_USER` is unreachable): that refusal is a MINT policy, enforced
|
|
108
|
+
* and explained at mint, and re-encoding it here would put half a policy in a schema that cannot
|
|
109
|
+
* say why. The vocabulary of this field is the vocabulary of the principal it names.
|
|
110
|
+
*/
|
|
111
|
+
minter: z.object({ entityType: z.enum(FileUploaderEntityType), id: z.string().min(1) }),
|
|
112
|
+
/**
|
|
113
|
+
* The concrete upload URL the grant was minted for. Two jobs, and the second one is why it must be
|
|
114
|
+
* absolute: the status read hands it to the drop page, AND the redemption path compares its PATH
|
|
115
|
+
* against the route the token is presented on (`assertGrantMatchesRoute`). Until 2026-09-08 it was
|
|
116
|
+
* recorded and never read back, so a grant bound to one concrete route could be redeemed on any
|
|
117
|
+
* other route reaching the same (resource, field, operation, row).
|
|
118
|
+
*/
|
|
119
|
+
uploadUrl: z.string().url(),
|
|
120
|
+
/** Written after a successful redemption; absent until then. */
|
|
121
|
+
producedFileId: z.string().min(1).optional(),
|
|
122
|
+
});
|
|
123
|
+
export type FileUploadGrantMetadata = z.infer<typeof FileUploadGrantMetadataSchema>;
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* What a mint returns — identical on the REST door and the MCP tool. Two affordances for one
|
|
127
|
+
* token: `uploadCommand` for a caller that can execute, `uploadPageUrl` for one that must hand a
|
|
128
|
+
* human a link. The token appears in `uploadHeader.value` and inside both commands and the page URL;
|
|
129
|
+
* it is the credential and cannot be omitted. It never appears in any audit row.
|
|
130
|
+
*/
|
|
131
|
+
export const FileUploadGrantSchema: z.ZodObject<{
|
|
132
|
+
grantId: z.ZodString;
|
|
133
|
+
state: z.ZodEnum<typeof FileUploadGrantState>;
|
|
134
|
+
expiresAt: z.ZodString;
|
|
135
|
+
singleUse: z.ZodLiteral<true>;
|
|
136
|
+
target: z.ZodObject<{
|
|
137
|
+
resourceType: z.ZodString;
|
|
138
|
+
fieldName: z.ZodString;
|
|
139
|
+
operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
|
|
140
|
+
resourceId: z.ZodNullable<z.ZodString>;
|
|
141
|
+
}>;
|
|
142
|
+
constraints: z.ZodObject<{
|
|
143
|
+
maxBytes: z.ZodNumber;
|
|
144
|
+
allowedMimeTypes: z.ZodArray<z.ZodString>;
|
|
145
|
+
}>;
|
|
146
|
+
uploadUrl: z.ZodString;
|
|
147
|
+
uploadHeader: z.ZodObject<{ name: z.ZodString; value: z.ZodString }>;
|
|
148
|
+
uploadCommand: z.ZodString;
|
|
149
|
+
uploadCommandPowerShell: z.ZodString;
|
|
150
|
+
uploadPageUrl: z.ZodNullable<z.ZodString>;
|
|
151
|
+
statusUrl: z.ZodString;
|
|
152
|
+
note: z.ZodString;
|
|
153
|
+
}> = z.object({
|
|
154
|
+
grantId: z.string().min(1),
|
|
155
|
+
state: FileUploadGrantStateSchema,
|
|
156
|
+
expiresAt: z.string().datetime(),
|
|
157
|
+
singleUse: z.literal(true),
|
|
158
|
+
target: z.object({
|
|
159
|
+
resourceType: z.string().min(1),
|
|
160
|
+
fieldName: z.string().min(1),
|
|
161
|
+
operation: FileUploadGrantOperationSchema,
|
|
162
|
+
resourceId: z.string().min(1).nullable(),
|
|
163
|
+
}),
|
|
164
|
+
/** From the field's own constraint resolver — the same one the upload enforces, so the two cannot disagree. */
|
|
165
|
+
constraints: z.object({
|
|
166
|
+
maxBytes: z.number().int().positive(),
|
|
167
|
+
/** Empty means every type is accepted. */
|
|
168
|
+
allowedMimeTypes: z.array(z.string()),
|
|
169
|
+
}),
|
|
170
|
+
uploadUrl: z.string().url(),
|
|
171
|
+
/** The credential travels in a HEADER on the curl form: paths are logged by every proxy, headers are not. */
|
|
172
|
+
uploadHeader: z.object({ name: z.string().min(1), value: z.string().min(1) }),
|
|
173
|
+
/** No `-f`: on a refusal the JSON error body is the only thing that tells the caller why. */
|
|
174
|
+
uploadCommand: z.string().min(1),
|
|
175
|
+
/** In PowerShell `curl` aliases Invoke-WebRequest, which does not understand `-F`; the real binary is `curl.exe`. */
|
|
176
|
+
uploadCommandPowerShell: z.string().min(1),
|
|
177
|
+
/** `null` when the application declares no frontend service — a headless API has no page to hand a human. */
|
|
178
|
+
uploadPageUrl: z.string().url().nullable(),
|
|
179
|
+
statusUrl: z.string().url(),
|
|
180
|
+
note: z.string().min(1),
|
|
181
|
+
});
|
|
182
|
+
export type FileUploadGrant = z.infer<typeof FileUploadGrantSchema>;
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* What the public status read returns. The token is the credential, so the read is unauthenticated
|
|
186
|
+
* and returns only what the drop page needs to render and the agent needs to learn the `fileId`:
|
|
187
|
+
* never the file's name (the status URL may be pasted around).
|
|
188
|
+
*/
|
|
189
|
+
export const FileUploadGrantStatusSchema: z.ZodObject<{
|
|
190
|
+
grantId: z.ZodString;
|
|
191
|
+
state: z.ZodEnum<typeof FileUploadGrantState>;
|
|
192
|
+
expiresAt: z.ZodString;
|
|
193
|
+
target: z.ZodObject<{
|
|
194
|
+
resourceType: z.ZodString;
|
|
195
|
+
fieldName: z.ZodString;
|
|
196
|
+
operation: z.ZodEnum<{ [K in FileUploadGrantOperation]: K }>;
|
|
197
|
+
resourceId: z.ZodNullable<z.ZodString>;
|
|
198
|
+
}>;
|
|
199
|
+
constraints: z.ZodObject<{ maxBytes: z.ZodNumber; allowedMimeTypes: z.ZodArray<z.ZodString> }>;
|
|
200
|
+
uploadUrl: z.ZodString;
|
|
201
|
+
uploadHeaderName: z.ZodString;
|
|
202
|
+
file: z.ZodNullable<z.ZodObject<{ fileId: z.ZodString; status: z.ZodEnum<typeof FileStatus> }>>;
|
|
203
|
+
}> = z.object({
|
|
204
|
+
grantId: z.string().min(1),
|
|
205
|
+
state: FileUploadGrantStateSchema,
|
|
206
|
+
expiresAt: z.string().datetime(),
|
|
207
|
+
target: z.object({
|
|
208
|
+
resourceType: z.string().min(1),
|
|
209
|
+
fieldName: z.string().min(1),
|
|
210
|
+
operation: FileUploadGrantOperationSchema,
|
|
211
|
+
resourceId: z.string().min(1).nullable(),
|
|
212
|
+
}),
|
|
213
|
+
constraints: z.object({ maxBytes: z.number().int().positive(), allowedMimeTypes: z.array(z.string()) }),
|
|
214
|
+
uploadUrl: z.string().url(),
|
|
215
|
+
/** The page sets this header itself; the token it already holds is the value. */
|
|
216
|
+
uploadHeaderName: z.string().min(1),
|
|
217
|
+
/** `null` until redeemed, or when the post-redemption write-back failed (re-read the resource instead). */
|
|
218
|
+
file: z.object({ fileId: z.string().min(1), status: z.enum(FileStatus) }).nullable(),
|
|
219
|
+
});
|
|
220
|
+
export type FileUploadGrantStatus = z.infer<typeof FileUploadGrantStatusSchema>;
|
|
221
|
+
|
|
222
|
+
/**
|
|
223
|
+
* Body accepted by both mint doors.
|
|
224
|
+
*
|
|
225
|
+
* The three optional file facts mirror what the MCP File Objects proposal has a client declare when
|
|
226
|
+
* it asks to upload (`name`, `mimeType`, `size`): declaring them lets the server refuse a file the
|
|
227
|
+
* field would never accept BEFORE handing out a link, instead of at redemption when the link is
|
|
228
|
+
* already spent. They are advisory for the upload itself — the bytes are validated on receipt
|
|
229
|
+
* regardless — and a declaration that later disagrees with the bytes is refused on receipt too.
|
|
230
|
+
*/
|
|
231
|
+
export const FileUploadGrantMintRequestSchema: z.ZodObject<{
|
|
232
|
+
expiresInMinutes: z.ZodOptional<z.ZodNumber>;
|
|
233
|
+
name: z.ZodOptional<z.ZodString>;
|
|
234
|
+
mimeType: z.ZodOptional<z.ZodString>;
|
|
235
|
+
size: z.ZodOptional<z.ZodNumber>;
|
|
236
|
+
}> = z.object({
|
|
237
|
+
expiresInMinutes: z.number().int().min(1).max(FILE_UPLOAD_GRANT_ABSOLUTE_MAX_MINUTES).optional(),
|
|
238
|
+
/** The file name the caller intends to upload; used for the curl example and checked against nothing else. */
|
|
239
|
+
name: z.string().min(1).max(255).optional(),
|
|
240
|
+
/** Declared MIME type; refused at mint when the field does not accept it. */
|
|
241
|
+
mimeType: z.string().min(1).max(255).optional(),
|
|
242
|
+
/** Declared size in bytes; refused at mint when above the field's maximum. */
|
|
243
|
+
size: z.number().int().positive().optional(),
|
|
244
|
+
}).strict();
|
|
245
|
+
export type FileUploadGrantMintRequest = z.infer<typeof FileUploadGrantMintRequestSchema>;
|
|
246
|
+
```
|
|
@@ -9,8 +9,8 @@ Read this when you need the exact contract:
|
|
|
9
9
|
- what `exposed` gates (fail-closed discovery — absent / `false` ⇒ NOT a tool);
|
|
10
10
|
- what `description` feeds (the agent-facing tool prose) and its fallback order
|
|
11
11
|
(authored → spec `purpose`/`whenToUse` → synthesized);
|
|
12
|
-
- the eligibility constraints (
|
|
13
|
-
URL-bearing operations,
|
|
12
|
+
- the eligibility constraints (machine ORG/APP; delegated callers also USER_SELF; DEFAULT non-bulk
|
|
13
|
+
URL-bearing API_CALL or API_CALL_WITH_CALLBACK operations, with explicit exposure and instance membership);
|
|
14
14
|
- why exposure can never widen access (per-call role authorization still runs on
|
|
15
15
|
every `tools/call`).
|
|
16
16
|
|
|
@@ -30,10 +30,11 @@ Read this when you need the exact contract:
|
|
|
30
30
|
* — this is a field on an operation variant inside a resource's `operations` config.
|
|
31
31
|
*
|
|
32
32
|
* Opt-in + FAIL-CLOSED: absent or `false` ⇒ the operation is NOT a tool. Only DEFAULT,
|
|
33
|
-
* non-bulk, URL-bearing
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
33
|
+
* non-bulk, URL-bearing API_CALL or API_CALL_WITH_CALLBACK operations are eligible.
|
|
34
|
+
* Machine principals reach ORGANIZATIONS / APPLICATION resources; user-delegated principals
|
|
35
|
+
* additionally reach USER_SELF. The verified principal selects the discovery scope set;
|
|
36
|
+
* anonymous discovery has no reachable tools. A USER_SELF opt-in therefore has no machine-callable
|
|
37
|
+
* effect but can be listed for a delegated user, subject to the remaining eligibility gates.
|
|
37
38
|
*
|
|
38
39
|
* `description` is the agent-facing tool description — the prose the calling agent reads to
|
|
39
40
|
* decide when to use the tool. When omitted, the tool description falls back to the resource
|
|
@@ -14,8 +14,8 @@ tool is a capability the agent routes around; a broken advertised tool is a loop
|
|
|
14
14
|
| Your operation is withdrawn when… | Why | How you notice |
|
|
15
15
|
|---|---|---|
|
|
16
16
|
| it declares an `unimplementedAcknowledgement` | The variant is a KNOWN implementation gap: it refuses every request by design and can never answer 2xx. Advertising it promises a capability that provably does not exist | The tool is absent from `tools/list` even though `mcp.exposed` is `true` |
|
|
17
|
-
| it is not a DEFAULT, URL-bearing `API_CALL` variant | The tool surface mirrors the HTTP surface. A bulk or non-default variant has no single addressable call for a tool to map onto | Absent from `tools/list` |
|
|
18
|
-
| its
|
|
17
|
+
| it is not a DEFAULT, non-bulk, URL-bearing `API_CALL` or `API_CALL_WITH_CALLBACK` variant | The tool surface mirrors the HTTP surface. A bulk or non-default variant has no single addressable call for a tool to map onto | Absent from `tools/list` |
|
|
18
|
+
| its scope is unreachable by the verified principal | Machine callers reach ORG/APP; delegated callers also reach USER_SELF | Absent for the ineligible principal, potentially present for a delegated user under normal exposure gates |
|
|
19
19
|
| it belongs to a named server and you are reading the default `/mcp` | Membership is EXCLUSIVE — curating an operation onto a named server MOVES it | Absent from the default catalogue, present on the named one |
|
|
20
20
|
|
|
21
21
|
**The acknowledgement rule overrides your opt-in on purpose.** The two declarations are written at
|
|
@@ -58,7 +58,7 @@ Your config says what you REQUESTED. `tools/list` says what an agent will actual
|
|
|
58
58
|
by every rule in the table above, so verify against the endpoint:
|
|
59
59
|
|
|
60
60
|
```bash
|
|
61
|
-
# What an agent actually sees. Requires a
|
|
61
|
+
# What an agent actually sees. Requires a token audience-bound to the MCP endpoint; use the intended machine or delegated identity.
|
|
62
62
|
curl -s -X POST "$APP_API/mcp" \
|
|
63
63
|
-H "Authorization: Bearer $MCP_TOKEN" \
|
|
64
64
|
-H 'Content-Type: application/json' \
|
|
@@ -66,6 +66,8 @@ curl -s -X POST "$APP_API/mcp" \
|
|
|
66
66
|
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq -r '.result.tools[].name' | sort
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
+
The same declarations can yield different catalogues for machine and delegated callers. Anonymous listing currently challenges for authentication. Per-call roles and record permissions remain separate from listing eligibility.
|
|
70
|
+
|
|
69
71
|
Compare that against what you declared:
|
|
70
72
|
|
|
71
73
|
```bash
|
|
@@ -65,36 +65,31 @@ check when you query. Read the half you need; they are sequential, not simultane
|
|
|
65
65
|
|
|
66
66
|
### Step 1: Confirm the resource can hold a corpus — before authoring anything
|
|
67
67
|
|
|
68
|
-
Chunk storage follows the resource's **own persistence adapter
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
A retrieval corpus normally qualifies — it is created, published and read on its own, and its chunk
|
|
94
|
-
tier lives in the same adapter it does. Make the claim only if it is TRUE of the resource's design,
|
|
95
|
-
not merely of today's call sites: it is not a flag that silences the error. If an operation later
|
|
96
|
-
commits this resource beside one on the other adapter, the persistence unit of work still refuses
|
|
97
|
-
that boundary at runtime, so a false claim fails loudly rather than degrading silently.
|
|
68
|
+
Chunk storage follows the resource's **own persistence adapter**, resolved from its explicit
|
|
69
|
+
`persistenceAdapter` or the application's database engine in the environment config.
|
|
70
|
+
Both **PostgreSQL and MongoDB** can host a corpus; MongoDB does not require a PostgreSQL override.
|
|
71
|
+
|
|
72
|
+
| Resource adapter | Infrastructure required | Framework responsibility |
|
|
73
|
+
|---|---|---|
|
|
74
|
+
| PostgreSQL | The application's database must expose the `vector` extension (pgvector), even for a corpus currently using lexical retrieval only. Startup probes it. | Provision the chunk table and its indexes. |
|
|
75
|
+
| MongoDB | A search-capable deployment (the framework probe expects MongoDB 8.2+ with `mongot`) supporting `$search` and `$vectorSearch`, with permission to manage search indexes. Startup probes the search capability. A plain MongoDB connection alone is insufficient. | Provision the chunk collection, ordinary indexes and search-index definitions; check search-index readiness. |
|
|
76
|
+
| HTTP_API or INTROSPECTION | These adapters own no stored rows and cannot host chunks. | Refuse corpus declarations rather than leave derived text outside the removal paths. |
|
|
77
|
+
|
|
78
|
+
MongoDB search indexes build asynchronously. A queryable lexical index can serve text while
|
|
79
|
+
vectors are unavailable; a queryable vector index can serve its arm while the lexical index is
|
|
80
|
+
unavailable. If neither required arm is queryable, both requested arms report `UNAVAILABLE`
|
|
81
|
+
and public `searchStatus` is `FAILED`. Execution exceptions also return failed search status,
|
|
82
|
+
with unknown arm outcomes when reliable reports were not returned. This is not an empty corpus. Check application startup diagnostics and search-index readiness before
|
|
83
|
+
interpreting missing context as missing source data. The framework owns these indexes; do not
|
|
84
|
+
create a separate application chunk store or re-indexing job.
|
|
85
|
+
|
|
86
|
+
**A cross-adapter resource is a separate architectural choice, not a RAG prerequisite.** If you
|
|
87
|
+
intentionally choose a different adapter, pair `persistenceAdapter` with
|
|
88
|
+
`persistenceAdapterIsolation: ResourcePersistenceAdapterIsolation.NO_CROSS_ADAPTER_TRANSACTION`.
|
|
89
|
+
This declares that the resource will not join a cross-adapter atomic write. Do not add the claim
|
|
90
|
+
merely to silence validation: native transactions cannot span PostgreSQL and MongoDB, and a
|
|
91
|
+
later cross-adapter unit of work still refuses. A corpus on the application's default supported
|
|
92
|
+
adapter needs neither a resource override nor that isolation exception.
|
|
98
93
|
|
|
99
94
|
### Step 2: Decide which fields belong in the corpus
|
|
100
95
|
|
|
@@ -137,12 +132,12 @@ Declare `EngineCapability.AI_EMBEDDINGS`, add a provider entry for it, and selec
|
|
|
137
132
|
`references/framework-embeddings-capability-api.md` for the three places this touches.
|
|
138
133
|
|
|
139
134
|
**Skipping it is a supported state, not a broken one.** With no provider, the corpus is still built
|
|
140
|
-
and text
|
|
135
|
+
and text can be searched **lexically once the store and its search index are ready** — only the semantic half of
|
|
141
136
|
retrieval is missing, and a background worker records one warning per run naming the backlog. Wire
|
|
142
137
|
a provider later and that backlog drains on its own.
|
|
143
138
|
|
|
144
|
-
The same is true of freshly written text while a provider IS configured: it
|
|
145
|
-
|
|
139
|
+
The same is true of freshly written text while a provider IS configured: it becomes lexically searchable after ingestion and index readiness, and semantically searchable
|
|
140
|
+
after the background worker embeds it and the vector index is ready. There is no fixed latency promise. Say
|
|
146
141
|
this out loud to whoever asked, because "I saved it and the assistant does not know it yet" is the
|
|
147
142
|
first question a corpus produces.
|
|
148
143
|
|
|
@@ -328,7 +323,7 @@ export const knowledgeArticleSchema = z.object({
|
|
|
328
323
|
|
|
329
324
|
Declaration (steps 1–6):
|
|
330
325
|
|
|
331
|
-
- [ ] The resource
|
|
326
|
+
- [ ] The resource resolves to PostgreSQL or MongoDB, and its pgvector or mongot/search-index prerequisites are verified
|
|
332
327
|
- [ ] Every declared field is prose a human wrote for another human to read
|
|
333
328
|
- [ ] No corpus source shares a field with a secret, one-time-code, ephemeral or TTL declaration
|
|
334
329
|
- [ ] Every authored `chunkOverlap` is strictly smaller than its `chunkSize`
|
|
@@ -352,21 +347,21 @@ Run from the app root.
|
|
|
352
347
|
|
|
353
348
|
| Invariant | Command |
|
|
354
349
|
|---|---|
|
|
355
|
-
| Enumerate every corpus declaration in the application | `rg -n "\.ragSource\(
|
|
356
|
-
| No corpus source shares a field with a refused companion | `rg -n "ragSource
|
|
357
|
-
|
|
|
358
|
-
|
|
|
350
|
+
| Enumerate every corpus declaration in the application | `rg -n -e "\.ragSource\(" -e "ragSource:" shared-lib/src` |
|
|
351
|
+
| No corpus source shares a field with a refused companion | `rg -n -e "ragSource" -e "isPassword" -e "isOtp" -e "isWriteOnlySecret" -e "isEphemeral" -e "ttl" shared-lib/src` — inspect the declarations together, including multiline schemas; a corpus resource with a TTL policy is also refused even on another field |
|
|
352
|
+
| Every corpus resource uses a supported stored adapter | `rg -l -e "\.ragSource\(" -e "ragSource:" shared-lib/src` then `rg -n "persistenceAdapter" shared-lib/src/modules/*/resources/*/*.resources-config.ts` — resolve each named resource against its override or application database default; PostgreSQL and MongoDB are supported |
|
|
353
|
+
| An intentional stored-corpus adapter override carries its isolation claim | `rg -n -e "persistenceAdapter:" -e "persistenceAdapterIsolation:" shared-lib/src` — check the deliberately overridden PostgreSQL/MongoDB corpus resources identified above; do not add isolation to HTTP_API resources, which forbid it |
|
|
359
354
|
| Every authored overlap is smaller than its size | `rg -n -A1 "chunkSize:" shared-lib/src` — read each pair |
|
|
360
|
-
|
|
|
355
|
+
| Embeddings are configured or deliberately omitted | `rg -n "AI_EMBEDDINGS" wildo.saas.config.ts` — when semantic retrieval is required, expect the capability block, provider and selection; otherwise record lexical-only operation |
|
|
361
356
|
| No field opts into OCR without the capability behind it | `rg -n "ocr:\s*true" shared-lib/src` then `rg -n "AI_DOCUMENT_EXTRACTION" wildo.saas.config.ts` — a hit in the first with none in the second is a field paying nothing and getting nothing |
|
|
362
357
|
| No capability is wired with no field asking for it | `rg -n "AI_DOCUMENT_EXTRACTION" wildo.saas.config.ts` then `rg -n "ocr:\s*true" shared-lib/src` — the reverse gap: a configured provider no field can reach |
|
|
363
358
|
| Every corpus field appears in its specification | `rg -n "<field>" specifications/src/modules/*/resources/<resource>.resource.specification.ts` |
|
|
364
|
-
| No hand-written chunk maintenance exists | `rg -n "chunk
|
|
359
|
+
| No hand-written chunk maintenance exists | `rg -n -e "chunk" -e "embedding" backend-api/src shared-lib/src` — any hit that manipulates corpus rows is framework work being duplicated |
|
|
365
360
|
| Enumerate every retrieval call site | `rg -n "\.retrieve\(" backend-api/src` — read each one against the four rows below |
|
|
366
|
-
| Every call passes the caller's own context | `rg -n -A6 "\.retrieve\(" backend-api/src
|
|
361
|
+
| Every call passes the caller's own context | `rg -n -A6 "\.retrieve\(" backend-api/src` — inspect executionContext in each call; it must be the context received, never one built or elevated |
|
|
367
362
|
| No absolute threshold on a fusion score | `rg -n "fusion\s*[<>]" backend-api/src` — must return nothing; ordering is the only valid use |
|
|
368
|
-
| Refusals and truncation are read | `rg -n "refusedResourceTypes
|
|
369
|
-
| No permission filtering around results | `rg -n -B3 -A8 "\.retrieve\(" backend-api/src
|
|
363
|
+
| Refusals and truncation are read | `rg -n -e "refusedResourceTypes" -e "truncation" backend-api/src` — expect at least one hit per retrieval call site |
|
|
364
|
+
| No permission filtering around results | `rg -n -B3 -A8 "\.retrieve\(" backend-api/src` — inspect surrounding filters and authorization checks; do not duplicate the retrieval access decision |
|
|
370
365
|
| No HTTP route exposes retrieval | `rg -n "retrieve\(" -g "*.controller.ts" backend-api/src` — must return nothing |
|
|
371
366
|
|
|
372
367
|
## Common Rationalizations
|
|
@@ -378,21 +373,21 @@ Run from the app root.
|
|
|
378
373
|
| "I will turn `ocr: true` on everywhere so nothing is missed" | OCR is billed per PAGE by an external service, and a born-digital PDF gains nothing from it — its text is already there. Turning it on across a corpus of ordinary documents buys identical text at a recurring cost, and re-costs every document on every re-ingestion. Turn it on for the fields that hold scans. |
|
|
379
374
|
| "The whole resource should be searchable, so I will declare every string field" | Ids, statuses and timestamps are strings that no sentence can quote. They cost storage, dilute every match, and crowd out the chunk that would have answered. Declare the fields a person wrote to be read. |
|
|
380
375
|
| "I need to delete the chunks when the row is deleted" | You do not, and writing that code is how the two paths drift apart. Row deletion, field scrubbing on a subject erasure, and file unbinding all remove the affected chunks already. If you believe a path is uncovered, report it rather than patching it locally. |
|
|
381
|
-
| "Nothing is retrievable until I configure an embeddings provider" |
|
|
376
|
+
| "Nothing is retrievable until I configure an embeddings provider" | Once ingestion and search-index readiness complete, text is searchable lexically. A missing provider defers the semantic half of retrieval and nothing else — the corpus is still built, still erased with its rows, and still drains into vectors after a provider appears and processing/index readiness complete. |
|
|
382
377
|
| "I edited the field, so I should trigger a re-index" | The write already did. Old chunks are removed immediately — edited-away text must not keep answering questions — and the new text is re-derived after the write commits. |
|
|
383
378
|
| "The framework refuses secrets, so it will catch whatever I miss" | The five refusals are a floor, not a review. The framework cannot know that a free-text field happens to collect card numbers. The field-by-field question is still yours to ask. |
|
|
384
|
-
| "
|
|
379
|
+
| "MongoDB needs a PostgreSQL exception for RAG" | Both stored adapters are supported. Check mongot and search-index readiness for MongoDB; reserve an adapter override and isolation claim for an intentional architecture decision. HTTP_API and INTROSPECTION cannot host a corpus. |
|
|
385
380
|
| "I should filter the results so users only see their own rows" | Already done, three times over — before the search (the caller's roles), inside the query (the caller's tenancy, as a pre-filter), and after matching (each row re-read on the caller's authority). A filter you add on top can only remove rows the framework already admitted, which hides a defect instead of reporting one. |
|
|
386
381
|
| "Retrieval returned too little, so I will pass a system or elevated context" | That is a privilege escalation wearing a workaround's clothes: it makes one caller's query read another tenant's corpus. A short result is either the caller's roles, the resource's scope declaration, or a reported drop count — all three are visible, and all three are the thing to fix. |
|
|
387
382
|
| "I will only use results scoring above 0.5" | The fused score orders passages *within one query*. It is not a probability and not comparable across queries, so a fixed cutoff keeps everything on one query and nothing on the next. Rank and take the top N. |
|
|
388
|
-
| "The vector arm returned nothing, so retrieval is broken" | That is `lexical-only` mode, and it is a supported state: no embeddings provider configured, or text committed more recently than the background worker has embedded it. Text is answerable by wording
|
|
383
|
+
| "The vector arm returned nothing, so retrieval is broken" | That is `lexical-only` mode, and it is a supported state: no embeddings provider configured, or text committed more recently than the background worker has embedded it. Text is answerable by wording once the lexical index is ready, and by meaning after embedding and vector-index readiness. |
|
|
389
384
|
| "A refused resource type means the call failed" | Refusals are data. The call searched everything else and named what it skipped. One member of that vocabulary is a working permission boundary that differs per caller; the rest name a configuration an operator can repair. Discarding the list is how a silently half-searched corpus goes unnoticed. |
|
|
390
385
|
| "I will expose retrieval on an endpoint so the frontend can query it" | An endpoint is its own authorization surface — its own role gate, rate limit, audit posture and tenancy story, all duplicating decisions the calling feature already makes. Expose the assistant or the search operation, and let that operation carry the authorization. |
|
|
391
386
|
|
|
392
387
|
## Red Flags
|
|
393
388
|
|
|
394
389
|
- A declaration was authored before the resource's persistence adapter was checked — catch with the
|
|
395
|
-
**
|
|
390
|
+
**Every corpus resource uses a supported stored adapter** grep
|
|
396
391
|
- A field holding ids, enum values, statuses or timestamps carries a declaration — catch with the
|
|
397
392
|
**Enumerate every corpus declaration** grep and read each hit
|
|
398
393
|
- A declaration sits on a field that also declares a secret, one-time code, ephemeral value or TTL
|
|
@@ -400,7 +395,7 @@ Run from the app root.
|
|
|
400
395
|
- An authored `chunkOverlap` is greater than or equal to its `chunkSize` — catch with the
|
|
401
396
|
**Every authored overlap is smaller than its size** grep
|
|
402
397
|
- Corpus sources exist but `wildo.saas.config.ts` never mentions the capability, and nobody decided
|
|
403
|
-
that — catch with the **
|
|
398
|
+
that — catch with the **Embeddings are configured or deliberately omitted** grep
|
|
404
399
|
- A corpus field is absent from the resource specification — catch with the **Every corpus field
|
|
405
400
|
appears in its specification** grep
|
|
406
401
|
- The change includes code that deletes, rebuilds or backfills chunks — catch with the **No
|