@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
|
@@ -20,7 +20,7 @@ provider scope:
|
|
|
20
20
|
- `engineCapabilities[EngineCapability.AI_EMBEDDINGS] = { enabled: true }`
|
|
21
21
|
- a provider entry declaring `engineCapabilities: [EngineCapability.AI_EMBEDDINGS]`,
|
|
22
22
|
`providerCapabilities: ['LLM_EMBEDDINGS']`, `protocols: ['EMBEDDINGS_PROVIDER']`
|
|
23
|
-
- `selection[EngineCapability.AI_EMBEDDINGS] = { primary: '<providerRef>',
|
|
23
|
+
- `selection[EngineCapability.AI_EMBEDDINGS] = { primary: '<providerRef>', whenUnavailable: [] }`
|
|
24
24
|
|
|
25
25
|
## Import Origins
|
|
26
26
|
|
|
@@ -45,8 +45,32 @@ provider scope:
|
|
|
45
45
|
export enum EngineCapability {
|
|
46
46
|
ORGANIZATIONS = 'ORGANIZATIONS',
|
|
47
47
|
BILLING = 'BILLING',
|
|
48
|
-
BILLING_PAYMENTS = 'BILLING_PAYMENTS',
|
|
49
48
|
MULTI_LANGUAGE = 'MULTI_LANGUAGE',
|
|
49
|
+
/**
|
|
50
|
+
* Durable, provider-backed audit trail: every audit event the application records is ALSO sent to
|
|
51
|
+
* each configured audit provider (an immutable ledger, a SIEM).
|
|
52
|
+
*
|
|
53
|
+
* Whether to enable it is a question of where the trail must live, not of what the application may
|
|
54
|
+
* claim. The assurance surface attests roughly half its control objectives through audit rows, and
|
|
55
|
+
* those rows are read from the application's OWN audit store, which exists whether or not this
|
|
56
|
+
* capability is on. So leaving it out removes no control objective an application can claim. Until
|
|
57
|
+
* 2026-09-14 the assurance basis wrongly treated this capability as the precondition for those
|
|
58
|
+
* claims, and this comment said leaving it out left about a third of them unclaimable.
|
|
59
|
+
*
|
|
60
|
+
* Two things this does NOT mean, because both are easy to assume:
|
|
61
|
+
*
|
|
62
|
+
* - It is not what makes security events happen. Authentication, authorization, privilege and
|
|
63
|
+
* credential events are recorded in the application's own database regardless. What this
|
|
64
|
+
* capability adds is the provider-backed fan-out — the durable, external, tamper-evident
|
|
65
|
+
* destination an assurance reader can be pointed at.
|
|
66
|
+
* - It is not retroactive. Turning it on later starts a trail from that moment; it does not
|
|
67
|
+
* furnish evidence for the period it was off, and a control's evidence cannot begin before its
|
|
68
|
+
* evidence store does.
|
|
69
|
+
*
|
|
70
|
+
* So decide it with the compliance posture rather than as an infrastructure detail: enable it when
|
|
71
|
+
* the trail must also exist OUTSIDE the application — a store its own operators cannot rewrite, or a
|
|
72
|
+
* security team's SIEM. The application's own store stays the authoritative record either way.
|
|
73
|
+
*/
|
|
50
74
|
COMPLIANCE_AUDIT_TRAIL = 'COMPLIANCE_AUDIT_TRAIL',
|
|
51
75
|
|
|
52
76
|
EMAIL_TRANSACTIONAL = 'EMAIL_TRANSACTIONAL',
|
|
@@ -77,11 +101,13 @@ export enum EngineCapability {
|
|
|
77
101
|
* extraction into `AI_LLM` would have made one `selection[AI_LLM].primary` decide all three,
|
|
78
102
|
* which is exactly the defect that split `AI_EMBEDDINGS` out of `AI_LLM`.
|
|
79
103
|
*
|
|
80
|
-
* ## Not to be confused with
|
|
104
|
+
* ## Not to be confused with PDF GENERATION
|
|
81
105
|
*
|
|
82
|
-
*
|
|
83
|
-
*
|
|
84
|
-
* unrelated
|
|
106
|
+
* PDF generation — templates and data become bytes — is the `pdfTemplates` surface, done
|
|
107
|
+
* in-process and with no provider slot of its own. This is the opposite direction: bytes become
|
|
108
|
+
* text. The two are unrelated and nothing routes between them. (There WAS an
|
|
109
|
+
* `EngineCapability.DOCUMENT_GENERATION` that this paragraph used to name; it was withdrawn
|
|
110
|
+
* because no provider capability could ever fill it.)
|
|
85
111
|
*
|
|
86
112
|
* ## Absence is benign, and that is load-bearing
|
|
87
113
|
*
|
|
@@ -108,8 +134,60 @@ export enum EngineCapability {
|
|
|
108
134
|
*/
|
|
109
135
|
AI_CODING_AGENT = 'AI_CODING_AGENT',
|
|
110
136
|
|
|
111
|
-
|
|
112
|
-
|
|
137
|
+
/*
|
|
138
|
+
* WITHDRAWN 2026-09-03: `DOCUMENT_GENERATION` and `ANTIVIRUS_SCANNING` were members here and are
|
|
139
|
+
* not any more. Neither could ever be filled — `PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY` had no
|
|
140
|
+
* entry pointing at either, so no provider capability token could claim the slot — while both were
|
|
141
|
+
* classified `SELECT_ONE`, which asserts that exactly one provider must be selected. Selecting one
|
|
142
|
+
* of zero candidates is not a resolution mode.
|
|
143
|
+
*
|
|
144
|
+
* Both capabilities are real and both are delivered elsewhere, which is why withdrawing the slots
|
|
145
|
+
* costs nothing: antivirus scanning is `InfraCapability.ANTIVIRUS_SCANNING`, fulfilled by ClamAV
|
|
146
|
+
* and consumed by `FileScanningBackendService`; PDF generation is the in-process `pdfTemplates`
|
|
147
|
+
* surface, rendered by `@react-pdf/renderer` inside the backend. Neither has an external
|
|
148
|
+
* provider, and neither is planned to.
|
|
149
|
+
*
|
|
150
|
+
* `InfraCapability.DOCUMENT_RENDERING` (Gotenberg) was provisioned beside the PDF surface and
|
|
151
|
+
* consumed by nothing; it was withdrawn on 2026-09-08 (#477) because in-process rendering had
|
|
152
|
+
* superseded it. Note the two are not interchangeable if it is ever reconsidered:
|
|
153
|
+
* `@react-pdf/renderer` composes a document from React primitives, while Gotenberg converts
|
|
154
|
+
* EXISTING HTML and Office documents — that is a different capability, not a second
|
|
155
|
+
* implementation of this one.
|
|
156
|
+
*
|
|
157
|
+
* Removing `ANTIVIRUS_SCANNING` also removes a collision: the identical spelling named an engine
|
|
158
|
+
* slot nothing could fill AND a live infra capability, in two packages, so a reader grepping the
|
|
159
|
+
* word landed in whichever they searched first.
|
|
160
|
+
*
|
|
161
|
+
* If a hosted AV or document-rendering vendor is ever adopted, the member comes back WITH its
|
|
162
|
+
* `PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY` entry and its own JSDoc in the same change.
|
|
163
|
+
*
|
|
164
|
+
* WITHDRAWN 2026-09-09: `BILLING_PAYMENTS`, the third member of exactly that shape, and the one
|
|
165
|
+
* this paragraph's own closing rule should have caught. It was never withdrawn with the other two
|
|
166
|
+
* because it had been left behind DELIBERATELY — as a "reserved slot" — which reads as a decision
|
|
167
|
+
* and is why nobody re-examined it. Measured before removing, across the whole repository outside
|
|
168
|
+
* `node_modules` / `dist`: it appeared in live source at exactly THREE sites, and none of them was
|
|
169
|
+
* a use — the enum declaration itself, its row in the compile-forced
|
|
170
|
+
* `ENGINE_CAPABILITY_RESOLUTION_MODE` record, and a comment in a test naming it as a slot the
|
|
171
|
+
* billing provider must NOT be registered under. Zero applications enabled it, zero scaffolds
|
|
172
|
+
* wrote it, zero consumers queried it, and no provider capability token mapped to it.
|
|
173
|
+
*
|
|
174
|
+
* The capability it names is real and is already delivered: a billing provider (Stripe) declares
|
|
175
|
+
* `BUILTIN_PROVIDER_CAPABILITY.BILLING` and fills `EngineCapability.BILLING`, which is the slot
|
|
176
|
+
* applications enable and `getProvidersForEngineCapability` gates on. Payment EXECUTION is served
|
|
177
|
+
* through that same provider's `BILLING_PROVIDER` protocol; splitting it into a second engine slot
|
|
178
|
+
* was a plan-era intention (`provider-registry-materialization-workflow.md`) that the shipped
|
|
179
|
+
* model settled the other way. So the withdrawal removes a name, not a capability.
|
|
180
|
+
*
|
|
181
|
+
* The reason a reserved slot is worse than no slot is `EngineCapabilityResolutionMode`: every
|
|
182
|
+
* member must be classified, `BILLING_PAYMENTS` was classified `SELECT_ONE`, and `SELECT_ONE`
|
|
183
|
+
* asserts that exactly one provider is selected from the candidates. There were zero candidates
|
|
184
|
+
* and there could never be one. A vocabulary member that no configuration can satisfy is not a
|
|
185
|
+
* reservation, it is a false statement the compiler is forced to carry.
|
|
186
|
+
*
|
|
187
|
+
* If a payments vendor is ever selected independently of the billing vendor, the member comes back
|
|
188
|
+
* with its provider-capability token and its map entry in the same change — the same rule as
|
|
189
|
+
* above, now with three instances behind it.
|
|
190
|
+
*/
|
|
113
191
|
|
|
114
192
|
FRONTEND_ERROR_MONITORING = 'FRONTEND_ERROR_MONITORING',
|
|
115
193
|
FRONTEND_PRODUCT_ANALYTICS = 'FRONTEND_PRODUCT_ANALYTICS',
|
|
@@ -138,7 +216,9 @@ export enum EngineCapability {
|
|
|
138
216
|
## Selection is by CLASS, never by model id
|
|
139
217
|
|
|
140
218
|
An application names an applicability **class**; the framework resolves the concrete model from its
|
|
141
|
-
own catalog.
|
|
219
|
+
own catalog. There is no per-application model-preference override in this contract. A change to the
|
|
220
|
+
framework-owned applicability binding must also respect the corpus/query vector-space migration.
|
|
221
|
+
Two consequences worth understanding before you configure anything:
|
|
142
222
|
|
|
143
223
|
- **Corpus and query embedding must resolve through the same class**, or the similarity search
|
|
144
224
|
compares vectors from two different spaces and means nothing. The class names the SURFACE, which
|
|
@@ -180,8 +260,10 @@ export enum Embeddings_Applicability {
|
|
|
180
260
|
## Not configuring a provider is a supported state
|
|
181
261
|
|
|
182
262
|
If no provider fills `AI_EMBEDDINGS`, the application still works and the corpus is still built:
|
|
183
|
-
text
|
|
184
|
-
|
|
263
|
+
text can be searched **lexically** after successful ingestion and once the store's lexical indexes
|
|
264
|
+
are ready. A committed write alone does not establish that readiness: post-commit ingestion can fail
|
|
265
|
+
without undoing the write, and reconciliation retries missed derivation. Lexical search does not wait
|
|
266
|
+
for vectors. What is missing without the provider is the semantic half of retrieval. The background worker records one warning per run naming the
|
|
185
267
|
missing capability and the backlog size, and startup stays green.
|
|
186
268
|
|
|
187
269
|
Configure a provider later and the backlog drains on its own — nothing has to be re-authored.
|
|
@@ -204,15 +286,15 @@ Declare it the same way, in the same three places:
|
|
|
204
286
|
- `engineCapabilities[EngineCapability.AI_DOCUMENT_EXTRACTION] = { enabled: true }`
|
|
205
287
|
- a provider entry declaring `engineCapabilities: [EngineCapability.AI_DOCUMENT_EXTRACTION]`,
|
|
206
288
|
`providerCapabilities: ['DOCUMENT_TEXT_EXTRACTION']`, `protocols: ['DOCUMENT_EXTRACTION_PROVIDER']`
|
|
207
|
-
- `selection[EngineCapability.AI_DOCUMENT_EXTRACTION] = { primary: '<providerRef>',
|
|
289
|
+
- `selection[EngineCapability.AI_DOCUMENT_EXTRACTION] = { primary: '<providerRef>', whenUnavailable: [] }`
|
|
208
290
|
|
|
209
291
|
**Its own slot, separate from `AI_LLM` and `AI_EMBEDDINGS`**, so chat, embeddings and OCR are three
|
|
210
292
|
independent choices. Vendors are not equally good at all three and their pricing does not even share
|
|
211
293
|
a unit — OCR is billed per PAGE, embeddings per token — so fusing any two of them into one selection
|
|
212
294
|
would force a procurement decision nobody wants to make.
|
|
213
295
|
|
|
214
|
-
Not to be confused with
|
|
215
|
-
|
|
296
|
+
Not to be confused with PDF *generation*, which is the opposite direction and is handled by the
|
|
297
|
+
`pdfTemplates` surface rather than by a provider selection. Nothing routes between them.
|
|
216
298
|
|
|
217
299
|
### Selecting a provider is only HALF the wiring
|
|
218
300
|
|
package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md
CHANGED
|
@@ -151,8 +151,9 @@ Two consequences to design around:
|
|
|
151
151
|
- **A result can be shorter than the `limit` you asked for.** Rows the caller could not read are
|
|
152
152
|
dropped and deliberately not refilled, because refilling would leak the existence of hidden rows
|
|
153
153
|
through the number of round trips. The counts are reported — see the truncation report below.
|
|
154
|
-
- **If retrieval returns less than
|
|
155
|
-
|
|
154
|
+
- **If retrieval returns less than expected, inspect its diagnostics first**: search availability,
|
|
155
|
+
embedding preparation, access refusals and read failures are separate causes. Never substitute a
|
|
156
|
+
broader context to conceal an unavailable store or a permission boundary.
|
|
156
157
|
|
|
157
158
|
## Freshness: text answers before it is embedded
|
|
158
159
|
|
|
@@ -160,12 +161,18 @@ Search runs two arms and fuses them: a **lexical** arm over the text and a **vec
|
|
|
160
161
|
embeddings. The lexical arm needs no provider and no vectors, which produces the behaviour to
|
|
161
162
|
communicate to whoever asked for the feature:
|
|
162
163
|
|
|
163
|
-
-
|
|
164
|
-
|
|
165
|
-
-
|
|
164
|
+
- After successful post-commit ingestion, text can be searched by wording when the store's lexical
|
|
165
|
+
search infrastructure is ready. This does not wait for embeddings.
|
|
166
|
+
- A committed source write is not proof of retrieval readiness. Ingestion failures are logged without
|
|
167
|
+
rolling back the source write; reconciliation retries missed derivation. Store indexes must also
|
|
168
|
+
be ready for the corresponding search arm.
|
|
169
|
+
- Semantic matching becomes available as the configured background worker derives embeddings.
|
|
170
|
+
Provider availability, backlog and scheduling determine when; there is no fixed completion delay.
|
|
171
|
+
- An application with no embeddings provider at all is a **supported** lexical-only state.
|
|
166
172
|
|
|
167
|
-
|
|
168
|
-
|
|
173
|
+
Do not require vectors before using a healthy lexical corpus. Equally, do not present a failed
|
|
174
|
+
ingestion or an unavailable search index as an empty knowledge base. Keep deployment readiness,
|
|
175
|
+
source derivation and optional vector enrichment distinct when reporting availability.
|
|
169
176
|
|
|
170
177
|
## What comes back
|
|
171
178
|
|
|
@@ -179,18 +186,21 @@ gate, and do not report an empty vector arm as an error.
|
|
|
179
186
|
|
|
180
187
|
```typescript
|
|
181
188
|
/**
|
|
182
|
-
*
|
|
189
|
+
* The requested search mode, based on whether a query vector was prepared.
|
|
190
|
+
* Actual executed arms are reported separately in `searches`; indexes can degrade independently.
|
|
183
191
|
*
|
|
184
192
|
* Imported from `@wildo-ai/saas-backend-lib`. Reported on every result as `result.mode`.
|
|
185
193
|
*
|
|
186
194
|
* **`LEXICAL_ONLY` is a SUPPORTED state, not a failure.** An application that never configured an
|
|
187
195
|
* `AI_EMBEDDINGS` provider answers in this mode forever, and answers correctly — by wording rather
|
|
188
|
-
* than by meaning.
|
|
189
|
-
*
|
|
190
|
-
*
|
|
196
|
+
* than by meaning. Successfully ingested text can also be lexical-only while the background worker
|
|
197
|
+
* derives its embeddings, provided the lexical search infrastructure is ready. Backlog, scheduling
|
|
198
|
+
* and provider availability determine the delay; there is no fixed completion time.
|
|
199
|
+
* So do not surface this mode as an error, and do not gate a
|
|
200
|
+
* feature on `HYBRID`. Check `embeddingStatus` for provider degradation and `searchStatus` for availability.
|
|
191
201
|
*/
|
|
192
202
|
export enum RagRetrievalMode {
|
|
193
|
-
/** Vector + lexical
|
|
203
|
+
/** Vector + lexical requested. Inspect `searches` to establish which arms completed. */
|
|
194
204
|
HYBRID = 'hybrid',
|
|
195
205
|
/**
|
|
196
206
|
* Lexical only. Reached when no provider serves `AI_EMBEDDINGS` (normal for an application that
|
|
@@ -278,10 +288,12 @@ export interface RagRetrievedRow {
|
|
|
278
288
|
* Imported from `@wildo-ai/saas-backend-lib`. Retrieval DEGRADES rather than throwing: an
|
|
279
289
|
* unreachable corpus, a broken embeddings provider or a resource type this caller may not read all
|
|
280
290
|
* produce a smaller result, never an exception. So there is no error branch to write — but there
|
|
281
|
-
* are
|
|
291
|
+
* are explicit diagnostics carrying what a thrown error would otherwise have told you, and ignoring them
|
|
282
292
|
* is how a half-searched corpus goes unnoticed for months:
|
|
283
293
|
*
|
|
284
|
-
* - {@link
|
|
294
|
+
* - {@link searchStatus} and {@link searches} — healthy empty versus failed or partial search;
|
|
295
|
+
* - {@link embeddingStatus} — intentionally unconfigured versus failed query-vector preparation;
|
|
296
|
+
* - {@link mode} — requested search mode, not a certificate of arm readiness;
|
|
285
297
|
* - {@link refusedResourceTypes} — which corpora were skipped, and which of those an operator can
|
|
286
298
|
* repair;
|
|
287
299
|
* - {@link truncation} — which bound bit, and how many matched rows were dropped.
|
|
@@ -295,8 +307,14 @@ export interface RagRetrievedRow {
|
|
|
295
307
|
* }
|
|
296
308
|
*/
|
|
297
309
|
export interface RagRetrievalResult {
|
|
298
|
-
/**
|
|
310
|
+
/** Requested mode based on query-vector availability; actual participation is in `searches`. */
|
|
299
311
|
mode: RagRetrievalMode;
|
|
312
|
+
/** Search execution availability, independent of hit count and access refusals. */
|
|
313
|
+
searchStatus: RagRetrievalSearchStatus;
|
|
314
|
+
/** Distinguishes intentional lexical-only operation from a broken embeddings provider. */
|
|
315
|
+
embeddingStatus: RagRetrievalEmbeddingStatus;
|
|
316
|
+
/** Actual arm outcomes for admitted resource types only; no database/provider error details. */
|
|
317
|
+
searches: RagChunkSearchReport[];
|
|
300
318
|
/** Assembled rows, best-fused-score first. This is the context to put in a prompt. */
|
|
301
319
|
rows: RagRetrievedRow[];
|
|
302
320
|
/**
|
|
@@ -315,6 +333,20 @@ export interface RagRetrievalResult {
|
|
|
315
333
|
}
|
|
316
334
|
```
|
|
317
335
|
|
|
336
|
+
## Handle availability before interpreting an empty answer
|
|
337
|
+
|
|
338
|
+
Preserve `searchStatus` and `embeddingStatus` in the custom operation's response DTO and projection.
|
|
339
|
+
Their enums are imported from `@wildo-ai/saas-models`. A healthy empty search differs from `FAILED`
|
|
340
|
+
or `NOT_RUN`; neither of those is evidence that no source exists. `DEGRADED` reports partial search
|
|
341
|
+
coverage. A failed embedding with a healthy search means wording search worked while semantic
|
|
342
|
+
matching was unavailable; `NOT_CONFIGURED` is a supported optional-provider configuration.
|
|
343
|
+
|
|
344
|
+
`mode` records the requested search mode. Direct service callers can inspect `searches` for each
|
|
345
|
+
admitted resource's actual lexical/vector outcome. `UNKNOWN` means the aggregate aborted without
|
|
346
|
+
reliable arm reports: it does not claim an arm was attempted. No raw provider/database errors are
|
|
347
|
+
included. Keep operational diagnosis in logs and give the assistant an explicit availability result
|
|
348
|
+
rather than an instruction to interpret every empty list as an empty knowledge base.
|
|
349
|
+
|
|
318
350
|
## How relevant each passage was
|
|
319
351
|
|
|
320
352
|
## Import Origins
|
|
@@ -42,7 +42,6 @@ Two contracts to internalise before you author anything:
|
|
|
42
42
|
*
|
|
43
43
|
* - `FIXED_SIZE` — split every `chunkSize` characters/tokens regardless of structure.
|
|
44
44
|
* - `RECURSIVE` — split on a separator hierarchy (paragraph → sentence → word) down to `chunkSize`.
|
|
45
|
-
* - `SEMANTIC` — split at embedding-detected topic boundaries.
|
|
46
45
|
* - `MARKDOWN` — split on markdown structure (headings, lists, code fences).
|
|
47
46
|
* - `CODE` — split on source-code structure (functions, classes, blocks). Unified in (2026-08-26)
|
|
48
47
|
* from a second copy of this vocabulary that `saas-models` then carried: the member sets differed
|
|
@@ -50,11 +49,16 @@ Two contracts to internalise before you author anything:
|
|
|
50
49
|
* invalidated configurations authored against the wider one — so the union won. That second copy,
|
|
51
50
|
* and the agent-level RAG configuration schemas around it, were retired on 2026-08-27 as a
|
|
52
51
|
* pre-capability design the shipped capability superseded; this object is now the only home.
|
|
52
|
+
*
|
|
53
|
+
* There is deliberately NO semantic/embedding-based member. It is the option people reach for
|
|
54
|
+
* first, and published evaluations put it BELOW `RECURSIVE` on both recall and precision while
|
|
55
|
+
* costing an embedding pass per document — so `RECURSIVE` is the right default for prose, and the
|
|
56
|
+
* two structure-aware members are for text whose structure carries meaning.
|
|
57
|
+
*
|
|
53
58
|
*/
|
|
54
59
|
export const RAGChunkingStrategy = {
|
|
55
60
|
FIXED_SIZE: 'fixed_size',
|
|
56
61
|
RECURSIVE: 'recursive',
|
|
57
|
-
SEMANTIC: 'semantic',
|
|
58
62
|
MARKDOWN: 'markdown',
|
|
59
63
|
CODE: 'code',
|
|
60
64
|
} as const;
|
|
@@ -125,6 +125,10 @@ Make the field shape truthful before thinking about chrome or labels:
|
|
|
125
125
|
|
|
126
126
|
Read `references/field-type-selection.md` when the type choice is not obvious.
|
|
127
127
|
|
|
128
|
+
A `z_file()` field an AI agent must fill needs no extra authoring: when the operation is exposed over MCP,
|
|
129
|
+
the engine derives an upload-grant tool for the field and tells the agent where the `fileId` comes from —
|
|
130
|
+
see `resource-mcp-tool-exposure`. Never widen a file field to accept inline bytes or base64 for that reason.
|
|
131
|
+
|
|
128
132
|
### Step 4: Apply structural decorators deliberately
|
|
129
133
|
|
|
130
134
|
Use structural decorators to express **system truth**, not presentation:
|
|
@@ -161,6 +165,18 @@ schema-family contract.
|
|
|
161
165
|
Before leaving the file:
|
|
162
166
|
|
|
163
167
|
- export the schema and inferred type
|
|
168
|
+
- **export every ENUM the schema declares from the module barrel, beside the schema.** A TypeScript
|
|
169
|
+
enum is a NOMINAL type: the compiler writes an inferred type by NAME, so a consumer that cannot
|
|
170
|
+
name your enum cannot derive anything from your schema. The specification package is the first
|
|
171
|
+
consumer to try, and it fails like this — in ITS file, nowhere near the enum:
|
|
172
|
+
|
|
173
|
+
```
|
|
174
|
+
TS2742: The inferred type of 'myResourceSpecification' cannot be named without a reference to
|
|
175
|
+
'../../../../node_modules/@my-app/shared-lib/dist/esm/modules/<module>/resources/<res>/<res>.schemas'
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
The schema compiles, its own package typechecks, and the break lands in another package that did
|
|
179
|
+
nothing wrong — which is why this belongs on the checklist rather than in a reader's memory.
|
|
164
180
|
- keep naming and existing schema-family conventions intact
|
|
165
181
|
- make sure enum fields use a TypeScript enum and `z.enum(MyEnum)`
|
|
166
182
|
- confirm sensitive data uses `.isBackendOnly()`, not `.isHidden()`
|
|
@@ -196,7 +212,18 @@ What earns its place here:
|
|
|
196
212
|
|
|
197
213
|
- `enum Todos_Priority { ... }` is a **named TypeScript enum**, not an
|
|
198
214
|
inline `['low', 'medium', ...]` array. The framework relies on the named
|
|
199
|
-
vocabulary downstream (specs, UI, i18n)
|
|
215
|
+
vocabulary downstream (specs, UI, i18n) — and because those consumers live
|
|
216
|
+
in OTHER packages, the enum is re-exported from the module barrel beside
|
|
217
|
+
the schema, exactly as the application does for every enum it declares:
|
|
218
|
+
|
|
219
|
+
```ts
|
|
220
|
+
// <module>/resources/index.ts
|
|
221
|
+
export { Todos_Schema, Todos_Status, Todos_Priority } from './todos/todos.schemas';
|
|
222
|
+
export type { Todos } from './todos/todos.schemas';
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
Declaring the enum and forgetting this line is the single most common way a
|
|
226
|
+
correct schema breaks a package its author never opened (see Step 6).
|
|
200
227
|
- `z.enum(Todos_Priority).default(Todos_Priority.MEDIUM)` is the canonical
|
|
201
228
|
shape — typed, with a sensible default that doesn't force users to pick
|
|
202
229
|
on create.
|
|
@@ -242,10 +269,13 @@ shared schema declares the **truth**, the UI behavior file declares the
|
|
|
242
269
|
- `references/polymorphic-per-scope-resources.md` — per-scope (org/app/user) polymorphic resources: singleton vs multi-row + one-per-scope uniqueness
|
|
243
270
|
- `references/framework-shared-decorator-methods-api.md` — source-backed shared decorator method surface
|
|
244
271
|
- `references/framework-shared-structural-params-api.md` — source-backed shared structural param contracts
|
|
245
|
-
- `references/framework-special-factories-api.md` — source-backed special factory definitions
|
|
272
|
+
- `references/framework-special-factories-api.md` — source-backed special factory definitions, including the per-nature `z_file()` constraint bags (`maxWidth`, `aspectRatio`, and the opt-OUT `generateThumbnails`)
|
|
246
273
|
- `references/framework-schema-family-api.md` — source-backed `createSchemaFamily` contract
|
|
247
274
|
- `references/framework-polymorphic-resources-api.md` — source-backed `PolymorphicVariantDefinition` + `optOutPolymorphicAutoBusinessKey` contract
|
|
248
275
|
- `references/framework-decorator-vocabulary-api.md` — source-backed `ZodDecorator` enum + `SCHEMA_METADATA` symbol
|
|
276
|
+
- `references/framework-personal-data-category-api.md` — source-backed `.dataCategories()` + `PersonalDataCategory` vocabulary, for any field holding personal data
|
|
277
|
+
- `references/framework-system-managed-fields-api.md` — source-backed list of the field names the framework owns and strips from every create/update contract, and why declaring one as required fails every submit
|
|
278
|
+
- `references/framework-erasure-scrub-treatments-api.md` — source-backed `RedactionType` vocabulary for `.impersonalizeWith()`: which treatments an erasure accepts, which two it refuses at run time, and how to scrub a non-nullable field that carries a `.default()`
|
|
249
279
|
- `references/framework-zod-lifecycle-and-chainable-api.md` — lifecycle structural params + chainable runtime (`initZodDecorators` alignment)
|
|
250
280
|
- `examples/add-enum-field-with-ui.example.md` — worked three-layer example
|
|
251
281
|
- `examples/basic-resource-schema.example.md` — full from-scratch resource schema
|
package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md
CHANGED
|
@@ -26,7 +26,8 @@ export enum Projects_Status {
|
|
|
26
26
|
export const Projects_Schema = z.object({
|
|
27
27
|
_id: z.string().min(1).isPrimaryKey().isSummaryField(),
|
|
28
28
|
organizationId: z.string().min(1).isDBIndexed().isForeignKey().isSummaryField().excludeFromUpdate(),
|
|
29
|
-
|
|
29
|
+
// Optional: the engine stamps it from the initiator's user, and a machine principal has none.
|
|
30
|
+
createdByUserId: z.string().min(1).isDBIndexed().isForeignKey().excludeFromUpdate().optional(),
|
|
30
31
|
|
|
31
32
|
name: z.string().min(1).max(100).isSummaryField(),
|
|
32
33
|
description: z.string().max(2000).optional(),
|
|
@@ -32,6 +32,23 @@ When the answer is "shared schema", choose the next reference by need:
|
|
|
32
32
|
- `field-type-selection.md` -> whether the field should be primitive, enum, FK, or a domain factory
|
|
33
33
|
- `special-factories.md` -> when to use `z_money()`, `z_file()`, `z_range()`, and similar helpers
|
|
34
34
|
- `schema-variants-and-discriminators.md` -> discriminator and schema-family changes
|
|
35
|
+
- `framework-personal-data-category-api.md` -> the field holds data about a PERSON and needs a
|
|
36
|
+
`.dataCategories(...)` declaration
|
|
37
|
+
|
|
38
|
+
## Personal data is a shared-schema concern
|
|
39
|
+
|
|
40
|
+
If the field holds data about a person, the shared schema is where you say so — all four axes live
|
|
41
|
+
there and none of them is a UI or specification concern:
|
|
42
|
+
|
|
43
|
+
| Question | Declaration |
|
|
44
|
+
|---|---|
|
|
45
|
+
| What KIND of personal data? | `.dataCategories(PersonalDataCategory.…)` |
|
|
46
|
+
| What happens on ERASURE? | `.impersonalizeWith(RedactionType.…)` |
|
|
47
|
+
| Where did it come from (Art. 20)? | `.portabilityProvenance(DataPortabilityProvenance.…)` |
|
|
48
|
+
|
|
49
|
+
Declare the category on the same line you declare the scrub treatment. A field carrying one and not
|
|
50
|
+
the other is reported by name as an OUTSTANDING gap in every compliance document the application
|
|
51
|
+
produces — the application has said the field holds personal data and has not said what kind.
|
|
35
52
|
|
|
36
53
|
## Escalate Early
|
|
37
54
|
|
|
@@ -60,6 +60,40 @@ export enum ZodDecorator {
|
|
|
60
60
|
* `SUBJECT_PROVIDED` and masked on erasure.
|
|
61
61
|
*/
|
|
62
62
|
PORTABILITY_PROVENANCE = "portabilityProvenance",
|
|
63
|
+
/**
|
|
64
|
+
* Data categories: WHICH KINDS of personal data this field holds — one or more
|
|
65
|
+
* `PersonalDataCategory` values (strings), read by the compliance fact producer to answer the
|
|
66
|
+
* privacy-notice question "which categories of personal data do you process".
|
|
67
|
+
*
|
|
68
|
+
* Authored fluently: `email: z.email().dataCategories(PersonalDataCategory.CONTACT_DETAILS)`, or
|
|
69
|
+
* with an array when a field genuinely spans two —
|
|
70
|
+
* `.dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])`.
|
|
71
|
+
* The chokepoint normalizes either form to a deduped array, so every reader sees one shape.
|
|
72
|
+
* At least one category is REQUIRED and each must be a non-empty string: a blank declaration
|
|
73
|
+
* would read back as declared-but-meaningless, which is worse than absent, because absence is
|
|
74
|
+
* what the gap report is looking for. `addDataCategories(schema, categories)` is the equivalent
|
|
75
|
+
* programmatic escape hatch; read them back with `getDataCategories(schema)`.
|
|
76
|
+
*
|
|
77
|
+
* WHETHER each value is a real `PersonalDataCategory` member is checked by the resource factory's
|
|
78
|
+
* boot guard, which owns the enum — this layer knows only that non-empty strings were declared.
|
|
79
|
+
*
|
|
80
|
+
* ⚠️ Four adjacent axes, none of them this one. {@link ZodDecorator.IMPERSONALIZE_WITH} says what
|
|
81
|
+
* happens to the value on ERASURE; {@link ZodDecorator.PORTABILITY_PROVENANCE} says where it CAME
|
|
82
|
+
* FROM; `Compliance_DataClassification` is a SENSITIVITY ladder for flows-actors config; a
|
|
83
|
+
* retention class says HOW LONG it is kept. A single field is routinely all five at once, and
|
|
84
|
+
* none of the other four can answer "what kind of personal data is this".
|
|
85
|
+
*
|
|
86
|
+
* ⚠️ Do NOT declare a category on a field merely because its NAME suggests one. The decorator
|
|
87
|
+
* exists precisely so categories are never derived from identifiers: `email`, `phone` and
|
|
88
|
+
* `dateOfBirth` are suggestive while `notes` is not, and an inventory assembled by
|
|
89
|
+
* pattern-matching names is a guess whose misses are silently undisclosed. `CREDENTIALS` is the
|
|
90
|
+
* one category the producer derives, and it derives it from `.isPassword()` / `.isOtp()` /
|
|
91
|
+
* `.isWriteOnlySecret()` — markers the author wrote, not names it read.
|
|
92
|
+
*
|
|
93
|
+
* assurance-control: WILDO.PRIVACY.PERSONAL_DATA_INVENTORY — the application declares which
|
|
94
|
+
* categories of personal data each field holds
|
|
95
|
+
*/
|
|
96
|
+
DATA_CATEGORIES = "dataCategories",
|
|
63
97
|
/**
|
|
64
98
|
* Audit evidence: this field's BEFORE/AFTER VALUES are recorded when a resource operation
|
|
65
99
|
* mutates it, on the `resource_operation_performed` audit event.
|
|
@@ -78,10 +112,12 @@ export enum ZodDecorator {
|
|
|
78
112
|
* could ask to have erased.
|
|
79
113
|
*
|
|
80
114
|
* ⚠️ This is a WRITE-side claim — "when this field CHANGES, the change itself is evidence" — and
|
|
81
|
-
* is independent of the READ-side disclosure trail. The
|
|
82
|
-
*
|
|
83
|
-
* server-minted secret is first exposed
|
|
84
|
-
*
|
|
115
|
+
* is independent of the READ-side disclosure trail. The framework has exactly two disclosure
|
|
116
|
+
* triggers: `isBackendOnly({ isReturnedAtCreation: true })`, which fires one `FIELD_ACCESS` event
|
|
117
|
+
* when a server-minted secret is first exposed on a create, and `.isEphemeral()`, which fires on
|
|
118
|
+
* any operation so a rotate or regenerate is recorded as well. A field can carry any combination
|
|
119
|
+
* of the three markers. There is still no general "audit every read of this field" marker; do not
|
|
120
|
+
* go looking for one.
|
|
85
121
|
*
|
|
86
122
|
* assurance-control: WILDO.SECRETS.DISCLOSURE_AUDIT
|
|
87
123
|
*/
|
|
@@ -232,6 +268,12 @@ export type ZodDecorator_ParamsType = {
|
|
|
232
268
|
* normalize; if a second axis is ever needed the chokepoint widens exactly as that one did.
|
|
233
269
|
*/
|
|
234
270
|
[ZodDecorator.PORTABILITY_PROVENANCE]: string;
|
|
271
|
+
/**
|
|
272
|
+
* The field's personal-data categories — `PersonalDataCategory` values, typed as plain strings at
|
|
273
|
+
* this layer (zod-decorators sits below saas-models and cannot import the enum). Accepts a single
|
|
274
|
+
* value (the common case) or an array; the chokepoint normalizes either to a deduped array.
|
|
275
|
+
*/
|
|
276
|
+
[ZodDecorator.DATA_CATEGORIES]: string | readonly string[];
|
|
235
277
|
// Audit-evidence marker — parameterless, like IS_BUSINESS_KEY. A field either is evidence or is
|
|
236
278
|
// not; there is no axis to parameterize, and adding one would invite per-field redaction policy
|
|
237
279
|
// to grow here instead of on the impersonalization decorator that owns it.
|
|
@@ -324,6 +366,11 @@ export type ZodDecorator_Types = {
|
|
|
324
366
|
* (zod-decorators sits below saas-models). Stored exactly as authored; the chokepoint only
|
|
325
367
|
* rejects blanks. */
|
|
326
368
|
[ZodDecorator.PORTABILITY_PROVENANCE]: string;
|
|
369
|
+
/** Personal-data categories — `PersonalDataCategory` values carried as opaque `string`s
|
|
370
|
+
* (zod-decorators sits below saas-models). ALWAYS the normalized array, deduped and non-empty:
|
|
371
|
+
* the chokepoint widens a bare single-value authoring form on the way in, so every reader sees
|
|
372
|
+
* one shape and `getDataCategories` can answer "is this field categorized?" by presence alone. */
|
|
373
|
+
[ZodDecorator.DATA_CATEGORIES]: readonly string[];
|
|
327
374
|
/** Audit-evidence marker — stored as the bare `true` sentinel (parameterless, like IS_BUSINESS_KEY). */
|
|
328
375
|
[ZodDecorator.IS_AUDIT_EVIDENCE]: true;
|
|
329
376
|
/** RAG-source config — ALWAYS the normalized object ( `{}` when authored with no argument): the
|
|
@@ -429,6 +476,7 @@ export interface CustomFieldMetadata {
|
|
|
429
476
|
[ZodDecorator.IS_WRITE_ONLY_SECRET]?: ZodDecorator_Types[ZodDecorator.IS_WRITE_ONLY_SECRET];
|
|
430
477
|
[ZodDecorator.IMPERSONALIZE_WITH]?: ZodDecorator_Types[ZodDecorator.IMPERSONALIZE_WITH];
|
|
431
478
|
[ZodDecorator.PORTABILITY_PROVENANCE]?: ZodDecorator_Types[ZodDecorator.PORTABILITY_PROVENANCE];
|
|
479
|
+
[ZodDecorator.DATA_CATEGORIES]?: ZodDecorator_Types[ZodDecorator.DATA_CATEGORIES];
|
|
432
480
|
[ZodDecorator.IS_AUDIT_EVIDENCE]?: ZodDecorator_Types[ZodDecorator.IS_AUDIT_EVIDENCE];
|
|
433
481
|
[ZodDecorator.RAG_SOURCE]?: ZodDecorator_Types[ZodDecorator.RAG_SOURCE];
|
|
434
482
|
[ZodDecorator.IS_VIRTUAL]?: ZodDecorator_Types[ZodDecorator.IS_VIRTUAL];
|
|
@@ -501,13 +549,36 @@ export interface CustomFieldMetadata {
|
|
|
501
549
|
durationConfig?: DurationSchemaMetadata;
|
|
502
550
|
/** Phone schema configuration (only present for phone schemas) */
|
|
503
551
|
phoneConfig?: PhoneSchemaMetadata;
|
|
552
|
+
/** Address schema configuration (only present for address schemas) */
|
|
553
|
+
addressConfig?: AddressSchemaMetadata;
|
|
504
554
|
/** Code schema configuration (only present for code schemas) */
|
|
505
555
|
codeConfig?: CodeSchemaMetadata;
|
|
506
556
|
/** File schema configuration (only present for file schemas) */
|
|
507
557
|
fileConfig?: FileSchemaMetadata;
|
|
558
|
+
/**
|
|
559
|
+
* Set on an UPDATE request DTO object whose keys follow the PATCH write rule — see
|
|
560
|
+
* `RequestDtoWriteSemantics` and `markPatchRequestDtoObject`. Absent on every other object.
|
|
561
|
+
*/
|
|
562
|
+
requestDtoWriteSemantics?: RequestDtoWriteSemantics;
|
|
508
563
|
/** Versioned schema configuration (only present for versioned schemas) */
|
|
509
564
|
versionedConfig?: VersionedSchemaMetadata;
|
|
510
565
|
/** Versioned foreign key configuration (only present for versioned foreign key schemas) */
|
|
511
566
|
versionedForeignKeyConfig?: VersionedForeignKeySchemaMetadata;
|
|
512
567
|
}
|
|
568
|
+
|
|
569
|
+
/**
|
|
570
|
+
* How the keys of a request DTO OBJECT are written — the fact a form needs to decide how a field inside it
|
|
571
|
+
* is cleared (#989).
|
|
572
|
+
*
|
|
573
|
+
* Only one member exists because only one rule needs naming. A request DTO's UPDATE root is written PATCH
|
|
574
|
+
* style: an ABSENT key leaves the stored value untouched, so clearing needs an explicit `null`, and
|
|
575
|
+
* `toPatchOptionalField` admits that null. An object VALUE nested inside a field (`reminder`, an address)
|
|
576
|
+
* is written WHOLE instead: the persistence layer clears only top-level fields, a stored nested `null`
|
|
577
|
+
* would fail the main schema's `.optional()` on the next read, and absence is therefore the only clear.
|
|
578
|
+
* An object carrying no member is written whole.
|
|
579
|
+
*/
|
|
580
|
+
export enum RequestDtoWriteSemantics {
|
|
581
|
+
/** Absent key = untouched, `null` = clear. The UPDATE request DTO root, and a nested child's update branch. */
|
|
582
|
+
PATCH = 'patch',
|
|
583
|
+
}
|
|
513
584
|
```
|