@wildo-ai/framework-knowledge 1.1.3 → 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 +349 -17
- 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/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +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.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.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
|
@@ -83,12 +83,18 @@ export interface BackendOnlyFieldParams {
|
|
|
83
83
|
* then stripped from all subsequent READ operations.
|
|
84
84
|
* Useful for secrets, API keys, etc. that should only be returned once.
|
|
85
85
|
*
|
|
86
|
-
* This is
|
|
86
|
+
* This is one of the framework's two disclosure-audit triggers: a field that carries it emits one
|
|
87
87
|
* `FIELD_ACCESS` audit event at the moment it is first (and last) exposed. That pairing is not a
|
|
88
|
-
* coincidence
|
|
88
|
+
* coincidence: first exposure is the only point at which a backend-only field crosses the client
|
|
89
89
|
* boundary at all, so it is the only point at which "this value left the system" is a true claim.
|
|
90
90
|
*
|
|
91
|
-
*
|
|
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
|
|
92
98
|
* shape of the response DTO. A single `CREATE` is the reliably covered case; do not assume a
|
|
93
99
|
* bulk-create response gives you the same guarantee without checking.
|
|
94
100
|
*
|
|
@@ -305,13 +311,6 @@ export interface UniqueFieldParams {
|
|
|
305
311
|
*/
|
|
306
312
|
sparse?: boolean;
|
|
307
313
|
|
|
308
|
-
/**
|
|
309
|
-
* Custom error message to show when uniqueness is violated.
|
|
310
|
-
* Supports placeholder {fieldName} which is replaced with the actual field name.
|
|
311
|
-
* @example "This {fieldName} is already taken"
|
|
312
|
-
*/
|
|
313
|
-
errorMessage?: string;
|
|
314
|
-
|
|
315
314
|
/**
|
|
316
315
|
* The custom message reference the API returns when THIS field's unique index is violated.
|
|
317
316
|
*
|
|
@@ -389,8 +388,28 @@ export interface BusinessKeySetParams {
|
|
|
389
388
|
/**
|
|
390
389
|
*
|
|
391
390
|
* Parameters for the ttl decorator.
|
|
392
|
-
*
|
|
393
|
-
*
|
|
391
|
+
*
|
|
392
|
+
* Declares a ROW LIFETIME: rows of this resource are deleted once the instant derived from this
|
|
393
|
+
* Date field has passed. This is storage limitation — a compliance surface — not housekeeping, so
|
|
394
|
+
* the declaration is ADAPTER-NEUTRAL and means the same thing wherever the resource is stored.
|
|
395
|
+
*
|
|
396
|
+
* How the deletion happens differs, and you do not choose it:
|
|
397
|
+
* - on MongoDB, a native index expires the rows;
|
|
398
|
+
* - on PostgreSQL there is no equivalent, so a scheduled sweep deletes them in bounded batches.
|
|
399
|
+
*
|
|
400
|
+
* The sweep is registered whichever store is in use, so a resource that declares a lifetime is
|
|
401
|
+
* enforced on both. Do NOT read the MongoDB index as the mechanism and conclude the declaration is
|
|
402
|
+
* inert elsewhere.
|
|
403
|
+
*
|
|
404
|
+
* Two consequences worth knowing before you declare one:
|
|
405
|
+
* - the sweep is deliberately bounded per run, so a table receiving rows faster than they expire
|
|
406
|
+
* stays above its target until the rate changes; it reports when it stops early;
|
|
407
|
+
* - a resource CANNOT declare both a lifetime and retrieval-source fields (`.ragSource()`). That
|
|
408
|
+
* pair is refused at startup, because rows expiring under a native index leave with no
|
|
409
|
+
* application code running, so the derived search chunks could never be removed with them.
|
|
410
|
+
*
|
|
411
|
+
* This is unrelated to `retentionPolicy`, which decides what an ERASURE does to a row that must
|
|
412
|
+
* SURVIVE. This one decides whether the row lives at all.
|
|
394
413
|
*
|
|
395
414
|
* @example
|
|
396
415
|
* createdAt: z.date().ttl({ expireAfterSeconds: 3600 }) // Expire 1 hour after createdAt
|
|
@@ -761,6 +780,32 @@ function applySingleDecorator<T extends z.ZodTypeAny>(
|
|
|
761
780
|
currentMetadata[ZodDecorator.PORTABILITY_PROVENANCE] = raw;
|
|
762
781
|
break;
|
|
763
782
|
}
|
|
783
|
+
case ZodDecorator.DATA_CATEGORIES: {
|
|
784
|
+
// NORMALIZE HERE, not in the doors — the impersonalizeWith discipline. A single value (the
|
|
785
|
+
// common case) and an array both store a deduped ARRAY, so every reader sees one shape and
|
|
786
|
+
// `getDataCategories` answers "is this field categorized?" by presence alone.
|
|
787
|
+
//
|
|
788
|
+
// Fail LOUD on an empty declaration. An UNCATEGORIZED field is a legitimate, common state —
|
|
789
|
+
// most fields are not personal data — and the gap report is built on ABSENCE. A stored empty
|
|
790
|
+
// array would read back as declared-with-no-categories, which is invisible to a report
|
|
791
|
+
// looking for absence: the field would be silently excluded from the notice while looking
|
|
792
|
+
// annotated to anyone reading the schema.
|
|
793
|
+
//
|
|
794
|
+
// WHETHER each value is a real `PersonalDataCategory` member is checked by the resource
|
|
795
|
+
// factory's boot guard, which owns the enum — this layer knows only that non-empty strings
|
|
796
|
+
// were declared.
|
|
797
|
+
const raw = p as unknown;
|
|
798
|
+
const authored: readonly unknown[] = Array.isArray(raw) ? raw : [raw];
|
|
799
|
+
if (authored.length === 0 || authored.some((value) => typeof value !== 'string' || value.trim().length === 0)) {
|
|
800
|
+
throw new Error(
|
|
801
|
+
`dataCategories(categories) requires at least one non-empty PersonalDataCategory value (received ${JSON.stringify(raw)}). ` +
|
|
802
|
+
`A field that holds no personal data carries NO declaration — absence is what a category gap report reads. ` +
|
|
803
|
+
`An empty declaration looks annotated and discloses nothing.`,
|
|
804
|
+
);
|
|
805
|
+
}
|
|
806
|
+
currentMetadata[ZodDecorator.DATA_CATEGORIES] = [...new Set(authored as readonly string[])];
|
|
807
|
+
break;
|
|
808
|
+
}
|
|
764
809
|
case ZodDecorator.IS_AUDIT_EVIDENCE:
|
|
765
810
|
currentMetadata[ZodDecorator.IS_AUDIT_EVIDENCE] = true;
|
|
766
811
|
break;
|
|
@@ -1012,7 +1057,22 @@ function wrapInstanceMethodsForMetadata(schema: any): void {
|
|
|
1012
1057
|
|
|
1013
1058
|
|
|
1014
1059
|
|
|
1015
|
-
|
|
1060
|
+
/**
|
|
1061
|
+
* Install, per instance, every decorator `ZodDecorator_ApplyableType` admits for this schema.
|
|
1062
|
+
*
|
|
1063
|
+
* `decoratorTypeName` overrides the CONSTRUCTOR NAME the map is consulted with, and exists for
|
|
1064
|
+
* factories whose output is not the Zod type it behaves as. `z_phone()` is the case: it ends in
|
|
1065
|
+
* `.pipe(z.string())`, so its constructor is `ZodPipe` — a name that appears in NO entry of the
|
|
1066
|
+
* map. Every decorator was therefore skipped, and `z_phone()` shipped carrying **zero** of them
|
|
1067
|
+
* while `DecoratedPhoneSchema` declared eight, so `z_phone().isDBIndexed()` type-checked and threw
|
|
1068
|
+
* `TypeError`. Measured 2026-09-17: 0 decorators against 27–36 on every other factory.
|
|
1069
|
+
*
|
|
1070
|
+
* The override is deliberately an explicit ARGUMENT rather than an automatic unwrap of `ZodPipe`.
|
|
1071
|
+
* A pipe's decorator surface is a statement about what the factory built, which only the factory
|
|
1072
|
+
* knows: unwrapping generically would hand the string surface to every pipe in the framework,
|
|
1073
|
+
* including ones whose output is not a string at all.
|
|
1074
|
+
*/
|
|
1075
|
+
export function addChainableMethods<T extends z.ZodTypeAny>(schema: T, decoratorTypeName?: string): T {
|
|
1016
1076
|
const decoratedSchema = schema as DecoratedPrimitiveZodType<T>;
|
|
1017
1077
|
|
|
1018
1078
|
// CRITICAL: Wrap instance methods that return new instances to preserve metadata
|
|
@@ -1023,7 +1083,7 @@ export function addChainableMethods<T extends z.ZodTypeAny>(schema: T): T {
|
|
|
1023
1083
|
}
|
|
1024
1084
|
}
|
|
1025
1085
|
|
|
1026
|
-
const ctorName = (decoratedSchema as any)?.constructor?.name as string | undefined;
|
|
1086
|
+
const ctorName = decoratorTypeName ?? ((decoratedSchema as any)?.constructor?.name as string | undefined);
|
|
1027
1087
|
|
|
1028
1088
|
for (const decorator of Object.values(ZodDecorator)) {
|
|
1029
1089
|
const applyable = ZodDecorator_ApplyableType[decorator];
|
|
@@ -52,11 +52,34 @@ not a singleton.
|
|
|
52
52
|
|
|
53
53
|
For a singleton, the database itself enforces **at most one row per scope**, so
|
|
54
54
|
code that reads "the config for this org" can rely on a single row. The
|
|
55
|
-
framework keeps that row *present* by seeding a disabled-default
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
the
|
|
55
|
+
framework keeps that row *present* by seeding a disabled-default (and, for a few
|
|
56
|
+
auth configs, lazily materialising it on first read), so a singleton read returns
|
|
57
|
+
the honest "feature available, switched off" state rather than a missing-row
|
|
58
|
+
error. You do not manage that lifecycle — you consume the guaranteed single row,
|
|
59
|
+
and you do not register those seeds: the framework registers its own.
|
|
60
|
+
|
|
61
|
+
### When you author your OWN polymorphic singleton, the two scopes need
|
|
62
|
+
### different triggers — and getting this wrong is invisible
|
|
63
|
+
|
|
64
|
+
If you declare a per-scope singleton of your own, you also own its seed, and the
|
|
65
|
+
ORG and APPLICATION variants are **not symmetric**:
|
|
66
|
+
|
|
67
|
+
| Scope | Trigger | Why |
|
|
68
|
+
|---|---|---|
|
|
69
|
+
| per-organization | `RESOURCE_LIFECYCLE` / `AFTER_CREATE` on `organizations` | Organizations keep being created, so the hook keeps firing and every new tenant gets its row |
|
|
70
|
+
| per-application | `ON_APP_INIT` | There is exactly **one** application row and it is created **once**, at the very first boot |
|
|
71
|
+
|
|
72
|
+
An `AFTER_CREATE` trigger on the application therefore fires once in the lifetime
|
|
73
|
+
of a deployment. It is correct on a brand-new database and **unreachable
|
|
74
|
+
everywhere else** — an application whose row already exists can never receive
|
|
75
|
+
that seed, and nothing reports it. What you see is a settings panel that answers
|
|
76
|
+
"couldn't load details" forever, because a singleton read of a row that does not
|
|
77
|
+
exist is a 404.
|
|
78
|
+
|
|
79
|
+
Use `ON_APP_INIT` with `anchorEntriesToScopeForeignKey: true`, which materialises
|
|
80
|
+
the resolved scope FK onto each entry's **business key** (never onto `data` — the
|
|
81
|
+
FK in both places makes the upsert conflict). A computed `entry({ triggeringRow })`
|
|
82
|
+
is not available to you there and is not needed.
|
|
60
83
|
|
|
61
84
|
## Recognizing them
|
|
62
85
|
|
|
@@ -44,6 +44,31 @@ export const TodoSchemaFamily = createSchemaFamily({
|
|
|
44
44
|
});
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
+
## Two checks that do NOT fire, and what they cost
|
|
48
|
+
|
|
49
|
+
`createSchemaFamily` validates a great deal at declaration time — a discriminator the base does not
|
|
50
|
+
contain, a value claimed by both the base and a variant, an enum value nothing accounts for. Two
|
|
51
|
+
gaps are worth knowing, because in both the family is legal and the check is simply silent.
|
|
52
|
+
|
|
53
|
+
**Exhaustiveness is only checked when the discriminator is an ENUM.** The validator reads the
|
|
54
|
+
discriminator field's enum values to decide what is unaccounted for; a discriminator declared as a
|
|
55
|
+
plain `z.string()` yields none, so the check returns without asserting anything. A family
|
|
56
|
+
discriminated on a free string is accepted and permanently unchecked — adding a variant later, or
|
|
57
|
+
forgetting one, is caught by nothing.
|
|
58
|
+
|
|
59
|
+
> Declare the discriminator as a named enum, and you get the exhaustiveness check for free. This is
|
|
60
|
+
> the practical reason to prefer one, beyond the vocabulary rule.
|
|
61
|
+
|
|
62
|
+
**At runtime an unrecognized discriminator value resolves to the BASE schema, not an error.** When a
|
|
63
|
+
row's value matches no variant and is not a declared base value, the resolver returns the main
|
|
64
|
+
schema rather than refusing. That deliberately keeps a read of an unexpected row working — but it
|
|
65
|
+
means a value that reached storage outside the declared set is validated, stripped and summarized
|
|
66
|
+
against the base, so variant-only fields on that row are invisible rather than reported.
|
|
67
|
+
|
|
68
|
+
The two compound: a free-string discriminator has no declaration-time check AND a silent runtime
|
|
69
|
+
fallback, so a typo'd variant value can round-trip through the application without anything
|
|
70
|
+
noticing. If the discriminator cannot be an enum, add your own check on the way in.
|
|
71
|
+
|
|
47
72
|
## Review Checklist
|
|
48
73
|
|
|
49
74
|
Before finishing a variant-related change, ask:
|
|
@@ -8,7 +8,7 @@ Use this file when you already know the field belongs in
|
|
|
8
8
|
| Field concern | Typical shared-layer decorators | Notes |
|
|
9
9
|
|---------------|---------------------------------|-------|
|
|
10
10
|
| Primary identifier | `.isPrimaryKey()` and often `.isSummaryField()` | Keep the resource identifiable in lists and references. |
|
|
11
|
-
| Ownership / audit FK | `.isDBIndexed().isForeignKey().excludeFromUpdate()` | Common for `organizationId`, `createdByUserId`, and similar fields. |
|
|
11
|
+
| Ownership / audit FK | `.isDBIndexed().isForeignKey().excludeFromUpdate()` | Common for `organizationId`, `createdByUserId`, and similar fields. Add `.optional()` to `createdByUserId` (and `updatedByUserId`): the engine stamps it from the acting USER, a machine principal (MCP, A2A, client credentials, workers) has none, and the backend reports a required one at startup. |
|
|
12
12
|
| User-visible summary field | `.isSummaryField()` | Use when the field should appear in list views or FK displays. |
|
|
13
13
|
| Immutable after creation | `.excludeFromUpdate()` | Use for ownership or one-time setup fields. |
|
|
14
14
|
| Server-managed field | `.excludeFromCreate()` and often `.excludeFromUpdate()` | Typical for timestamps and values the client must not control. |
|
|
@@ -12,9 +12,21 @@ flattened into a plain primitive.
|
|
|
12
12
|
| `z_range(type, options?)` | `{ from, to }` | Number/date/time intervals |
|
|
13
13
|
| `z_duration(options?)` | `{ value, unit }` | Durations that must keep unit meaning |
|
|
14
14
|
| `z_phone(options?)` | normalized phone string | Phone numbers with dedicated formatting/validation semantics |
|
|
15
|
+
| `z_address(options?)` | `{ line1, line2?, city, state?, postalCode?, country, coordinates? }` | Postal addresses that must be validated, normalized, compared (`isSameAddress`) or carry a geocode |
|
|
15
16
|
| `z_code(options?)` | `{ content, language }` | Code snippets or editable code payloads |
|
|
16
17
|
| `z_bigdecimal(options?)` | decimal string | Arbitrary precision numeric values |
|
|
17
18
|
|
|
19
|
+
## Not a factory: `versioned` / `z_foreignKeyVersioned`
|
|
20
|
+
|
|
21
|
+
`@wildo-ai/zod-decorators` also exports `versioned` and `z_foreignKeyVersioned`, and the names
|
|
22
|
+
promise more than they deliver. **Nothing in the framework consumes them** — there is no versioned
|
|
23
|
+
storage, no revision history, no as-of read, and no engine resource declares one.
|
|
24
|
+
|
|
25
|
+
They are schema helpers, not a versioning capability. Do not select one because a requirement asks
|
|
26
|
+
for document versions or an audit history: you would get an ordinary field whose name implies a
|
|
27
|
+
mechanism that does not exist. Model the requirement explicitly instead — a child resource carrying
|
|
28
|
+
the revisions, or a retained row (see `framework-erasure-scrub-treatments-api.md`).
|
|
29
|
+
|
|
18
30
|
## Shared-Layer Rule
|
|
19
31
|
|
|
20
32
|
These helpers still belong to the shared schema layer because they define
|
|
@@ -27,6 +39,28 @@ budget: z_money()
|
|
|
27
39
|
.excludeFromUpdate(),
|
|
28
40
|
```
|
|
29
41
|
|
|
42
|
+
## Virus scanning on a `z_file` field
|
|
43
|
+
|
|
44
|
+
`scanPolicy` decides whether an upload is scanned before anyone can download it:
|
|
45
|
+
|
|
46
|
+
| Value | Behaviour |
|
|
47
|
+
|---|---|
|
|
48
|
+
| omitted | Inherit the application default, which is derived from whether a scanner is reachable at all — provisioning the scanner service IS the opt-in, and there is no separate switch. |
|
|
49
|
+
| `'required'` | Always scan this field. If no scanner can run, the upload request still succeeds but the file ends `failed` and is never served. |
|
|
50
|
+
| `'skip'` | Never scan this field, even when the application has a scanner. |
|
|
51
|
+
|
|
52
|
+
A scanned upload moves through `scanning` to `clean`, or to `infected` / `quarantined`, or to
|
|
53
|
+
`failed`. Only `clean` (and the unscanned `uploaded`, `linked`, `orphaned`) are downloadable, so the
|
|
54
|
+
bytes are unreachable while the scan runs and permanently after an infected verdict.
|
|
55
|
+
|
|
56
|
+
Two startup refusals to expect:
|
|
57
|
+
|
|
58
|
+
- a field declaring `scanPolicy: 'required'` while the virus scanner is not configured — set
|
|
59
|
+
`CLAMAV_HOST` (the port has a default), or remove the policy;
|
|
60
|
+
- `YARA_ENABLED` set without `YARA_HOST` — the pattern scanner is enabled and unreachable.
|
|
61
|
+
|
|
62
|
+
A PDF-generated `z_file` cannot carry `scanPolicy`; it is an upload option.
|
|
63
|
+
|
|
30
64
|
## Do Not Flatten Them
|
|
31
65
|
|
|
32
66
|
Avoid replacing a domain factory with a plain primitive just because it is
|
|
@@ -68,15 +68,17 @@ and reference it from the `views: [...]` map.
|
|
|
68
68
|
**Typical:** `./frontend/src/modules/<module>/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
69
69
|
|
|
70
70
|
Use the same builder pattern (`resourceUIBehavior`, `sh`, `fieldDisplay`,
|
|
71
|
-
etc.) as sibling resources. If
|
|
72
|
-
|
|
73
|
-
`
|
|
71
|
+
etc.) as sibling resources. If a sibling exists, mirror its top-level
|
|
72
|
+
shape — module, helpers, `fields`, `views`, `layout`,
|
|
73
|
+
`relationshipOverrides` — and only diverge with a reason. The first
|
|
74
|
+
resource of a new application has no sibling; its surfaces are decided
|
|
75
|
+
from the resource itself (Step 7).
|
|
74
76
|
|
|
75
77
|
### Step 2: Classify the UI change
|
|
76
78
|
|
|
77
79
|
| Need | Read next |
|
|
78
80
|
|-------------------------------------|---------------------------------------------------------------------------------|
|
|
79
|
-
| Layout / sections
|
|
81
|
+
| Layout / sections / chrome | Step 7 — decide each surface; `references/surface-decisions.md` |
|
|
80
82
|
| Operation keys / `ResourceUIBehaviorConfig` / preset map | `references/framework-frontend-resource-ui-contracts-api.md` |
|
|
81
83
|
| Enum visuals + modes | `references/framework-enum-frontend-handling-api.md` |
|
|
82
84
|
| Display vs edit mode vocabulary | `references/framework-display-edit-modes-api.md` |
|
|
@@ -112,7 +114,10 @@ SEARCH); **custom** operations have **no** default and render a placeholder
|
|
|
112
114
|
`lucide-react` component (e.g. `icon: CheckSquare`). Every resource needs one.
|
|
113
115
|
- **Custom-operation icon** — set `iconOverride` on the operation's entry in
|
|
114
116
|
`views: [...]`, e.g.
|
|
115
|
-
`[MyOps.ARCHIVE, {
|
|
117
|
+
`[MyOps.ARCHIVE, { surface: ResourceOperationFrontendSurface.EMBEDDED, iconOverride: Archive }]`.
|
|
118
|
+
Import `ResourceOperationFrontendSurface` from `@wildo-ai/saas-models`.
|
|
119
|
+
`EMBEDDED` gives the action an interface without a standalone route; use
|
|
120
|
+
`ADDRESSABLE` for a linkable page or `API_ONLY` for an operation with no UI.
|
|
116
121
|
- Pass a component **reference** (`iconOverride: Archive`) — never a JSX element
|
|
117
122
|
(`<Archive />`). `IconLike` is `ComponentType | string`, so a
|
|
118
123
|
`StandardIconReference` string is also valid, but a `lucide-react` component is
|
|
@@ -124,9 +129,28 @@ In development, an unconfigured operation logs a one-time
|
|
|
124
129
|
`[IconRegistry] Operation "<resource>:<op>" has no icon …` warning — treat any
|
|
125
130
|
such warning as a missing `iconOverride`.
|
|
126
131
|
|
|
127
|
-
### Step 7:
|
|
132
|
+
### Step 7: Decide each surface, and state the decision (always)
|
|
128
133
|
|
|
129
|
-
|
|
134
|
+
Every resource decides its **read**, **form**, **summary** and **header** surfaces,
|
|
135
|
+
and its fields' chrome. Each ends as either a template with its reason, or **the
|
|
136
|
+
framework default with its reason**. Both are legitimate. A surface nobody thought
|
|
137
|
+
about is not: without a template the framework lists the schema's fields in
|
|
138
|
+
declaration order, and that order is not an argument about what a reader looks at
|
|
139
|
+
first.
|
|
140
|
+
|
|
141
|
+
State the decision in the JSDoc at the top of the file, one line per surface. With
|
|
142
|
+
no sibling to mirror, derive it from the resource: its identity, its standing (a
|
|
143
|
+
status goes beside the name), which fields are read or written at different times,
|
|
144
|
+
and which related records a reader needs here.
|
|
145
|
+
|
|
146
|
+
**The default is FEWER sections.** A named section earns its place only when its
|
|
147
|
+
fields are read at a different time, by a different reader, as a progression, or
|
|
148
|
+
opened on their own. Never group by field type ("Dates", "Metadata"), and never put
|
|
149
|
+
a heading over one or two fields. Read `references/surface-decisions.md` before
|
|
150
|
+
adding a section: it holds the tests, a chrome table, and a rejected
|
|
151
|
+
over-separated layout beside the accepted one.
|
|
152
|
+
|
|
153
|
+
Once decided, place things:
|
|
130
154
|
|
|
131
155
|
| What you need | Where it goes |
|
|
132
156
|
|---|---|
|
|
@@ -134,7 +158,7 @@ Only when the generated default cannot express what the surface needs. Classify
|
|
|
134
158
|
| Field grouping / ordering on the detail or form surface | `layout.display` / `layout.edit` |
|
|
135
159
|
| The card + FK-popover summary | `layout.summary` |
|
|
136
160
|
| WHICH related resources appear on the detail surface, in what order | `layout.display`, placing them — see Step 7b |
|
|
137
|
-
| Nothing above applies | author no template
|
|
161
|
+
| Nothing above applies | author no template, and say in the JSDoc why the default already says it |
|
|
138
162
|
|
|
139
163
|
Do NOT restate a field in two surfaces: a value shown on the header identity line
|
|
140
164
|
should leave the display strip, or the second copy reads as a different fact.
|
|
@@ -205,6 +229,99 @@ edit: { editMode: StringEditMode.MARKDOWN },
|
|
|
205
229
|
|
|
206
230
|
## Worked Example
|
|
207
231
|
|
|
232
|
+
### A surface decision, stated
|
|
233
|
+
|
|
234
|
+
This resource's read surface is a timeline and its form is an accordion. The header
|
|
235
|
+
JSDoc says why, and it says why the form has no `history` section:
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
## Usage Example
|
|
239
|
+
|
|
240
|
+
```tsx
|
|
241
|
+
/**
|
|
242
|
+
* Team Goals — resource UI behavior.
|
|
243
|
+
*
|
|
244
|
+
* A department's quarterly objective. It had no authored template, so it rendered through the
|
|
245
|
+
* generated layout; what the generated layout cannot express is that a goal is read and written at
|
|
246
|
+
* two different TIMES, by people asking two different questions.
|
|
247
|
+
*
|
|
248
|
+
* The read surface is a TIMELINE, and that is not decoration: a goal genuinely progresses — it is
|
|
249
|
+
* SET, it then has a standing (`DRAFT → ACTIVE → ACHIEVED | ABANDONED`), and it carries the dates of
|
|
250
|
+
* those transitions. Those three sections are the same fact at three points in its life, which is
|
|
251
|
+
* exactly the shape a timeline renders and a stack of headings flattens.
|
|
252
|
+
*
|
|
253
|
+
* The form is an ACCORDION for the complementary reason: the two halves are used at different times.
|
|
254
|
+
* Writing the goal happens once — a title and up to a thousand characters of description. Re-stating
|
|
255
|
+
* where it stands happens repeatedly, and an accordion lets someone reach the second without
|
|
256
|
+
* scrolling past the first every time.
|
|
257
|
+
*/
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
## Usage Example
|
|
261
|
+
|
|
262
|
+
```tsx
|
|
263
|
+
layout: {
|
|
264
|
+
refs: { sections: ['intent', 'standing', 'history'] },
|
|
265
|
+
defaultChromeMode: {
|
|
266
|
+
display: DisplayChromeMode.STACKED,
|
|
267
|
+
summary: DisplayChromeMode.INLINE,
|
|
268
|
+
edit: EditChromeMode.STACKED,
|
|
269
|
+
},
|
|
270
|
+
|
|
271
|
+
/*
|
|
272
|
+
* TIMELINE — the three sections are one goal at three points in its life, so they are
|
|
273
|
+
* rendered as a progression rather than as peers. Sections sharing a container mode are
|
|
274
|
+
* grouped at the first occurrence, which is why all three carry it.
|
|
275
|
+
*/
|
|
276
|
+
display: () => (
|
|
277
|
+
<DisplayLayout>
|
|
278
|
+
<Section name="intent" appearance={SectionMode.TIMELINE}>
|
|
279
|
+
<DisplayField name="title" />
|
|
280
|
+
<DisplayField name="description" />
|
|
281
|
+
<DisplayField name="organizationUnitId" />
|
|
282
|
+
</Section>
|
|
283
|
+
<Section name="standing" appearance={SectionMode.TIMELINE}>
|
|
284
|
+
<DisplayField name="status" />
|
|
285
|
+
<DisplayField name="supportingDocuments" />
|
|
286
|
+
</Section>
|
|
287
|
+
<Section name="history" appearance={SectionMode.TIMELINE}>
|
|
288
|
+
<DisplayField name="createdAt" />
|
|
289
|
+
<DisplayField name="updatedAt" />
|
|
290
|
+
</Section>
|
|
291
|
+
</DisplayLayout>
|
|
292
|
+
),
|
|
293
|
+
|
|
294
|
+
/*
|
|
295
|
+
* ACCORDION — independently collapsible, because the goal's prose is written once and its
|
|
296
|
+
* standing is revisited every week. `history` is absent here: both dates are
|
|
297
|
+
* `excludeFromCreate`/`excludeFromUpdate`, so a form section for them would be a heading
|
|
298
|
+
* over nothing.
|
|
299
|
+
*/
|
|
300
|
+
edit: () => (
|
|
301
|
+
<FormLayout>
|
|
302
|
+
<Section name="intent" appearance={SectionMode.ACCORDION}>
|
|
303
|
+
<FormField name="title" />
|
|
304
|
+
<FormField name="description" />
|
|
305
|
+
</Section>
|
|
306
|
+
<Section name="standing" appearance={SectionMode.ACCORDION}>
|
|
307
|
+
<FormField name="organizationUnitId" />
|
|
308
|
+
<FormField name="status" />
|
|
309
|
+
<FormField name="supportingDocuments" />
|
|
310
|
+
</Section>
|
|
311
|
+
</FormLayout>
|
|
312
|
+
),
|
|
313
|
+
```
|
|
314
|
+
|
|
315
|
+
- Every section passes a test from `references/surface-decisions.md`: the read
|
|
316
|
+
sections are one goal at three points in its life, and the form sections are
|
|
317
|
+
written at two different times (once, then weekly).
|
|
318
|
+
- The reasoning sits where the next editor reads it first. A section added later
|
|
319
|
+
without such a reason stands out against it.
|
|
320
|
+
- `refs.sections` lists exactly the names the templates use. Each one also owes a
|
|
321
|
+
specification slot.
|
|
322
|
+
|
|
323
|
+
### An enum badge
|
|
324
|
+
|
|
208
325
|
The `priority` enum on an application's `todos` resource shows the
|
|
209
326
|
canonical enum-with-badge pattern: explicit `displayMode`, paired
|
|
210
327
|
`edit` config, one `BadgeSemanticVariant.*` per value (no hex codes,
|
|
@@ -262,14 +379,32 @@ while leaving the core operations to inherit framework defaults:
|
|
|
262
379
|
// or it renders the placeholder "missing icon". Pair related actions with
|
|
263
380
|
// mirrored icons (assign/unassign, recurring/one-time).
|
|
264
381
|
views: [
|
|
265
|
-
// Create is an OVERLAY
|
|
266
|
-
//
|
|
267
|
-
//
|
|
268
|
-
//
|
|
382
|
+
// Create is an OVERLAY: the "new" affordance opens a modal and the URL stays on the
|
|
383
|
+
// collection. A PRODUCT choice — a todo is captured in a second, from the list you are already
|
|
384
|
+
// looking at, and sending that through a page navigation and back costs more than it gives.
|
|
385
|
+
//
|
|
386
|
+
// It is NOT a routing necessity, and the reason recorded here until 2026-09-18 said otherwise:
|
|
387
|
+
// that "core CREATE adds no URL segment, so an addressable create would resolve to the bare
|
|
388
|
+
// collection path and collide with LIST". That is true of the BACKEND, which differentiates
|
|
389
|
+
// LIST from CREATE by HTTP method — and false of the frontend, which has appended an explicit
|
|
390
|
+
// `create` segment for exactly this reason since `2d9d7f28`, the very commit this comment was
|
|
391
|
+
// written in. The application's other addressable creates prove it: `team-goals/create`,
|
|
392
|
+
// `knowledge-documents/create` and `organization-escalation-policies/create` all resolve, and
|
|
393
|
+
// none of them shadows its listing.
|
|
394
|
+
//
|
|
395
|
+
// The consequence of the choice is worth keeping in view: no `/todos/create` route exists, so
|
|
396
|
+
// that URL falls to the sibling `/todos/:todoId` and is caught by `AppRouter`'s
|
|
397
|
+
// reserved-operation-keyword guard, which exists because that capture once render-looped and
|
|
398
|
+
// froze the tab (2026-06-27). Typing it and getting "not a resource id" is the guard working.
|
|
269
399
|
[Op.CREATE, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
|
|
270
400
|
[Op.READ, {
|
|
271
401
|
surface: ResourceOperationFrontendSurface.ADDRESSABLE,
|
|
272
402
|
customView: TodoReadCustomView,
|
|
403
|
+
// Opening a todo from the collection SPLITS: the list stays beside it, so
|
|
404
|
+
// "which one was I comparing this against" survives the click. A todo list is
|
|
405
|
+
// read by scanning and then drilling, repeatedly — the one navigation shape
|
|
406
|
+
// where replacing the collection costs the reader their place every time.
|
|
407
|
+
navigationOverrides: [{ transition: NavigationTransition.SPLIT }],
|
|
273
408
|
}],
|
|
274
409
|
[Op.LIST, {
|
|
275
410
|
surface: ResourceOperationFrontendSurface.ADDRESSABLE,
|
|
@@ -280,16 +415,82 @@ while leaving the core operations to inherit framework defaults:
|
|
|
280
415
|
collectionDisplayConfig: {
|
|
281
416
|
selectable: true,
|
|
282
417
|
cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END },
|
|
418
|
+
// Status is the axis a todo list is READ along — "what is still open?" is
|
|
419
|
+
// the first question. `quickFilterField` promotes it to a tab strip above
|
|
420
|
+
// the toolbar writing the same server-side filter the panel would.
|
|
421
|
+
quickFilterField: 'status',
|
|
422
|
+
/*
|
|
423
|
+
* PRESET PILLS — the additive sibling of the exclusive status tabs above them.
|
|
424
|
+
*
|
|
425
|
+
* Both surfaces write the same server-side filter state, and the split is what each one
|
|
426
|
+
* MEANS: the tabs answer "which slice of this list am I in" and are mutually exclusive;
|
|
427
|
+
* these answer "and narrow it to…", cross fields, and can be on together. Urgency and
|
|
428
|
+
* recency are the two questions a todo list gets asked that its status tabs cannot.
|
|
429
|
+
*
|
|
430
|
+
* `created-today` is declared as a RELATIVE window rather than a pair of dates, because
|
|
431
|
+
* a preset is authored once and clicked forever — an authored pair would be wrong by
|
|
432
|
+
* tomorrow. It resolves against the viewer's own clock at the moment the pill is
|
|
433
|
+
* pressed, and goes off by itself when the day rolls over.
|
|
434
|
+
*/
|
|
435
|
+
presetFilters: [
|
|
436
|
+
{ ref: 'urgent', filters: { priority: Todos_Priority.URGENT } },
|
|
437
|
+
{ ref: 'created-today', filters: { createdAt: { relativeRange: CollectionFilterPresetRelativeRange.TODAY } } },
|
|
438
|
+
{ ref: 'touched-this-week', filters: { updatedAt: { relativeRange: CollectionFilterPresetRelativeRange.LAST_7_DAYS } } },
|
|
439
|
+
],
|
|
283
440
|
},
|
|
284
441
|
}],
|
|
285
442
|
[Op.SEARCH, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
|
|
286
443
|
[Op.UPDATE, { surface: ResourceOperationFrontendSurface.ADDRESSABLE }],
|
|
287
|
-
[Op.DELETE, { surface: ResourceOperationFrontendSurface.EMBEDDED }],
|
|
288
|
-
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
292
|
-
|
|
444
|
+
[Op.DELETE, { surface: ResourceOperationFrontendSurface.EMBEDDED, hasDescription: true }],
|
|
445
|
+
// INLINE: the row itself becomes the form, neighbours still visible. Chosen because status is
|
|
446
|
+
// exactly the axis a person COMPARES across rows — an overlay would cover the very todos that
|
|
447
|
+
// made them act on this one, which is the contract INLINE states. Single scalar enum field, so
|
|
448
|
+
// the row has room for it. On a todo DETAIL page there is no collection above the action and no
|
|
449
|
+
// row to transform, so it degrades to an overlay by design (`resolveActionPresentationTransition`).
|
|
450
|
+
[Todos_Operations.CHANGE_STATUS, {
|
|
451
|
+
surface: ResourceOperationFrontendSurface.EMBEDDED,
|
|
452
|
+
iconOverride: CircleDot,
|
|
453
|
+
actionPresentation: ResourceOperationActionPresentation.INLINE,
|
|
454
|
+
// Explicit ORDER in the bar. Status is the verb reached for most often on a
|
|
455
|
+
// todo, so it leads; assignment follows. Without this the bar orders by
|
|
456
|
+
// registration, which is an artefact of how the config file was written
|
|
457
|
+
// rather than of how the actions are used — and `actionDisclosure` caps the
|
|
458
|
+
// summary bar at three, so ordering decides WHICH three survive.
|
|
459
|
+
displayPriority: 10,
|
|
460
|
+
// Changing status is what a person came to the todo to DO. Every other verb
|
|
461
|
+
// on the bar is incidental to that, so it carries the accent rather than
|
|
462
|
+
// sitting visually level with "unassign".
|
|
463
|
+
actionVariant: ButtonVariants_Variant.ACCENT,
|
|
464
|
+
}],
|
|
465
|
+
// POPOVER: a small panel anchored to the button. This is the enum's own worked idiom —
|
|
466
|
+
// "assign to…" — and the operation fits it exactly: ONE field (`assignedToUserId`) and a SINGLE
|
|
467
|
+
// variant, so the bar can always anchor it. Multi-variant would render a subgroup, which cannot
|
|
468
|
+
// anchor a panel. Where the bar collapses it into the `…` overflow it degrades to an overlay.
|
|
469
|
+
[Todos_Operations.ASSIGN, {
|
|
470
|
+
surface: ResourceOperationFrontendSurface.EMBEDDED,
|
|
471
|
+
iconOverride: UserPlus,
|
|
472
|
+
actionPresentation: ResourceOperationActionPresentation.POPOVER,
|
|
473
|
+
displayPriority: 20,
|
|
474
|
+
}],
|
|
475
|
+
// These three pair off with ASSIGN and with each other: exactly one of
|
|
476
|
+
// ASSIGN/UNASSIGN applies to a todo, and exactly one of
|
|
477
|
+
// SET_AS_RECURRING/SET_AS_ONE_TIME. `WHEN_AVAILABLE` drops the inapplicable
|
|
478
|
+
// one rather than greying it, so the bar offers the verb that can run.
|
|
479
|
+
[Todos_Operations.UNASSIGN, {
|
|
480
|
+
surface: ResourceOperationFrontendSurface.EMBEDDED,
|
|
481
|
+
iconOverride: UserMinus,
|
|
482
|
+
actionVisibility: ActionVisibility.WHEN_AVAILABLE,
|
|
483
|
+
}],
|
|
484
|
+
[Todos_Operations.SET_AS_RECURRING, {
|
|
485
|
+
surface: ResourceOperationFrontendSurface.EMBEDDED,
|
|
486
|
+
iconOverride: Repeat,
|
|
487
|
+
actionVisibility: ActionVisibility.WHEN_AVAILABLE,
|
|
488
|
+
}],
|
|
489
|
+
[Todos_Operations.SET_AS_ONE_TIME, {
|
|
490
|
+
surface: ResourceOperationFrontendSurface.EMBEDDED,
|
|
491
|
+
iconOverride: Repeat1,
|
|
492
|
+
actionVisibility: ActionVisibility.WHEN_AVAILABLE,
|
|
493
|
+
}],
|
|
293
494
|
],
|
|
294
495
|
```
|
|
295
496
|
|
|
@@ -310,11 +511,14 @@ while leaving the core operations to inherit framework defaults:
|
|
|
310
511
|
- `references/framework-primitive-ui-api.md` — source-backed primitive UI base
|
|
311
512
|
- `references/framework-per-primitive-ui-api.md` — source-backed per-type UI
|
|
312
513
|
- `references/framework-foreign-key-ui-api.md` — source-backed FK reference display & picker row modes (`LABEL` / `SUMMARY`)
|
|
514
|
+
- `references/surface-decisions.md` — deciding each surface without a sibling to mirror, when a section earns its place, the chrome decision table, and a rejected over-separated layout beside the accepted one
|
|
313
515
|
- `references/framework-resource-layout-templates-api.md` — source-backed `layout.{edit,display,summary,header}`, the `layout.refs` manifest, and `<ResourceHeaderTitle />`
|
|
314
516
|
- `references/framework-related-resource-embeds-api.md` — source-backed `RelatedResourceSections`, the `EmbedRelated*` family, `viaForeignKey` edge disambiguation, preview, and descent bounding
|
|
315
517
|
|
|
316
518
|
## Verification
|
|
317
519
|
|
|
520
|
+
- [ ] The file opens with a JSDoc stating the decision for each surface (read, form, summary, header): the template's reason, or why the default is right
|
|
521
|
+
- [ ] Every named `<Section>` passes a test in `references/surface-decisions.md` (different time, different reader, a progression, or independent use), and none groups fields by type
|
|
318
522
|
- [ ] No structural decorators added; the schema file is unchanged unless the change was coordinated through `resource-schema-authoring`
|
|
319
523
|
- [ ] Every enum field has explicit `display.displayMode` AND a `values: { ... }` map (no silent default rendering)
|
|
320
524
|
- [ ] Per-value enum chrome uses framework enums (`BadgeSemanticVariant`, etc.) — no hex codes or Tailwind classes
|
|
@@ -339,6 +543,14 @@ Run from the app root and substitute the resource path:
|
|
|
339
543
|
| Every UI field exists in the schema | `comm -23 <(rg -oN "^\s*(\w+):\s*sh\." frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx \| sed -E 's/^\s*([^:]+):.*/\1/' \| sort -u) <(rg -oN "^\s*(\w+):\s*z\." shared-lib/src/modules/*/resources/<resource>/<resource>.schemas.ts \| sed -E 's/^\s*([^:]+):.*/\1/' \| sort -u)` |
|
|
340
544
|
| No `isForeignKey` / `isDBIndexed` / `excludeFrom*` accidentally added here | `rg -n "isForeignKey\|isDBIndexed\|excludeFrom" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
341
545
|
|
|
546
|
+
Surface-decision invariants:
|
|
547
|
+
|
|
548
|
+
| Invariant | Command |
|
|
549
|
+
|---|---|
|
|
550
|
+
| The file opens with a decision JSDoc (first line is `/**`) | `head -1 frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
551
|
+
| Named sections, to check each against the tests (list them; each needs a stated reason) | `rg -n "<Section[^>]*name=" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
552
|
+
| No section named after a field type (should be empty) | `rg -n "<Section[^>]*name=\"(dates\|metadata\|details\|info\|other)\"" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx` |
|
|
553
|
+
|
|
342
554
|
Related-resource placement invariants:
|
|
343
555
|
|
|
344
556
|
| Invariant | Command |
|
|
@@ -355,6 +567,9 @@ Icon invariants (same resource-path substitution):
|
|
|
355
567
|
|
|
356
568
|
| Rationalization | Reality |
|
|
357
569
|
|--------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
570
|
+
| "The generated default expresses everything; no template needed" | Maybe, but only if you can say why. A default nobody decided is the order the schema was typed in. State it in the JSDoc, or author the template. |
|
|
571
|
+
| "More sections make it more organized" | A heading over one or two fields is a box, not structure. The default is fewer sections; each one must pass a test and costs three places. |
|
|
572
|
+
| "I'll mirror the sibling resource's layout" | The first resource of a new application has no sibling. Derive the surface from this resource's identity, standing and timing. |
|
|
358
573
|
| "Default enum rendering is fine" | The framework requires explicit UI choices for enums in Wildo apps; an unconfigured enum is a UX defect, not a graceful fallback. |
|
|
359
574
|
| "I'll just use a hex code / Tailwind class for this badge color" | Per-value chrome must come from `BadgeSemanticVariant` (or the matching framework enum); raw colors break theming and dark mode. |
|
|
360
575
|
| "I'll copy the layout from another module without checking operations" | Operation ids referenced under `views: [...]` must exist in **this** resource's `*.resources-config.ts`; copy-paste silently breaks routing. |
|
|
@@ -365,6 +580,8 @@ Icon invariants (same resource-path substitution):
|
|
|
365
580
|
|
|
366
581
|
## Red Flags
|
|
367
582
|
|
|
583
|
+
- The file has no decision JSDoc at the top, so its surfaces are defaults nobody chose (catch with the "decision JSDoc" check above)
|
|
584
|
+
- A section is named after a field type, or holds one or two fields with no stated reason (catch with the "section named after a field type" grep above)
|
|
368
585
|
- UI references a field absent from the schema (catch with the "every UI field exists in schema" grep above)
|
|
369
586
|
- An enum field has no explicit `displayMode` or no `values: { ... }` map (silent default rendering)
|
|
370
587
|
- Per-value chrome uses a hex code or `className: 'bg-...'` instead of `BadgeSemanticVariant.*` (catch with the "no raw color strings" / "no Tailwind class smuggling" greps)
|
|
@@ -387,3 +604,4 @@ Icon invariants (same resource-path substitution):
|
|
|
387
604
|
- `spec-update-after-change` — companion-facing semantics
|
|
388
605
|
- `i18n-rerun-pipeline` — translation and label workflow
|
|
389
606
|
- `views-add-custom-view` — when default view chrome is not enough
|
|
607
|
+
- `frontend-component-catalog` — which framework component renders what, and its props, when a surface needs an element beyond the field chrome
|