@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
|
@@ -26,6 +26,20 @@ export enum ApplicationLevelComponentType {
|
|
|
26
26
|
COMMAND_MENU = 'command_menu',
|
|
27
27
|
QUICK_ACTION_BUTTON = 'quick_action_button',
|
|
28
28
|
QUICK_SWITCHER = 'quick_switcher',
|
|
29
|
+
/**
|
|
30
|
+
* Settings/actions rail.
|
|
31
|
+
*
|
|
32
|
+
* **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**
|
|
33
|
+
* Decided 2026-09-09: not withdrawn, because it is an implemented, working preset and deleting a
|
|
34
|
+
* shell surface because no dogfood happens to use one yet is the weakest possible evidence; and
|
|
35
|
+
* not switched on, because doing so would mean inventing product concepts for a dogfood
|
|
36
|
+
* application in order to justify a surface.
|
|
37
|
+
*
|
|
38
|
+
* **It is switched on by the first application whose settings and actions genuinely want a
|
|
39
|
+
* persistent rail rather than the settings hub overlay.** Your Application does not — its settings
|
|
40
|
+
* reach is served by the hub — so enabling it there would demonstrate an empty rail, not the
|
|
41
|
+
* surface.
|
|
42
|
+
*/
|
|
29
43
|
CONTROL_PANEL = 'control_panel',
|
|
30
44
|
|
|
31
45
|
STATUS_BAR = 'status_bar',
|
|
@@ -35,18 +49,40 @@ export enum ApplicationLevelComponentType {
|
|
|
35
49
|
* renders the same preset. Exists to allow separate config entries while reusing
|
|
36
50
|
* the user dropdown component. For distinct UX, register a dedicated preset.
|
|
37
51
|
*/
|
|
38
|
-
SETTINGS_DROPDOWN = 'settings_dropdown',
|
|
39
52
|
NAVIGATION_CONTROL = 'navigation_control',
|
|
40
|
-
/**
|
|
53
|
+
/**
|
|
54
|
+
* Mode selector — renders available `AppMode`s as selectable icons.
|
|
55
|
+
*
|
|
56
|
+
* **Off in both dogfood applications, and that is an ANSWER rather than an omission (#504).**
|
|
57
|
+
* Decided 2026-09-09, on the same reasoning as `CONTROL_PANEL`: neither withdrawn nor switched on.
|
|
58
|
+
*
|
|
59
|
+
* **Its condition is mechanical and checkable: it is switched on by the first application that
|
|
60
|
+
* declares more than one `AppMode`.** Your Application declares none, so the bar it would render is
|
|
61
|
+
* empty — enabling it there would demonstrate the gap rather than the surface, which is exactly
|
|
62
|
+
* what "switched on with something real in it" is meant to prevent.
|
|
63
|
+
*/
|
|
41
64
|
ACTIVITY_BAR = 'activity_bar',
|
|
42
65
|
/**
|
|
43
|
-
* Gmail-style right-side utility panel —
|
|
44
|
-
*
|
|
45
|
-
*
|
|
66
|
+
* Gmail-style right-side utility panel — renders configured components inside a collapsible
|
|
67
|
+
* side sheet.
|
|
68
|
+
*
|
|
69
|
+
* **Status, corrected 2026-09-09 (#504).** The panel renders its `items` INLINE and does not
|
|
70
|
+
* navigate at all: `useUtilityPanelBehavior` resolves an open/close state and a component list,
|
|
71
|
+
* and the preset renders each `componentRef` through the component registry. Nothing in the panel
|
|
72
|
+
* calls a navigation API.
|
|
73
|
+
*
|
|
74
|
+
* The previous wording said in-panel navigation "still needs its own dedicated navigation zone
|
|
75
|
+
* instead of reusing main navigation", which reads as a description of what the panel does today
|
|
76
|
+
* and is not one — there is no in-panel navigation, so nothing is reusing anything. Acting on it
|
|
77
|
+
* would mean adding a member to the closed `NavigationZoneName` vocabulary that no producer emits
|
|
78
|
+
* and no consumer reads: the declared-with-no-reader shape, created while removing it.
|
|
46
79
|
*
|
|
47
|
-
*
|
|
48
|
-
* side sheet
|
|
49
|
-
*
|
|
80
|
+
* A dedicated zone becomes real work the moment a panel item NAVIGATES. Then it is genuinely
|
|
81
|
+
* needed, because a push from inside a side sheet would otherwise land in `PRIMARY` and replace
|
|
82
|
+
* the workspace the panel is meant to sit beside. Design it then, against the zone vocabulary as
|
|
83
|
+
* it now stands (`maxDepth`, `responsiveCollapse`, `TABBED` all became live with #411) — and note
|
|
84
|
+
* `COMPANION` already describes "persistent supplementary content … a Slack thread panel", so the
|
|
85
|
+
* first question is whether the panel's zone IS `COMPANION` rather than a fourth member.
|
|
50
86
|
*/
|
|
51
87
|
UTILITY_PANEL = 'utility_panel',
|
|
52
88
|
}
|
|
@@ -175,6 +211,16 @@ export const AppLevelComponentConfigurationSchema = z.object({
|
|
|
175
211
|
displayPolicy: z.union([z.literal("FIXED"), z.literal("OVERLAY")]).default("FIXED"),
|
|
176
212
|
hostedComponents: z.array(MenubarHostedComponentSchema).optional(),
|
|
177
213
|
items: z.array(MenubarLauncherItemSchema).optional(),
|
|
214
|
+
/**
|
|
215
|
+
* Render the application's identity — its mark and name — at the START of the bar as the
|
|
216
|
+
* HOME affordance, the horizontal counterpart of the sidebar's `BRAND_HEADER`. Opt-in, and
|
|
217
|
+
* off by default: a shell that also has a sidebar with a brand header would otherwise show
|
|
218
|
+
* the identity twice. A menubar-ONLY shell (no sidebar) is what needs it — without it the
|
|
219
|
+
* identity is nowhere on screen and there is no home affordance at all (#1454).
|
|
220
|
+
*/
|
|
221
|
+
brandHeader: z.boolean().optional(),
|
|
222
|
+
/** The mark variant the brand header renders; same vocabulary and same default (adaptive) as the sidebar's. */
|
|
223
|
+
brandMarkTheme: z.enum(BrandAssetTheme).optional(),
|
|
178
224
|
}),
|
|
179
225
|
]).default(true),
|
|
180
226
|
|
|
@@ -224,10 +270,34 @@ export const AppLevelComponentConfigurationSchema = z.object({
|
|
|
224
270
|
z.object({
|
|
225
271
|
placement: z.union([ z.literal(HorizontalPlacement.START), z.literal(HorizontalPlacement.END)]),
|
|
226
272
|
collapsible: z.boolean().default(true),
|
|
273
|
+
/**
|
|
274
|
+
* Does the sidebar start COLLAPSED (the icon rail) rather than expanded?
|
|
275
|
+
*
|
|
276
|
+
* This is the application's STARTING POSITION, not a lock: the rail
|
|
277
|
+
* collapse is a per-machine user preference persisted under
|
|
278
|
+
* `LOCAL_STORAGE_KEYS.SIDEBAR_COLLAPSED`, and a stored preference always
|
|
279
|
+
* wins. So this answers "what does a visitor with no preference yet
|
|
280
|
+
* see", which nothing could express before — the hydration fell back to
|
|
281
|
+
* `false`, making EXPANDED the only reachable default for every
|
|
282
|
+
* application.
|
|
283
|
+
*
|
|
284
|
+
* Pairs with the theme's `SidebarCompactLabelMode`: `ICON_AND_LABEL`
|
|
285
|
+
* renders a wrapping label under each icon in the collapsed rail, so a
|
|
286
|
+
* rail-first shell stays readable rather than becoming a column of
|
|
287
|
+
* unlabelled glyphs.
|
|
288
|
+
*
|
|
289
|
+
* OPTIONAL rather than `.default(false)` for the reason `homeDisplayMode`
|
|
290
|
+
* gives one line below: a Zod default makes the key REQUIRED in the
|
|
291
|
+
* inferred authoring type, forcing every preset and application config to
|
|
292
|
+
* restate an opinion it does not have. The framework default (expanded —
|
|
293
|
+
* the behavior every app had before this axis existed) is applied in
|
|
294
|
+
* `useSidebarBehavior`, which must resolve it there regardless because a
|
|
295
|
+
* sidebar authored as plain `true` never reaches this object branch.
|
|
296
|
+
*/
|
|
297
|
+
defaultCollapsed: z.boolean().optional(),
|
|
227
298
|
responsiveBreakpoint: z.enum(ViewportBreakpoint).default(ViewportBreakpoint.MOBILE),
|
|
228
299
|
responsivePolicy: z.enum(SidebarResponsivePolicy).default(SidebarResponsivePolicy.BURGER),
|
|
229
300
|
defaultSection: z.string().default("main"),
|
|
230
|
-
showUncategorized: z.boolean().default(true),
|
|
231
301
|
/**
|
|
232
302
|
* How the sidebar surfaces HOME — hidden, the pinned brand header
|
|
233
303
|
* (app symbol + name above the search trigger), or a "Home" navigation
|
|
@@ -373,16 +443,12 @@ export const AppLevelComponentConfigurationSchema = z.object({
|
|
|
373
443
|
sections: z.array(z.enum(UserDropdownSection)).optional(),
|
|
374
444
|
showOrgSwitcher: z.boolean().default(true),
|
|
375
445
|
showLogout: z.boolean().default(true),
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
[ApplicationLevelComponentType.SETTINGS_DROPDOWN]: z.union([
|
|
383
|
-
z.boolean().default(true),
|
|
384
|
-
z.object({
|
|
385
|
-
mergedWith: z.literal(ApplicationLevelComponentType.USER_DROPDOWN),
|
|
446
|
+
/**
|
|
447
|
+
* Settings-hub section refs surfaced inline in the dropdown, in order.
|
|
448
|
+
* Empty or omitted renders the single "Settings" button. Names the
|
|
449
|
+
* SETTINGS vocabulary directly — never a sidebar section ref.
|
|
450
|
+
*/
|
|
451
|
+
settingsEntries: z.array(z.string()).optional(),
|
|
386
452
|
}),
|
|
387
453
|
]).default(true),
|
|
388
454
|
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
# Framework Brand Identity API
|
|
2
|
+
|
|
3
|
+
`useBrandIdentity()` — how a shell surface renders the application's brand.
|
|
4
|
+
|
|
5
|
+
Read it when placing a logo or mark anywhere in the shell, and before writing any theme-aware asset
|
|
6
|
+
selection of your own.
|
|
7
|
+
|
|
8
|
+
## It already decides the mark variant
|
|
9
|
+
|
|
10
|
+
The variant follows the active UI theme: dark UI asks for the dark mark, light UI for the light one,
|
|
11
|
+
each falling back through the default. An application that generated only a default-theme mark still
|
|
12
|
+
gets it in dark mode rather than nothing.
|
|
13
|
+
|
|
14
|
+
Pin `options.theme` only when a surface genuinely needs a fixed variant — a monochrome mark, or a
|
|
15
|
+
colour mark deliberately kept on a dark shell. Re-deriving this per surface is the duplication the
|
|
16
|
+
hook exists to remove.
|
|
17
|
+
|
|
18
|
+
## ⚠️ Whose brand is this?
|
|
19
|
+
|
|
20
|
+
A frontend that observes an application rather than BEING one — a creation tool, a back office —
|
|
21
|
+
declares `shellIdentity` in its frontend configuration, and **that identity wins** over the
|
|
22
|
+
application config it reads.
|
|
23
|
+
|
|
24
|
+
Without that precedence the tool renders its customer's brand as its own, because there is exactly one
|
|
25
|
+
application-config endpoint and it belongs to the application. If you are building a surface that
|
|
26
|
+
talks to an application it does not represent, declare `shellIdentity`.
|
|
27
|
+
|
|
28
|
+
## Where it may be called
|
|
29
|
+
|
|
30
|
+
Inside `ApplicationMainProvider` (it reads the application config) and inside `UIProvider` (it reads
|
|
31
|
+
the resolved dark-mode state). Outside either, it has nothing to resolve from.
|
|
32
|
+
|
|
33
|
+
## Brand Identity
|
|
34
|
+
|
|
35
|
+
## Import Origins
|
|
36
|
+
|
|
37
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
38
|
+
|
|
39
|
+
## Source Excerpts
|
|
40
|
+
|
|
41
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
42
|
+
|
|
43
|
+
```typescript
|
|
44
|
+
*
|
|
45
|
+
* Reads the application's brand identity for a shell surface.
|
|
46
|
+
*
|
|
47
|
+
* Owns ONE decision every brand-rendering surface would otherwise re-derive:
|
|
48
|
+
* how the active UI theme maps onto {@link BrandAssetTheme} (dark UI → `DARK`,
|
|
49
|
+
* light UI → `LIGHT`), unless the caller PINS a variant via `options.theme`.
|
|
50
|
+
* `resolveBrandAsset` then applies the framework's documented fallback chain, so
|
|
51
|
+
* an app that generated only a default-theme mark still gets it in dark mode
|
|
52
|
+
* instead of nothing.
|
|
53
|
+
*
|
|
54
|
+
* Must be used inside `ApplicationMainProvider` (it reads the application
|
|
55
|
+
* config) and inside `UIProvider` (it reads the resolved dark-mode state).
|
|
56
|
+
*
|
|
57
|
+
* ## Two things a caller does not have to solve
|
|
58
|
+
*
|
|
59
|
+
* The MARK VARIANT follows the active UI theme by default — dark UI asks for the dark mark, light UI
|
|
60
|
+
* for the light one, each falling back through the default. So an application that generated only a
|
|
61
|
+
* default-theme mark still gets it in dark mode rather than nothing. Pin `options.theme` only when a
|
|
62
|
+
* surface genuinely needs a fixed variant, such as a monochrome mark.
|
|
63
|
+
*
|
|
64
|
+
* WHOSE identity is rendered is decided here too, and it matters for any frontend that observes an
|
|
65
|
+
* application rather than being one — a creation tool, a back office. Such a frontend declares
|
|
66
|
+
* `shellIdentity` in its frontend configuration, and that identity WINS over the application config
|
|
67
|
+
* it reads. Without that precedence the tool renders its customer's brand as its own, because there
|
|
68
|
+
* is exactly one application-config endpoint and it belongs to the application.
|
|
69
|
+
*
|
|
70
|
+
```
|
package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md
ADDED
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
# Public-page identity — naming the application on sign-in (source)
|
|
2
|
+
|
|
3
|
+
Read this when the application should say **whose** login screen it is: a mark
|
|
4
|
+
and/or the application name on the sign-in card. You are setting one field,
|
|
5
|
+
`publicShellIdentityMode`, and passing it to `buildFrontendModuleConfigOverrides`
|
|
6
|
+
in `frontend/src/modules-registry.frontend.ts`.
|
|
7
|
+
|
|
8
|
+
## It is not an app-shell component key
|
|
9
|
+
|
|
10
|
+
Every other surface in this skill is keyed by `ApplicationLevelComponentType`
|
|
11
|
+
in `frontend/src/config/app-shell.config.ts`. This one is not, and reasoning by
|
|
12
|
+
analogy costs you a silent no-op: adding `publicShellIdentityMode` to
|
|
13
|
+
`appShellConfig` configures **nothing**, with no error.
|
|
14
|
+
|
|
15
|
+
The reason is that the two describe different runtimes. Those keys govern the
|
|
16
|
+
AUTHENTICATED shell — menubar, sidebar, status bar — and none of it exists yet
|
|
17
|
+
on a public page. So the field sits beside `navigationLayout`, `homeDefinition`
|
|
18
|
+
and `errorPageConfig`, which are the other whole-frontend decisions.
|
|
19
|
+
|
|
20
|
+
## It covers every public card, not only login
|
|
21
|
+
|
|
22
|
+
One container renders them all, so the choice is made once and applies to
|
|
23
|
+
sign-in, registration, invitation acceptance, e-mail confirmation, password
|
|
24
|
+
reset, the MFA challenge, magic-link verification, enrollment, and the OAuth
|
|
25
|
+
consent / logged-out / logout-confirm screens.
|
|
26
|
+
|
|
27
|
+
That is deliberate rather than convenient: a brand on the login page and none
|
|
28
|
+
on the MFA challenge reads as two different products mid-authentication, which
|
|
29
|
+
is exactly when a person is deciding whether to trust the page.
|
|
30
|
+
|
|
31
|
+
## The mode is a PERMISSION, never a promise that a logo exists
|
|
32
|
+
|
|
33
|
+
This is the part authors get wrong, because the field name sounds like it
|
|
34
|
+
renders something. What renders is decided from the brand DATA:
|
|
35
|
+
|
|
36
|
+
| What the application has | What the card shows |
|
|
37
|
+
|---|---|
|
|
38
|
+
| A `SYMBOL` mark and a name | the mark, with the name beneath it |
|
|
39
|
+
| A `WORDMARK` or `LOCKUP` mark | the **mark alone** — such a mark already contains the name, and printing the name beneath would show it twice |
|
|
40
|
+
| No generated brand yet | the **name alone** |
|
|
41
|
+
| A mark whose file cannot be loaded | the **name alone** — never a broken image |
|
|
42
|
+
| Neither a mark nor a name | nothing at all |
|
|
43
|
+
|
|
44
|
+
So turning this on is safe before a brand exists, and it does not need to be
|
|
45
|
+
revisited after one is generated — the same setting starts showing the mark on
|
|
46
|
+
its own.
|
|
47
|
+
|
|
48
|
+
## Which identity it shows
|
|
49
|
+
|
|
50
|
+
The application's own: `appIdentity.displayName`, falling back to the technical
|
|
51
|
+
`appName`, plus the `brandAssets` the brand generation produced. Author the mark
|
|
52
|
+
through the brand brief (`brand-logo-authoring`) — there is nothing to configure
|
|
53
|
+
here to point at an asset, and no URL to paste.
|
|
54
|
+
|
|
55
|
+
## Default, and when to turn it on
|
|
56
|
+
|
|
57
|
+
`HIDDEN` is the framework default, and an application that never mentions the
|
|
58
|
+
field behaves exactly as before. Prefer leaving it off until the application has
|
|
59
|
+
a name it is willing to show a stranger: with no brand and no `displayName`, the
|
|
60
|
+
card would print the technical `appName` over the sign-in form.
|
|
61
|
+
|
|
62
|
+
## Import Origins
|
|
63
|
+
|
|
64
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
65
|
+
|
|
66
|
+
## Source Excerpts
|
|
67
|
+
|
|
68
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
69
|
+
|
|
70
|
+
```typescript
|
|
71
|
+
*
|
|
72
|
+
* Whether the PUBLIC (unauthenticated) pages present the application's identity.
|
|
73
|
+
*
|
|
74
|
+
* Declare it beside your other frontend configuration and pass it to
|
|
75
|
+
* `buildFrontendModuleConfigOverrides` in `frontend/src/modules-registry.frontend.ts`, alongside
|
|
76
|
+
* `navigationLayout`, `homeDefinition` and `errorPageConfig`:
|
|
77
|
+
*
|
|
78
|
+
* ```ts
|
|
79
|
+
* import { PublicShellIdentityMode } from '@wildo-ai/saas-frontend-lib';
|
|
80
|
+
*
|
|
81
|
+
* frontendConfigOverrides: buildFrontendModuleConfigOverrides({
|
|
82
|
+
* // …navigationLayout, designSystemConfiguration, homeDefinition, errorPageConfig
|
|
83
|
+
* publicShellIdentityMode: PublicShellIdentityMode.BRAND_HEADER,
|
|
84
|
+
* }),
|
|
85
|
+
* ```
|
|
86
|
+
*
|
|
87
|
+
* It is NOT an `ApplicationLevelComponentType` key: it does not belong in
|
|
88
|
+
* `frontend/src/config/app-shell.config.ts`, and putting it there configures nothing at all. Those
|
|
89
|
+
* keys describe the AUTHENTICATED shell (menubar, sidebar, status bar); the pages this governs
|
|
90
|
+
* render before any of that exists.
|
|
91
|
+
*
|
|
92
|
+
* Login, registration, invitation acceptance, e-mail confirmation, password reset, the MFA
|
|
93
|
+
* challenge and the OAuth consent screens are the first thing a person ever sees of an application,
|
|
94
|
+
* and they are also the pages most likely to be reached from a link — an e-mail, a chat message, a
|
|
95
|
+
* bookmark — with no surrounding context saying what they belong to. Naming the surface there is
|
|
96
|
+
* conventional (Stripe, Linear, GitHub, Slack all do it) and it is the difference between "sign in"
|
|
97
|
+
* and "sign in to WHAT".
|
|
98
|
+
*
|
|
99
|
+
* OPT-IN, and {@link HIDDEN} is the framework default, for the same reason the sidebar's home mode
|
|
100
|
+
* defaults to a navigation row rather than a brand header: showing an identity assumes the surface
|
|
101
|
+
* HAS one worth showing, and an application that has generated no brand yet would get its technical
|
|
102
|
+
* `appName` printed over its login form. An application says when it is ready.
|
|
103
|
+
*
|
|
104
|
+
* Mirrors {@link SidebarHomeDisplayMode} deliberately — same question ("how is this product's
|
|
105
|
+
* identity surfaced here"), same answer shape, so an author who has met one already knows this one.
|
|
106
|
+
*/
|
|
107
|
+
export enum PublicShellIdentityMode {
|
|
108
|
+
/**
|
|
109
|
+
* Public pages carry no identity. The framework default, and the behavior of every application
|
|
110
|
+
* that does not mention this field.
|
|
111
|
+
*/
|
|
112
|
+
HIDDEN = 'hidden',
|
|
113
|
+
/**
|
|
114
|
+
* The identity at the top of the public card, above the form's own heading: the mark when one
|
|
115
|
+
* resolves, and the name.
|
|
116
|
+
*
|
|
117
|
+
* What actually renders is decided from the DATA, not from this mode — an application with no
|
|
118
|
+
* generated brand shows its name alone, and a brand whose mark is a wordmark or lockup shows the
|
|
119
|
+
* mark alone, because such a mark already contains the name. So this mode is a permission, never
|
|
120
|
+
* a promise that a logo exists.
|
|
121
|
+
*/
|
|
122
|
+
BRAND_HEADER = 'brand_header',
|
|
123
|
+
}
|
|
124
|
+
```
|
|
@@ -36,10 +36,10 @@ new top-level keys breaks the CSS generator.
|
|
|
36
36
|
| Surface | Glob (relative to app root) |
|
|
37
37
|
|---------------------|------------------------------------------------------------------------------------------|
|
|
38
38
|
| Design system config | `frontend/src/config/design-system.config.ts` |
|
|
39
|
-
| First-paint theme behavior | `frontend/index.html
|
|
39
|
+
| First-paint theme behavior | `frontend/index.html` (head script + style layer), `frontend/src/browser-bootstrap/app-shell-bootstrap.ts` |
|
|
40
40
|
| Generated CSS | App-specific (typically `frontend/src/styles/design-tokens.css` or auto-injected) |
|
|
41
41
|
| Component theme consumption | `frontend/src/components/**/*.tsx` (via Tailwind / CSS variables) |
|
|
42
|
-
| Companion design-system snapshot | Re-extracted via `wildo
|
|
42
|
+
| Companion design-system snapshot | Re-extracted via `wildo design-tokens generate` / app's equivalent CLI |
|
|
43
43
|
|
|
44
44
|
## When to Use
|
|
45
45
|
|
|
@@ -104,6 +104,25 @@ own the palette. In `frontend/index.html`, use
|
|
|
104
104
|
for the resolved mode. Never copy `oklch`, hex, or RGB token values into HTML
|
|
105
105
|
or bootstrap TypeScript; duplicated tints drift when the design system changes.
|
|
106
106
|
|
|
107
|
+
**The resolver is the framework's, not yours.**
|
|
108
|
+
`frontend/src/browser-bootstrap/app-shell-bootstrap.ts` calls `initializeTheme()`
|
|
109
|
+
from `@wildo-ai/saas-frontend-lib/browser-bootstrap`, which reads the
|
|
110
|
+
`theme.preference` browser-storage value (`LIGHT` / `DARK` / `AUTO`, where an
|
|
111
|
+
explicit choice beats the operating system and anything else follows
|
|
112
|
+
`prefers-color-scheme`) and stamps `data-theme` plus the `dark` class on
|
|
113
|
+
`<html>`. Do not re-implement it locally and do not read that key yourself to
|
|
114
|
+
decide colors — the CSS already branches on what it stamped.
|
|
115
|
+
|
|
116
|
+
**Editing `frontend/index.html` — keep the head script where it is.** It is easy
|
|
117
|
+
to move or drop while adding a favicon, meta tags or an analytics snippet, and
|
|
118
|
+
the consequence is larger than a flicker: the mounted UI runtime that would
|
|
119
|
+
otherwise set the theme lives BELOW the application-config bootstrap, so the
|
|
120
|
+
loading screen and the initialization-error screen render above it. Without the
|
|
121
|
+
render-blocking head script those two paint LIGHT on a dark desktop — and when
|
|
122
|
+
the backend never answers, the error screen is the whole session rather than a
|
|
123
|
+
moment on the way to the app. Keep `blocking="render"` on the script tag, keep
|
|
124
|
+
it in `<head>`, and keep it ahead of the app entry script.
|
|
125
|
+
|
|
107
126
|
### Step 5: Configure material cost at the theme boundary
|
|
108
127
|
|
|
109
128
|
When a theme uses structured materials, read
|
|
@@ -125,7 +144,7 @@ z-index or mount timing as a substitute for `GlassMaterialPriority`.
|
|
|
125
144
|
### Step 6: Regenerate artifacts
|
|
126
145
|
|
|
127
146
|
Run the project's design-token generation command (typically
|
|
128
|
-
`wildo
|
|
147
|
+
`wildo design-tokens generate` or app equivalent). The CSS file
|
|
129
148
|
must be regenerated and committed; runtime reads the generated CSS,
|
|
130
149
|
not the TS config directly.
|
|
131
150
|
|
|
@@ -165,6 +184,9 @@ const designSystemConfig = defineDesignSystemConfig({
|
|
|
165
184
|
// L 0.554 → 0.46: 12px uppercase muted labels sat at the AA borderline
|
|
166
185
|
// (≈4.3:1 on `muted`); 0.46 measures ≈6.5:1. Mirrors the engine preset.
|
|
167
186
|
'muted-foreground': 'oklch(0.46 0.046 257)',
|
|
187
|
+
// (#184 settled this in the ENGINE too: every `UI_PALETTE_*` now tracks
|
|
188
|
+
// `secondary` here, so this override is a palette CHOICE tying the tint to
|
|
189
|
+
// this application's own secondary, not a workaround for a framework default.)
|
|
168
190
|
// `accent` is the INTERACTION TINT — the framework recipes paint it on
|
|
169
191
|
// hovered/selected/highlighted surfaces (list rows, dropdown options, menu
|
|
170
192
|
// items, toggles). It must stay a SUBTLE wash of the page palette, not a
|
|
@@ -321,6 +343,21 @@ What earns its place:
|
|
|
321
343
|
`muted`, `accent`, `border`, `input`, `ring`) and their `-foreground`
|
|
322
344
|
pairs. Foregrounds are required wherever a background is overridden
|
|
323
345
|
— pairs are never auto-derived.
|
|
346
|
+
- `colors` also carries two **optional, derived** levels, the only
|
|
347
|
+
tokens in the bucket that are computed when left undeclared:
|
|
348
|
+
`foreground-subtle` — the third text level, for meta copy (a time, a
|
|
349
|
+
count, "by whom") that sits below descriptions, reached with
|
|
350
|
+
`TextVariant.SUBTLE` — and `border-strong`, the second edge strength,
|
|
351
|
+
which the default theme draws on outline buttons, modal edges, text
|
|
352
|
+
inputs and checkboxes. Undeclared, each is a `color-mix()` over the
|
|
353
|
+
application's **own** `foreground`, `muted-foreground` and
|
|
354
|
+
`background`, so a rebrand retunes them with no edit. The default
|
|
355
|
+
ratios are contrast decisions: the subtle level holds 4.5:1 on the
|
|
356
|
+
page, raised, overlay and sunken surfaces, and the strong edge holds
|
|
357
|
+
3:1 against the page, because an input's border is the only thing
|
|
358
|
+
that says it is an input. Declare either one only as a concrete
|
|
359
|
+
`oklch(...)` value you have measured to the same bar; on `muted` and
|
|
360
|
+
`inset` fills use `TextVariant.MUTED`, not `SUBTLE`.
|
|
324
361
|
- `surfaces` covers structural rendering layers (`default`, `sunken`,
|
|
325
362
|
`raised`, `overlay`, `inset`) plus their `-foreground` pairs. These
|
|
326
363
|
are used by container components for layered backgrounds; they are
|
|
@@ -357,6 +394,7 @@ What is **not** in this block (and shouldn't be):
|
|
|
357
394
|
- `references/framework-material-runtime-policy-api.md` — source-backed priority and aggregate document-budget contract
|
|
358
395
|
- `references/surface-policy-authoring.md` — app-facing `surfacePolicies`, `SHELL` landmark opt-in/opt-out, active slot and selector-channel status
|
|
359
396
|
- `references/framework-surface-policy-api.md` — source-backed Surface Policy family and default contracts
|
|
397
|
+
- `references/loading-placeholder-authoring.md` — the skeleton fill a theme must not choose freely, and why a collection repeats its silhouette
|
|
360
398
|
|
|
361
399
|
## Verification
|
|
362
400
|
|
|
@@ -382,6 +420,7 @@ Run from the app root:
|
|
|
382
420
|
| Theme is declared | `rg -n "theme:\s+" frontend/src/config/design-system.config.ts` |
|
|
383
421
|
| Every background token has a foreground pair (sample) | `rg -oN "'\K[a-z-]+(?=':)" frontend/src/config/design-system.config.ts \| rg -v "foreground" \| sort -u` |
|
|
384
422
|
| **No string-literal hex / rgb in the config** (must return empty) | `rg -n "'#[0-9a-fA-F]{3,8}'" frontend/src/config/design-system.config.ts` |
|
|
423
|
+
| **The head theme bootstrap is present and render-blocking** | `rg -n 'blocking="render"' frontend/index.html` (must match; without it the loading and error screens paint light) |
|
|
385
424
|
| **No duplicated first-paint palette literals** (must return empty) | `rg -n "oklch\\(|#[0-9a-fA-F]{3,8}|rgba?\\(" frontend/index.html frontend/src/browser-bootstrap` |
|
|
386
425
|
| Generated CSS exists | `ls -1 frontend/src/styles/design-tokens.css 2>/dev/null \|\| ls -1 frontend/dist/design-tokens.css 2>/dev/null` |
|
|
387
426
|
| Material profiles and aggregate policy stay theme-owned | `rg -n "materials:|materialRuntimePolicy:|priority:" frontend/src/config/design-system.config.ts` |
|
|
@@ -412,6 +451,7 @@ the file and silently loses tokens added in upgrades.
|
|
|
412
451
|
- Missing `...DEFAULT_DESIGN_SYSTEM_SOURCE_CONFIG.<bucket>.<mode>` spread (catch with the **Default config is spread at each nested layer** grep — must match every nested `light` / `dark` block).
|
|
413
452
|
- Hex / RGB color literal where `oklch` is expected (catch with the **No string-literal hex / rgb** grep — must return empty).
|
|
414
453
|
- Concrete palette literals in `frontend/index.html` or the head bootstrap (catch with the **No duplicated first-paint palette literals** grep — must return empty).
|
|
454
|
+
- The head theme bootstrap moved out of `<head>`, stripped of `blocking="render"`, or removed while editing `frontend/index.html` (catch with the **head theme bootstrap is present and render-blocking** grep — must match).
|
|
415
455
|
- New top-level key (`brand`, `extras`, etc.) outside the schema (catch by typecheck — `defineDesignSystemConfig` will reject).
|
|
416
456
|
- Optical constants repeated in components instead of `theme.materials` (catch with the **Material profiles and aggregate policy stay theme-owned** grep and inspect any component-local hits).
|
|
417
457
|
- Glass profiles without a semantic priority or a glass theme without one aggregate runtime policy (catch with the same material-policy grep and schema validation).
|
package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md
CHANGED
|
@@ -436,20 +436,29 @@ export interface A11yPolicy {
|
|
|
436
436
|
* disable). When a finite tier is set the surface is also centered in its
|
|
437
437
|
* container (`margin-inline: auto`).
|
|
438
438
|
*/
|
|
439
|
-
export
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
|
|
439
|
+
export const RESPONSIVE_MAX_WIDTH_VALUES = [
|
|
440
|
+
'full',
|
|
441
|
+
'sm',
|
|
442
|
+
'md',
|
|
443
|
+
'lg',
|
|
444
|
+
'xl',
|
|
445
445
|
// Reading-measure cap (~42rem) for single-column FORM / field stacks (T4c),
|
|
446
446
|
// so detail/settings forms stop stretching edge-to-edge inside a wide content
|
|
447
447
|
// zone. Wider than the component tiers (`sm`–`xl`, dialog-scale) but far tighter
|
|
448
448
|
// than `content`/`centered-readable`. Retune via `--measure-max-width`.
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
|
|
449
|
+
'measure',
|
|
450
|
+
'centered-readable',
|
|
451
|
+
'content',
|
|
452
|
+
'none',
|
|
453
|
+
] as const;
|
|
454
|
+
|
|
455
|
+
/**
|
|
456
|
+
* The RUNTIME source for the width vocabulary, so a schema that must validate a declared tier can
|
|
457
|
+
* name it instead of re-listing the members. It became necessary the moment width stopped being a
|
|
458
|
+
* surface-only concern: the zone content boundary, `DisplayLayout` and `FormLayout` all select a tier
|
|
459
|
+
* now, and a second hand-written list of the same nine values is a list that drifts.
|
|
460
|
+
*/
|
|
461
|
+
export type ResponsiveMaxWidth = (typeof RESPONSIVE_MAX_WIDTH_VALUES)[number];
|
|
453
462
|
|
|
454
463
|
export type MobileShape = 'inline' | 'drawer' | 'sheet';
|
|
455
464
|
|
package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md
ADDED
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
# Loading placeholders — the two things a theme must not decide freely
|
|
2
|
+
|
|
3
|
+
A skeleton is a GHOST OF CONTENT, not a surface of its own. Two consequences a theme gets wrong by
|
|
4
|
+
reaching for a palette entry, both measured on a live application rather than supposed.
|
|
5
|
+
|
|
6
|
+
## 1. The fill is a neutral TINT, never a semantic colour
|
|
7
|
+
|
|
8
|
+
`bg-accent`, `bg-secondary`, `bg-muted` and their siblings carry meaning — and, more importantly, carry
|
|
9
|
+
the APPLICATION's brand. A workbench whose accent resolves to `oklch(0.606 0.25 292)` flashed saturated
|
|
10
|
+
violet slabs on every list, card and detail page while it loaded.
|
|
11
|
+
|
|
12
|
+
They are also OPAQUE, which makes them correct on exactly the one surface they were picked against. The
|
|
13
|
+
same skeleton renders on the page, inside a raised card, inside a muted panel and inside an overlay.
|
|
14
|
+
|
|
15
|
+
Use `SKELETON_NEUTRAL_TINT` from `@wildo-ai/presets-components-models` — a low-alpha tint of the
|
|
16
|
+
foreground. It composites correctly on every surface and inverts for free in dark mode, because
|
|
17
|
+
`--foreground` already does.
|
|
18
|
+
|
|
19
|
+
```ts
|
|
20
|
+
const skeleton: UIBehaviorRecipe = recipe({
|
|
21
|
+
base: `${SKELETON_NEUTRAL_TINT} animate-pulse ${MY.radius} motion-reduce:animate-none`,
|
|
22
|
+
});
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
A theme still owns radius, border and animation — its idiom. A theme that needs a different strength
|
|
26
|
+
changes the ALPHA (`bg-foreground/5`) rather than reaching for a palette token.
|
|
27
|
+
|
|
28
|
+
## 2. A COLLECTION repeats its silhouette
|
|
29
|
+
|
|
30
|
+
A template describes ONE thing. Drawing one of them on a list tells the reader "one item is coming"
|
|
31
|
+
while twenty are, and it is the most common complaint about skeletons: *I cannot tell what these are.*
|
|
32
|
+
|
|
33
|
+
`Skeleton` takes a `count`. A collection knows its page size, so it says so — and the framework's own
|
|
34
|
+
list layout already does this for every resource. The count is clamped, so a page size of 100 does not
|
|
35
|
+
paint a wall of grey.
|
|
36
|
+
|
|
37
|
+
**Match the silhouette to what the collection actually draws, which is two questions rather than one.**
|
|
38
|
+
A table draws rows; so does a CARDS collection whose `cardLayout.style` is `LIST` — the classic stacked
|
|
39
|
+
list of one-line entries. Only a card GRID draws the tall card shape. Keying on the display mode alone
|
|
40
|
+
gives a page of 128px blocks above a list of one-line rows.
|
|
41
|
+
|
|
42
|
+
## What you do not have to do
|
|
43
|
+
|
|
44
|
+
Nothing, for an ordinary application. Both behaviours are the framework default: the shipped themes
|
|
45
|
+
carry the neutral tint, and `ResourceLayout_List` passes the template and count for every resource
|
|
46
|
+
list. This page matters when you AUTHOR a theme, or when a custom collection surface draws its own
|
|
47
|
+
loading state.
|
|
@@ -24,11 +24,10 @@ export const designSystemConfig = defineDesignSystemConfig({
|
|
|
24
24
|
});
|
|
25
25
|
```
|
|
26
26
|
|
|
27
|
-
Local exceptions belong on the component that owns the behavior.
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
application-facing wrapper only when the selected package version exposes one.
|
|
27
|
+
Local exceptions belong on the component that owns the behavior. Import
|
|
28
|
+
`Surface` from `@wildo-ai/saas-frontend-lib` and pass its `policyOverride` for
|
|
29
|
+
a local exception. The primitive is a public root export; do not use a
|
|
30
|
+
file-shaped deep import. Keep shared variant policy in application configuration.
|
|
32
31
|
|
|
33
32
|
Use app-level policy when every surface of that variant should behave the same
|
|
34
33
|
way. Use local `policyOverride` when only one wrapper is special and children
|
|
@@ -50,11 +49,21 @@ surfacePolicies: {
|
|
|
50
49
|
}
|
|
51
50
|
```
|
|
52
51
|
|
|
53
|
-
If a nested or sibling `SHELL` wrapper is only ambient layout context,
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
52
|
+
If a nested or sibling `SHELL` wrapper is only ambient layout context, opt out locally:
|
|
53
|
+
|
|
54
|
+
```tsx
|
|
55
|
+
import { Surface } from '@wildo-ai/saas-frontend-lib';
|
|
56
|
+
import { SurfaceVariant } from '@wildo-ai/presets-components-models';
|
|
57
|
+
|
|
58
|
+
<Surface
|
|
59
|
+
variant={SurfaceVariant.SHELL}
|
|
60
|
+
policyOverride={{ a11y: { landmarkRole: 'none' } }}
|
|
61
|
+
>
|
|
62
|
+
<aside>Supporting content</aside>
|
|
63
|
+
</Surface>
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
The supporting content here is illustrative; use the application's labels for displayed text.
|
|
58
67
|
|
|
59
68
|
The rule is: exactly one `main` landmark per page. Canonical shell opt-in is
|
|
60
69
|
global; non-canonical shell wrappers opt out locally.
|