@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -0,0 +1,182 @@
|
|
|
1
|
+
# Framework Erasure-Scrub Treatment API
|
|
2
|
+
|
|
3
|
+
This file exposes the **treatment vocabulary** — `RedactionType` — that you pass to
|
|
4
|
+
`.impersonalizeWith(...)` on a field.
|
|
5
|
+
|
|
6
|
+
Read it whenever you put an erasure treatment on a field. The decorator's own parameter surface types
|
|
7
|
+
the treatment as a plain string, because the decorator layer sits below the package that owns the
|
|
8
|
+
vocabulary — so the decorator contract can tell you a treatment is required and cannot tell you which
|
|
9
|
+
values are legal. This file is where the legal values live.
|
|
10
|
+
|
|
11
|
+
Use it when you need the real source contract for:
|
|
12
|
+
|
|
13
|
+
- which members exist, and what each one writes into the field
|
|
14
|
+
- **which members an erasure REFUSES** — two of the six are accepted by the type and throw when
|
|
15
|
+
somebody is actually erased
|
|
16
|
+
- how to scrub a non-nullable field that carries a `.default()`, which neither `REMOVE` nor `MASK`
|
|
17
|
+
can express
|
|
18
|
+
- the never-scrub floor, and the fields it already protects for you
|
|
19
|
+
|
|
20
|
+
## The one that costs the most to get wrong
|
|
21
|
+
|
|
22
|
+
`HASH` and `ENCRYPT` type-check on `.impersonalizeWith()` and are refused when the erasure runs, not
|
|
23
|
+
when you author the field. Choosing either leaves a resource that boots cleanly, passes review, and
|
|
24
|
+
fails the first time a real person asks to be erased.
|
|
25
|
+
|
|
26
|
+
Reach for them only in flow-actors `redactionRules`, which hide a value in a log or a response and
|
|
27
|
+
never rewrite the stored row.
|
|
28
|
+
|
|
29
|
+
## Choosing, in one pass
|
|
30
|
+
|
|
31
|
+
| the field you are treating | treatment |
|
|
32
|
+
|---|---|
|
|
33
|
+
| nullable / `.nullish()` | `REMOVE` |
|
|
34
|
+
| a constrained string the default mask cannot satisfy (`z.email()`, `z.uuid()`, `.min(n)`) | `MASK` with an explicit `maskValue` |
|
|
35
|
+
| non-nullable with a `.default()` — counters, settings objects, arrays, stage histories | `RESET` |
|
|
36
|
+
| must survive the erasure (an invoiced amount, a legally required date) | declare nothing |
|
|
37
|
+
| you want "never scrub this" stated out loud | `KEEP` |
|
|
38
|
+
|
|
39
|
+
`RESET` reads the value back from the field's own schema, so it cannot drift from the default the
|
|
40
|
+
field already declares. It refuses a field with no `.default()`, and it refuses a default that reads
|
|
41
|
+
the clock — otherwise erasing somebody would stamp `lastActiveAt` with the erasure's own timestamp
|
|
42
|
+
and record them as active at the moment they were erased.
|
|
43
|
+
|
|
44
|
+
## A FILE field: the treatment decides whether the stored file is erased
|
|
45
|
+
|
|
46
|
+
The same declaration governs `z_file()` fields, and it is the only thing that does — there is no
|
|
47
|
+
second axis for files. A field-level scrub cannot reach inside stored bytes (a passport scan stays a
|
|
48
|
+
passport scan however the row is rewritten), so for a file field the only real erasure is deleting
|
|
49
|
+
the file.
|
|
50
|
+
|
|
51
|
+
| the file field | what an erasure does |
|
|
52
|
+
|---|---|
|
|
53
|
+
| `.impersonalizeWith(RedactionType.REMOVE)` | the file is erased, and the pointer is nulled in the same write |
|
|
54
|
+
| `KEEP`, or no treatment at all | the file survives — this is how an invoice PDF that IS the retained record stays available |
|
|
55
|
+
|
|
56
|
+
Both directions have a consequence worth deciding on purpose:
|
|
57
|
+
|
|
58
|
+
- **An erased file is closed immediately, but its bytes are not.** The row is marked and its own
|
|
59
|
+
personal data (`originalFilename`, the uploader identity) is scrubbed in the same write, and the
|
|
60
|
+
metadata route then answers not-found — confirming that the identifier still resolves would itself
|
|
61
|
+
be a disclosure. Physical storage cleanup happens later, on the ordinary cleanup sweep.
|
|
62
|
+
- **A file you leave untreated stays ORDINARILY READABLE to its own scope, indefinitely**, through
|
|
63
|
+
the global file route, even after the parent row has become invisible. That route is not
|
|
64
|
+
resource-scoped and re-checks only the file's own scope, so the parent's retention does not hide
|
|
65
|
+
it. Keeping the file is a decision to keep it reachable, not merely to keep it stored.
|
|
66
|
+
|
|
67
|
+
There is no middle state. A file cannot be retained-but-hidden, so if a document is both legally
|
|
68
|
+
required and must stop being ordinarily visible, neither answer here is right — say so rather than
|
|
69
|
+
picking the closer one.
|
|
70
|
+
|
|
71
|
+
## Declare a category beside the treatment
|
|
72
|
+
|
|
73
|
+
A field carrying `.impersonalizeWith()` and no `.dataCategories(...)` is reported BY NAME as an
|
|
74
|
+
outstanding gap in every compliance document the application produces. See
|
|
75
|
+
`references/framework-personal-data-category-api.md`.
|
|
76
|
+
|
|
77
|
+
## Erasure-Scrub Treatments
|
|
78
|
+
|
|
79
|
+
## Import Origins
|
|
80
|
+
|
|
81
|
+
- `@wildo-ai/saas-models`
|
|
82
|
+
|
|
83
|
+
## Source Excerpts
|
|
84
|
+
|
|
85
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
86
|
+
|
|
87
|
+
```typescript
|
|
88
|
+
*
|
|
89
|
+
* How one field's value is replaced when it is redacted or scrubbed.
|
|
90
|
+
*
|
|
91
|
+
* Imported from `@wildo-ai/saas-models`.
|
|
92
|
+
*
|
|
93
|
+
* ## Two consumers, and only one of them accepts every member
|
|
94
|
+
*
|
|
95
|
+
* | consumer | what it does | accepts |
|
|
96
|
+
* |---|---|---|
|
|
97
|
+
* | flow-actors `redactionRules` | hides a value in a LOG or an API RESPONSE; the stored row is untouched | every member |
|
|
98
|
+
* | `.impersonalizeWith(...)` on a schema field | ERASURE scrub: permanently rewrites the stored value when the person is erased and the row is retained | `REMOVE` · `MASK` · `RESET` · `KEEP` only |
|
|
99
|
+
*
|
|
100
|
+
* **`HASH` and `ENCRYPT` are accepted by the type and REFUSED at erasure time.** An erasure scrub is
|
|
101
|
+
* one static write shared by every row in the batch, so `HASH` — which would have to hash each row's
|
|
102
|
+
* own value — cannot be expressed and throws. `ENCRYPT` is reversible, and an erasure that can be
|
|
103
|
+
* undone is not an erasure, so it is forbidden here and stays a redaction-only option. Both throw
|
|
104
|
+
* when the erasure runs, not when you author the field, so choosing one leaves a resource that
|
|
105
|
+
* configures cleanly and fails the first time somebody is erased.
|
|
106
|
+
*
|
|
107
|
+
* ## Choosing a treatment for an erasure scrub
|
|
108
|
+
*
|
|
109
|
+
* | the field | treatment |
|
|
110
|
+
* |---|---|
|
|
111
|
+
* | nullable, or `.nullish()` | `REMOVE` — writes `null`. The default choice. |
|
|
112
|
+
* | a constrained string that cannot hold the default mask (`z.email()`, `z.uuid()`, `.min(n)`) | `MASK` with an explicit `maskValue` that satisfies the field's own schema |
|
|
113
|
+
* | NON-nullable and carries a `.default()` — a counter, a settings object, a stage history, an array | `RESET` — writes what the schema says the field is when nobody has set it |
|
|
114
|
+
* | the row's link to its tenant or its creator | nothing: the never-scrub floor already protects it |
|
|
115
|
+
*
|
|
116
|
+
* `RESET` is the one to reach for when the other two do not fit, and that case is common rather than
|
|
117
|
+
* exotic: `REMOVE` writes `null`, which fails the strict re-parse of the row the erasure just wrote,
|
|
118
|
+
* and `MASK` writes a string, which cannot express an array, a record, a number or a date.
|
|
119
|
+
*
|
|
120
|
+
* ⚠️ **`RESET` refuses a default that reads the clock.** `.default(() => new Date())` — or a literal
|
|
121
|
+
* `.default(new Date())` evaluated when the module loads — makes the erasure write its OWN timestamp,
|
|
122
|
+
* so a field such as `lastActiveAt` would record the erased person as active at the moment they were
|
|
123
|
+
* erased. That fabricates information rather than removing it. Give the field a static neutral
|
|
124
|
+
* default such as `new Date(0)`, which asserts "no recorded value", or make it nullable and use
|
|
125
|
+
* `REMOVE`, which asserts "unknown". Those are different claims about a person; choose deliberately.
|
|
126
|
+
*
|
|
127
|
+
* ## The never-scrub floor
|
|
128
|
+
*
|
|
129
|
+
* A row's link to the organization or application it belongs to, and its `createdByUserId`, are
|
|
130
|
+
* never scrubbed — even when a treatment is declared on them. They connect the retained row to the
|
|
131
|
+
* tenant that must keep it, and nulling them would orphan the record the retention exists to
|
|
132
|
+
* preserve. `KEEP` is the way to say the same thing explicitly about any other field.
|
|
133
|
+
*
|
|
134
|
+
* A field with NO `.impersonalizeWith()` is left untouched by an erasure. Declaring nothing is how a
|
|
135
|
+
* legally required value — an invoice line, an amount, a date — survives the erasure of the person
|
|
136
|
+
* the record names.
|
|
137
|
+
*
|
|
138
|
+
* @example Scrubbing a person out of a retained record
|
|
139
|
+
* ```ts
|
|
140
|
+
* import { RedactionType } from '@wildo-ai/saas-models';
|
|
141
|
+
*
|
|
142
|
+
* const contactSchema = z.object({
|
|
143
|
+
* // nullable → REMOVE
|
|
144
|
+
* phone: z.string().nullish().impersonalizeWith(RedactionType.REMOVE),
|
|
145
|
+
* // constrained string → MASK with a value the field's own schema accepts
|
|
146
|
+
* email: z.email().impersonalizeWith(RedactionType.MASK, { maskValue: 'erased@erased.invalid' }),
|
|
147
|
+
* // non-nullable with a default → RESET
|
|
148
|
+
* preferences: z.object({ digest: z.boolean() }).default({ digest: false })
|
|
149
|
+
* .impersonalizeWith(RedactionType.RESET),
|
|
150
|
+
* // no treatment → survives the erasure, deliberately
|
|
151
|
+
* invoicedAmount: z.number(),
|
|
152
|
+
* });
|
|
153
|
+
* ```
|
|
154
|
+
*/
|
|
155
|
+
export enum RedactionType {
|
|
156
|
+
/** Replace with a fixed mask. In an erasure scrub the value must satisfy the field's own schema — pass `maskValue` when the default mask does not. */
|
|
157
|
+
MASK = 'mask',
|
|
158
|
+
/** Remove / null the value. The default erasure scrub; requires a field that can actually hold `null`. */
|
|
159
|
+
REMOVE = 'remove',
|
|
160
|
+
/** Replace with a one-way hash. Redaction only — **throws** if an erasure scrub reaches it, because a scrub is one static write and cannot hash per row. */
|
|
161
|
+
HASH = 'hash',
|
|
162
|
+
/** Replace with a reversible ciphertext. Redaction only — **forbidden** for an erasure scrub, because a reversible erasure is not an erasure. */
|
|
163
|
+
ENCRYPT = 'encrypt',
|
|
164
|
+
/** Erasure scrub only: keep this field exactly as it is. The explicit form of the never-scrub floor. */
|
|
165
|
+
KEEP = 'keep',
|
|
166
|
+
/**
|
|
167
|
+
* Erasure scrub only: reset the field to its OWN schema default.
|
|
168
|
+
*
|
|
169
|
+
* The treatment for a field that is non-nullable and carries a `.default()`, where neither of the
|
|
170
|
+
* others reaches: `REMOVE` writes `null`, which fails the strict re-parse of the row the erasure
|
|
171
|
+
* just wrote, and `MASK` writes a string, while these fields are arrays, records, numbers, dates
|
|
172
|
+
* and objects.
|
|
173
|
+
*
|
|
174
|
+
* The value is read from the schema rather than authored a second time, so it cannot drift from
|
|
175
|
+
* the default the field already declares — and for a person's counters and settings, "what this is
|
|
176
|
+
* when nobody has set it" is exactly what an erasure should leave behind.
|
|
177
|
+
*
|
|
178
|
+
* Refused when the field declares no `.default()`, and refused when that default reads the clock.
|
|
179
|
+
*/
|
|
180
|
+
RESET = 'reset',
|
|
181
|
+
}
|
|
182
|
+
```
|
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
# Framework Personal-Data Category API
|
|
2
|
+
|
|
3
|
+
This file exposes the **per-field personal-data category declaration** — `.dataCategories(...)` —
|
|
4
|
+
and the `PersonalDataCategory` vocabulary behind it.
|
|
5
|
+
|
|
6
|
+
Read it when a field holds data about a PERSON and you need to say what kind. That is the question a
|
|
7
|
+
privacy notice answers first, and the only way the application can answer it is by declaring it here:
|
|
8
|
+
nothing in the framework infers a category from a field's name.
|
|
9
|
+
|
|
10
|
+
Use it when you need the real source contracts for:
|
|
11
|
+
|
|
12
|
+
- the closed `PersonalDataCategory` vocabulary — including which members are GDPR Art. 9 special
|
|
13
|
+
category data and why Art. 10 criminal-offence data sits outside that set
|
|
14
|
+
- the fluent `.dataCategories(...)` signature (single value or array)
|
|
15
|
+
- the `addDataCategories(schema, ...)` escape hatch, for a schema with no fluent surface —
|
|
16
|
+
`z_phone()` returns one, and a phone number is contact-detail personal data by definition
|
|
17
|
+
- the `getDataCategories(schema)` reader
|
|
18
|
+
|
|
19
|
+
## When to declare one
|
|
20
|
+
|
|
21
|
+
Declare a category on a field that holds personal data. Leave every other field undeclared — absence
|
|
22
|
+
is the normal state and is what the compliance gap report reads.
|
|
23
|
+
|
|
24
|
+
Two shortcuts to avoid:
|
|
25
|
+
|
|
26
|
+
- **Do not declare from the field's NAME.** `email`, `phone` and `dateOfBirth` are suggestive while
|
|
27
|
+
`notes` is not, so a category list assembled that way is a guess whose misses are silently
|
|
28
|
+
undisclosed. `credentials` is the one category the framework derives, and it derives it from the
|
|
29
|
+
`.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()` markers you already wrote.
|
|
30
|
+
- **Do not reach for `Compliance_DataClassification`.** It is a four-level SENSITIVITY ladder
|
|
31
|
+
(public / internal / confidential / restricted) for flows-actors configuration, and it answers
|
|
32
|
+
"how protected must this be" rather than "what kind of personal data is this".
|
|
33
|
+
|
|
34
|
+
## Adjacent axes it is NOT
|
|
35
|
+
|
|
36
|
+
A single field is routinely all four at once, and each has its own declaration:
|
|
37
|
+
|
|
38
|
+
| Question | Declaration |
|
|
39
|
+
|---|---|
|
|
40
|
+
| What KIND of personal data is this? | `.dataCategories(...)` |
|
|
41
|
+
| What happens to it on ERASURE? | `.impersonalizeWith(...)` |
|
|
42
|
+
| Where did it COME FROM (Art. 20 scope)? | `.portabilityProvenance(...)` |
|
|
43
|
+
| How long is it kept? | the application's `dataRetention` schedule, by retention class |
|
|
44
|
+
|
|
45
|
+
If you declare `.impersonalizeWith()` on a field, declare a category too — the framework reports a
|
|
46
|
+
field that is personal by one declaration and uncategorized by another as an OUTSTANDING gap, by
|
|
47
|
+
name, in every compliance document it produces.
|
|
48
|
+
|
|
49
|
+
## Personal-Data Category
|
|
50
|
+
|
|
51
|
+
## Import Origins
|
|
52
|
+
|
|
53
|
+
- `@wildo-ai/saas-models`
|
|
54
|
+
- `@wildo-ai/zod-decorators`
|
|
55
|
+
|
|
56
|
+
## Source Excerpts
|
|
57
|
+
|
|
58
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
59
|
+
|
|
60
|
+
```typescript
|
|
61
|
+
*/
|
|
62
|
+
export enum PersonalDataCategory {
|
|
63
|
+
/** Who the person is: name, username, display name, account identifier, avatar. */
|
|
64
|
+
IDENTITY = 'identity',
|
|
65
|
+
/** How the person is reached: email address, telephone number, postal address. */
|
|
66
|
+
CONTACT_DETAILS = 'contact-details',
|
|
67
|
+
/**
|
|
68
|
+
* What proves the person is who they claim: passwords, MFA secrets, API keys, session tokens.
|
|
69
|
+
*
|
|
70
|
+
* Rarely authored by hand — the fact producer DERIVES this category from `.isPassword()`,
|
|
71
|
+
* `.isOtp()` and `.isWriteOnlySecret()`, which are declarations the application already makes.
|
|
72
|
+
* Declare it explicitly only for a credential those markers do not cover.
|
|
73
|
+
*/
|
|
74
|
+
CREDENTIALS = 'credentials',
|
|
75
|
+
/** Money: payment-method references, invoices, billing details, transaction history. */
|
|
76
|
+
FINANCIAL = 'financial',
|
|
77
|
+
/** What the person did in the product: activity records, timestamps, device and telemetry data. */
|
|
78
|
+
USAGE = 'usage',
|
|
79
|
+
/** Where the person is or was: coordinates, derived region, IP-inferred location. */
|
|
80
|
+
LOCATION = 'location',
|
|
81
|
+
/**
|
|
82
|
+
* What the person wrote or uploaded: free text, notes, attachments.
|
|
83
|
+
*
|
|
84
|
+
* ⚠️ Free text is the category that can silently contain any other one — a "notes" field may hold
|
|
85
|
+
* health information nobody declared. Declaring `USER_CONTENT` states what the field is FOR; it
|
|
86
|
+
* does not certify what it will contain, and no schema can. Where a free-text field is
|
|
87
|
+
* FORESEEABLY used for a special category, declare that member alongside.
|
|
88
|
+
*/
|
|
89
|
+
USER_CONTENT = 'user-content',
|
|
90
|
+
/** The person's working life: employer, job title, professional relationship to the operator. */
|
|
91
|
+
PROFESSIONAL = 'professional',
|
|
92
|
+
|
|
93
|
+
// ── GDPR Art. 9(1), verbatim and closed. Processing needs an Art. 9(2) condition of its own,
|
|
94
|
+
// over and above the Art. 6 lawful basis every other member already needs.
|
|
95
|
+
/** Art. 9(1): racial or ethnic origin. */
|
|
96
|
+
SPECIAL_CATEGORY_RACIAL_OR_ETHNIC_ORIGIN = 'special-category:racial-or-ethnic-origin',
|
|
97
|
+
/** Art. 9(1): political opinions. */
|
|
98
|
+
SPECIAL_CATEGORY_POLITICAL_OPINIONS = 'special-category:political-opinions',
|
|
99
|
+
/** Art. 9(1): religious or philosophical beliefs. */
|
|
100
|
+
SPECIAL_CATEGORY_RELIGIOUS_OR_PHILOSOPHICAL_BELIEFS = 'special-category:religious-or-philosophical-beliefs',
|
|
101
|
+
/** Art. 9(1): trade union membership. */
|
|
102
|
+
SPECIAL_CATEGORY_TRADE_UNION_MEMBERSHIP = 'special-category:trade-union-membership',
|
|
103
|
+
/** Art. 9(1): genetic data. */
|
|
104
|
+
SPECIAL_CATEGORY_GENETIC = 'special-category:genetic',
|
|
105
|
+
/**
|
|
106
|
+
* Art. 9(1): biometric data processed FOR THE PURPOSE OF uniquely identifying a natural person.
|
|
107
|
+
*
|
|
108
|
+
* The purpose qualifier is part of the law's definition, not a footnote: a photograph is ordinary
|
|
109
|
+
* `IDENTITY` data until it is put through facial recognition, at which point it becomes this.
|
|
110
|
+
*/
|
|
111
|
+
SPECIAL_CATEGORY_BIOMETRIC = 'special-category:biometric',
|
|
112
|
+
/** Art. 9(1): data concerning health. */
|
|
113
|
+
SPECIAL_CATEGORY_HEALTH = 'special-category:health',
|
|
114
|
+
/** Art. 9(1): data concerning a natural person's sex life or sexual orientation. */
|
|
115
|
+
SPECIAL_CATEGORY_SEX_LIFE_OR_SEXUAL_ORIENTATION = 'special-category:sex-life-or-sexual-orientation',
|
|
116
|
+
|
|
117
|
+
/**
|
|
118
|
+
* GDPR Art. 10: criminal convictions and offences.
|
|
119
|
+
*
|
|
120
|
+
* Deliberately NOT a member of {@link SPECIAL_CATEGORY_PERSONAL_DATA_CATEGORIES}. Art. 10 is a
|
|
121
|
+
* separate article with a different condition — processing requires official authority or a
|
|
122
|
+
* Member State law — so folding it into the Art. 9 set would attach the wrong legal test to it.
|
|
123
|
+
*/
|
|
124
|
+
CRIMINAL_OFFENCE = 'criminal-offence',
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* What the ENGINE deliberately does NOT declare, so its silence reads as a decision.
|
|
129
|
+
*
|
|
130
|
+
* Measured 2026-08-30: 48 of the 85 engine resource configurations declare at least one category. The rest are silent on
|
|
131
|
+
* purpose, in four groups:
|
|
132
|
+
*
|
|
133
|
+
* - **System machinery is not personal data, even when the row carries a `userId`.** A queue
|
|
134
|
+
* execution, an entitlement limit, an unread counter, a token-budget counter — each exists so the
|
|
135
|
+
* platform can do its work, and the person's identifier on it is the LINK, not the datum. This
|
|
136
|
+
* group is the one that is easiest to get wrong, because such rows legitimately appear in a
|
|
137
|
+
* subject export: `systemAccessPolicy.exportSubject` means *rows here relate to a subject and
|
|
138
|
+
* belong in their bundle*, which is true by linkage alone. It does not mean the row holds a datum
|
|
139
|
+
* about them, and reading it that way once put `jobExecutions` in this inventory.
|
|
140
|
+
*
|
|
141
|
+
* - **A legal person is not a data subject.** `organizations`, `organizationUnits`,
|
|
142
|
+
* `organizationProfiles`, `organizationPreferences` and their siblings describe a COMPANY. GDPR
|
|
143
|
+
* Recital 14 excludes the processing of data concerning legal persons, so declaring
|
|
144
|
+
* `CONTACT_DETAILS` on an organization's switchboard number would make every notice claim the
|
|
145
|
+
* operator holds an individual's contact details that it does not. A small company's number is
|
|
146
|
+
* often a person's — that is a fact about the customer's data, not about this field's meaning.
|
|
147
|
+
* - **Configuration is not data about anyone.** SSO/SCIM/webhook configuration, API keys and OAuth
|
|
148
|
+
* clients owned by an organization, products, prices, promotions, ETL cursors. An organization's
|
|
149
|
+
* API key is a bearer secret whose subject is the organization; the person who minted it is not
|
|
150
|
+
* recorded on the row.
|
|
151
|
+
* - **A foreign key is LINKAGE, not a category.** `userId` on a usage row is what makes that usage
|
|
152
|
+
* personal; the category of the row's CONTENT is what a notice enumerates. Declaring `IDENTITY`
|
|
153
|
+
* on every owner FK would put "identity data" against resources holding no name, and tell a
|
|
154
|
+
* reader nothing the linkage does not already imply. The machinery group above is this same rule
|
|
155
|
+
* applied one level up, at the row rather than the field.
|
|
156
|
+
*
|
|
157
|
+
* The line between the first group and a real answer is not always obvious, and one pair is worth
|
|
158
|
+
* keeping side by side: a metered USAGE RECORD is declared while a TOKEN-BUDGET counter is not.
|
|
159
|
+
* Both count something a person consumed. The usage record is a per-event history with a timestamp —
|
|
160
|
+
* a record of what they did, which an Art. 15 copy must contain. The budget counter is a single
|
|
161
|
+
* mutable number that exists so a limiter can refuse the next call; nothing about the person
|
|
162
|
+
* survives in it. Ask what the row is FOR, not what it counts.
|
|
163
|
+
*
|
|
164
|
+
* Recorded here because absence is invisible. A future reader finding `organizationProfiles`
|
|
165
|
+
* undeclared should be able to see that it was considered, not assume it was missed — the same
|
|
166
|
+
* discipline a justified `N/A` serves in a verification matrix.
|
|
167
|
+
*/
|
|
168
|
+
|
|
169
|
+
/** Zod form of {@link PersonalDataCategory}. */
|
|
170
|
+
export const PersonalDataCategorySchema: z.ZodEnum<typeof PersonalDataCategory> = z.enum(PersonalDataCategory);
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* The GDPR Art. 9(1) members, as a set — the one place the Art. 9 line is drawn.
|
|
174
|
+
*
|
|
175
|
+
* Derived by PREFIX rather than hand-listed: every Art. 9 member's wire value begins
|
|
176
|
+
* `special-category:`, so a member added to the enum joins this set automatically. A hand-written
|
|
177
|
+
* list would be a second enumeration of a closed vocabulary, and the failure mode is silent — a new
|
|
178
|
+
* Art. 9 member omitted from it reads as ordinary personal data.
|
|
179
|
+
*/
|
|
180
|
+
export const SPECIAL_CATEGORY_PERSONAL_DATA_CATEGORIES: ReadonlySet<PersonalDataCategory> = new Set(
|
|
181
|
+
Object.values(PersonalDataCategory).filter((category) => category.startsWith('special-category:')),
|
|
182
|
+
);
|
|
183
|
+
|
|
184
|
+
/**
|
|
185
|
+
* Does this category carry the GDPR Art. 9 condition?
|
|
186
|
+
*
|
|
187
|
+
* `false` for {@link PersonalDataCategory.CRIMINAL_OFFENCE} — see that member's note. Callers that
|
|
188
|
+
* need "needs a condition beyond Art. 6" must test both.
|
|
189
|
+
*/
|
|
190
|
+
export function isSpecialCategoryPersonalData(category: PersonalDataCategory): boolean {
|
|
191
|
+
return SPECIAL_CATEGORY_PERSONAL_DATA_CATEGORIES.has(category);
|
|
192
|
+
}
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
196
|
+
|
|
197
|
+
```typescript
|
|
198
|
+
*/
|
|
199
|
+
export function getDataCategories(schema: z.ZodTypeAny): readonly string[] | undefined {
|
|
200
|
+
const metadata = getMetadataRecursive(schema);
|
|
201
|
+
const value = metadata?.[ZodDecorator.DATA_CATEGORIES];
|
|
202
|
+
return Array.isArray(value) && value.length > 0 ? (value as readonly string[]) : undefined;
|
|
203
|
+
}
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
207
|
+
|
|
208
|
+
```typescript
|
|
209
|
+
*
|
|
210
|
+
* Declare WHICH KINDS of personal data this field holds — the vocabulary a privacy notice
|
|
211
|
+
* enumerates. Import `PersonalDataCategory` from `@wildo-ai/saas-models`.
|
|
212
|
+
*
|
|
213
|
+
* Accepts a single category (the common case) or an array when a field genuinely spans two. At
|
|
214
|
+
* least one is required: a field that holds NO personal data carries no declaration at all, and
|
|
215
|
+
* that absence is exactly what the compliance gap report reads.
|
|
216
|
+
*
|
|
217
|
+
* Declare it on the field that holds the value. Never on a field merely because its NAME suggests
|
|
218
|
+
* a category — `credentials` is the one category the framework derives for you, and it derives it
|
|
219
|
+
* from `.isPassword()` / `.isOtp()` / `.isWriteOnlySecret()`, never from an identifier.
|
|
220
|
+
*
|
|
221
|
+
* @example
|
|
222
|
+
* fullName: z.string().dataCategories(PersonalDataCategory.IDENTITY)
|
|
223
|
+
* @example
|
|
224
|
+
* email: z.email().nullish().dataCategories(PersonalDataCategory.CONTACT_DETAILS)
|
|
225
|
+
* @example
|
|
226
|
+
* // A field that genuinely spans two — an array never forces you to pick a lie.
|
|
227
|
+
* dietaryNotes: z.string().dataCategories([PersonalDataCategory.USER_CONTENT, PersonalDataCategory.SPECIAL_CATEGORY_HEALTH])
|
|
228
|
+
*/
|
|
229
|
+
[ZodDecorator.DATA_CATEGORIES](categories: string | readonly string[]): DecoratedPrimitiveZodType<T>;
|
|
230
|
+
```
|
|
231
|
+
|
|
232
|
+
### Origin Package: `@wildo-ai/zod-decorators`
|
|
233
|
+
|
|
234
|
+
```typescript
|
|
235
|
+
*/
|
|
236
|
+
export function addDataCategories<T extends z.ZodTypeAny>(
|
|
237
|
+
schema: T,
|
|
238
|
+
categories: string | readonly string[],
|
|
239
|
+
): T {
|
|
240
|
+
ensureZodDecoratorsLoaded(z);
|
|
241
|
+
return addDecorators(schema, [
|
|
242
|
+
{ ref: ZodDecorator.DATA_CATEGORIES, params: categories },
|
|
243
|
+
]);
|
|
244
|
+
}
|
|
245
|
+
```
|
|
@@ -24,10 +24,45 @@ Use it when you need to confirm:
|
|
|
24
24
|
isDBIndexed: function(this: z.ZodTypeAny): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [ZodDecorator.IS_DB_INDEXED]); },
|
|
25
25
|
isForeignKey: function(this: z.ZodTypeAny, params?: ZodDecorator_ParamsType[ZodDecorator.IS_FOREIGN_KEY]): DecoratedPrimitiveZodType<z.ZodTypeAny> { return params ? addDecorators(this, [{ ref: ZodDecorator.IS_FOREIGN_KEY, params}]) : addDecorators(this, [ZodDecorator.IS_FOREIGN_KEY]); },
|
|
26
26
|
isSummaryField: function(this: z.ZodTypeAny, params?: ZodDecorator_ParamsType[ZodDecorator.IS_SUMMARY_FIELD]): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [{ ref: ZodDecorator.IS_SUMMARY_FIELD, params}]); },
|
|
27
|
+
/**
|
|
28
|
+
* The field never crosses the client boundary, in EITHER direction — stripped from the response
|
|
29
|
+
* DTO, the summary DTO and the context DTO alike, and from the write DTOs too.
|
|
30
|
+
*
|
|
31
|
+
* `{ isReturnedAtCreation: true }` carves out the one exception: the field IS returned on `CREATE`
|
|
32
|
+
* / `CREATE_MANY`, and each such disclosure emits a field-access AUDIT row naming the stored
|
|
33
|
+
* artifact. Marking a field this way therefore creates an audit obligation as well as an exposure.
|
|
34
|
+
*/
|
|
27
35
|
isBackendOnly: function(this: z.ZodTypeAny, params?: ZodDecorator_ParamsType[ZodDecorator.IS_BACKEND_ONLY]): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [{ ref: ZodDecorator.IS_BACKEND_ONLY, params}]); },
|
|
28
36
|
isWriteOnlySecret: function(this: z.ZodTypeAny, params?: ZodDecorator_ParamsType[ZodDecorator.IS_WRITE_ONLY_SECRET]): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [{ ref: ZodDecorator.IS_WRITE_ONLY_SECRET, params}]); },
|
|
29
37
|
isDiscriminator: function(this: z.ZodTypeAny, params?: ZodDecorator_ParamsType[ZodDecorator.IS_DISCRIMINATOR]): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [{ ref: ZodDecorator.IS_DISCRIMINATOR, params}]); },
|
|
38
|
+
/**
|
|
39
|
+
* Keep this field out of the CREATE contract — the server owns its initial value.
|
|
40
|
+
*
|
|
41
|
+
* ⚠️ **A client that sends it anyway gets a SUCCESS, and the value goes nowhere.** The field is
|
|
42
|
+
* removed from the create shape, so it is stripped before validation rather than refused. That is
|
|
43
|
+
* deliberate mass-assignment protection, and it means a form that collects the field submits
|
|
44
|
+
* silently-discarded data with nothing to notice.
|
|
45
|
+
*
|
|
46
|
+
* This is NOT how the update side behaves — see `excludeFromUpdate`. The two decorators read as a
|
|
47
|
+
* pair and do opposite things on a violation.
|
|
48
|
+
*/
|
|
30
49
|
excludeFromCreate: function(this: z.ZodTypeAny): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [ZodDecorator.EXCLUDE_FROM_CREATE]); },
|
|
50
|
+
/**
|
|
51
|
+
* Keep this field out of the UPDATE contract — it may be set at creation and not changed after.
|
|
52
|
+
*
|
|
53
|
+
* ⚠️ **A client that ATTEMPTS TO CHANGE it is REFUSED with a 4xx**, not silently stripped. The
|
|
54
|
+
* asymmetry with `excludeFromCreate` is intended: a create carrying a server-owned field is
|
|
55
|
+
* usually an over-broad form, while an update changing a read-only field is a caller asserting
|
|
56
|
+
* something it may not, and telling it so is more useful than dropping the change.
|
|
57
|
+
*
|
|
58
|
+
* Sending the field with its CURRENT value is not an attempt to change it and is accepted — the
|
|
59
|
+
* comparison handles the shapes an echo really takes (a `Date` resent as an ISO string, an id
|
|
60
|
+
* resent as a string against a stored driver object).
|
|
61
|
+
*
|
|
62
|
+
* LIMITATION: a read-only field whose value is a plain OBJECT or ARRAY compares equal to any other
|
|
63
|
+
* object, so a change to one is not detected and is not refused. Prefer a scalar for a field you
|
|
64
|
+
* need this guard to protect.
|
|
65
|
+
*/
|
|
31
66
|
excludeFromUpdate: function(this: z.ZodTypeAny): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [ZodDecorator.EXCLUDE_FROM_UPDATE]); },
|
|
32
67
|
isUnique: function(this: z.ZodTypeAny, params?: ZodDecorator_ParamsType[ZodDecorator.IS_UNIQUE]): DecoratedPrimitiveZodType<z.ZodTypeAny> { return addDecorators(this, [{ ref: ZodDecorator.IS_UNIQUE, params}]); },
|
|
33
68
|
// isPrimaryKey is a composite decorator: implies excludeFromCreate + isHidden + isUnique(sparse:false) + isDBIndexed
|
|
@@ -52,6 +52,21 @@ export interface ForeignKeyStructuralParams {
|
|
|
52
52
|
* (e.g. `referrerScopeType`). Without it, `polymorphicVariants` is rename-only.
|
|
53
53
|
*/
|
|
54
54
|
polymorphicDiscriminatorField?: string;
|
|
55
|
+
/**
|
|
56
|
+
* EXPLICIT target resource type, for an FK whose FIELD NAME cannot resolve it.
|
|
57
|
+
*
|
|
58
|
+
* The frontend resolves a reference field's target through the field-name → resource map
|
|
59
|
+
* (enriched from relationships' `foreignKeyField`). That works only when the field is named for
|
|
60
|
+
* its target (`assignedToUserId`) or a relationship declares it — and relationship FK names are
|
|
61
|
+
* held to the `Id`/`Ids` convention. A field that references a resource under its OWN vocabulary
|
|
62
|
+
* (`icpRefs` inside a specification document, a rename-only FK) has no honest entry in that map;
|
|
63
|
+
* declaring the target here lets the reference display resolve, label and navigate it without
|
|
64
|
+
* bending the field's name or the map's uniqueness.
|
|
65
|
+
*
|
|
66
|
+
* Takes precedence over the field-name map; polymorphic variants (above) still win over both,
|
|
67
|
+
* because a per-record discriminator is more specific than any static declaration.
|
|
68
|
+
*/
|
|
69
|
+
referencedResourceType?: string;
|
|
55
70
|
}
|
|
56
71
|
```
|
|
57
72
|
|
|
@@ -68,12 +83,18 @@ export interface BackendOnlyFieldParams {
|
|
|
68
83
|
* then stripped from all subsequent READ operations.
|
|
69
84
|
* Useful for secrets, API keys, etc. that should only be returned once.
|
|
70
85
|
*
|
|
71
|
-
* This is
|
|
86
|
+
* This is one of the framework's two disclosure-audit triggers: a field that carries it emits one
|
|
72
87
|
* `FIELD_ACCESS` audit event at the moment it is first (and last) exposed. That pairing is not a
|
|
73
|
-
* coincidence
|
|
88
|
+
* coincidence: first exposure is the only point at which a backend-only field crosses the client
|
|
74
89
|
* boundary at all, so it is the only point at which "this value left the system" is a true claim.
|
|
75
90
|
*
|
|
76
|
-
*
|
|
91
|
+
* The other trigger is `.isEphemeral()`, which fires on ANY operation rather than only on create,
|
|
92
|
+
* so a rotate or a regenerate that hands the secret over again is recorded too. The two answer
|
|
93
|
+
* different questions and neither implies the other: this one names the stored artifact, the
|
|
94
|
+
* ephemeral marker names the value actually handed over. A field may carry either, both, or
|
|
95
|
+
* neither, and one marked both is audited once.
|
|
96
|
+
*
|
|
97
|
+
* Scope limit worth knowing before relying on either: the audit event is raised from the TOP-LEVEL
|
|
77
98
|
* shape of the response DTO. A single `CREATE` is the reliably covered case; do not assume a
|
|
78
99
|
* bulk-create response gives you the same guarantee without checking.
|
|
79
100
|
*
|
|
@@ -182,13 +203,6 @@ export interface UniqueFieldParams {
|
|
|
182
203
|
*/
|
|
183
204
|
sparse?: boolean;
|
|
184
205
|
|
|
185
|
-
/**
|
|
186
|
-
* Custom error message to show when uniqueness is violated.
|
|
187
|
-
* Supports placeholder {fieldName} which is replaced with the actual field name.
|
|
188
|
-
* @example "This {fieldName} is already taken"
|
|
189
|
-
*/
|
|
190
|
-
errorMessage?: string;
|
|
191
|
-
|
|
192
206
|
/**
|
|
193
207
|
* The custom message reference the API returns when THIS field's unique index is violated.
|
|
194
208
|
*
|
|
@@ -265,8 +279,28 @@ export interface BusinessKeySetParams {
|
|
|
265
279
|
```typescript
|
|
266
280
|
*
|
|
267
281
|
* Parameters for the ttl decorator.
|
|
268
|
-
*
|
|
269
|
-
*
|
|
282
|
+
*
|
|
283
|
+
* Declares a ROW LIFETIME: rows of this resource are deleted once the instant derived from this
|
|
284
|
+
* Date field has passed. This is storage limitation — a compliance surface — not housekeeping, so
|
|
285
|
+
* the declaration is ADAPTER-NEUTRAL and means the same thing wherever the resource is stored.
|
|
286
|
+
*
|
|
287
|
+
* How the deletion happens differs, and you do not choose it:
|
|
288
|
+
* - on MongoDB, a native index expires the rows;
|
|
289
|
+
* - on PostgreSQL there is no equivalent, so a scheduled sweep deletes them in bounded batches.
|
|
290
|
+
*
|
|
291
|
+
* The sweep is registered whichever store is in use, so a resource that declares a lifetime is
|
|
292
|
+
* enforced on both. Do NOT read the MongoDB index as the mechanism and conclude the declaration is
|
|
293
|
+
* inert elsewhere.
|
|
294
|
+
*
|
|
295
|
+
* Two consequences worth knowing before you declare one:
|
|
296
|
+
* - the sweep is deliberately bounded per run, so a table receiving rows faster than they expire
|
|
297
|
+
* stays above its target until the rate changes; it reports when it stops early;
|
|
298
|
+
* - a resource CANNOT declare both a lifetime and retrieval-source fields (`.ragSource()`). That
|
|
299
|
+
* pair is refused at startup, because rows expiring under a native index leave with no
|
|
300
|
+
* application code running, so the derived search chunks could never be removed with them.
|
|
301
|
+
*
|
|
302
|
+
* This is unrelated to `retentionPolicy`, which decides what an ERASURE does to a row that must
|
|
303
|
+
* SURVIVE. This one decides whether the row lives at all.
|
|
270
304
|
*
|
|
271
305
|
* @example
|
|
272
306
|
* createdAt: z.date().ttl({ expireAfterSeconds: 3600 }) // Expire 1 hour after createdAt
|