@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
|
@@ -0,0 +1,348 @@
|
|
|
1
|
+
# Authoring the processor register
|
|
2
|
+
|
|
3
|
+
The shape of an entry naming somebody else who processes personal data — their legal identity, where
|
|
4
|
+
they process, and their own subprocessors.
|
|
5
|
+
|
|
6
|
+
Read this when:
|
|
7
|
+
|
|
8
|
+
- a privacy notice or a transfer statement needs a recipient's identity and you have to add it;
|
|
9
|
+
- a report names a configured provider as undeclared;
|
|
10
|
+
- you are deciding between the two entry kinds, or whether an entry needs a `purpose`;
|
|
11
|
+
- you are tempted to fill an entry in from what a vendor probably is.
|
|
12
|
+
|
|
13
|
+
Do not do the last one. The register has no field for an unverified identity, on purpose: an entry
|
|
14
|
+
that is PRESENT means somebody established it, and an entry that is ABSENT means nobody has looked.
|
|
15
|
+
Inventing a plausible legal entity destroys the only signal the absence carries — and a stale entity
|
|
16
|
+
in a published notice is worse than an absent one.
|
|
17
|
+
|
|
18
|
+
## Import Origins
|
|
19
|
+
|
|
20
|
+
- `@wildo-ai/saas-specifications`
|
|
21
|
+
|
|
22
|
+
## Source Excerpts
|
|
23
|
+
|
|
24
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
25
|
+
|
|
26
|
+
```typescript
|
|
27
|
+
/**
|
|
28
|
+
* **Who else processes personal data, under what legal identity, and where.**
|
|
29
|
+
*
|
|
30
|
+
* ## The gap this closes
|
|
31
|
+
*
|
|
32
|
+
* A configured provider establishes THAT a third party is involved and WHAT FUNCTION it performs —
|
|
33
|
+
* `EngineCapability` gives email delivery, storage, payments, LLM inference, observability. It gives
|
|
34
|
+
* none of the three things a reader of a privacy notice needs: the processor's legal identity, the
|
|
35
|
+
* region it processes in, and its own subprocessors (issue #88).
|
|
36
|
+
*
|
|
37
|
+
* That gap blocks two concerns rather than one, and the second cannot be answered independently: an
|
|
38
|
+
* international-transfer statement is a statement about WHERE a recipient processes, so a provider
|
|
39
|
+
* carrying no region cannot support one.
|
|
40
|
+
*
|
|
41
|
+
* ## Declared by the APPLICATION, not derived from the provider
|
|
42
|
+
*
|
|
43
|
+
* A provider's legal entity is a fact about a vendor, and it is tempting to put it on the provider
|
|
44
|
+
* definition so every application inherits it. It is not carried there, deliberately: what a document
|
|
45
|
+
* must state is the arrangement THIS operator has — which vendor, in which region, under which
|
|
46
|
+
* contract — and two applications using the same vendor can honestly differ on all three. A
|
|
47
|
+
* framework-supplied identity would also be a fact the framework cannot keep true: vendors reorganise,
|
|
48
|
+
* and a stale legal entity in a published notice is worse than an absent one.
|
|
49
|
+
*
|
|
50
|
+
* So the register is authored beside the application's other specifications and read from there. What
|
|
51
|
+
* the framework contributes is the QUESTION and the gap report, never the answer.
|
|
52
|
+
*
|
|
53
|
+
* ## Absence is a gap with a NAME, because the configured set is already known
|
|
54
|
+
*
|
|
55
|
+
* The application's composition already lists its configured providers. Comparing that list against
|
|
56
|
+
* this register turns "processor identities are not established" into "`anthropic` is configured and
|
|
57
|
+
* undeclared" — a gap an operator can act on, per provider, rather than a sentence they cannot.
|
|
58
|
+
*
|
|
59
|
+
* See {@link undeclaredProcessorRefs}. An entry ABSENT from the register means nobody has established
|
|
60
|
+
* that processor's identity; it never means the provider is not in use.
|
|
61
|
+
*/
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* One subprocessor a declared processor uses in turn.
|
|
65
|
+
*
|
|
66
|
+
* Carried because a privacy notice's recipient statement is only as true as its deepest hop: a
|
|
67
|
+
* customer's data reaching a vendor's own hosting provider is a disclosure, and a notice naming only
|
|
68
|
+
* the first hop understates who holds the data.
|
|
69
|
+
*/
|
|
70
|
+
export const ProcessorSubprocessorSchema = z.strictObject({
|
|
71
|
+
/** The subprocessor's name as the processor discloses it. */
|
|
72
|
+
name: z.string().trim().min(1),
|
|
73
|
+
/**
|
|
74
|
+
* Where this subprocessor processes, as the processor discloses it.
|
|
75
|
+
*
|
|
76
|
+
* Required: a subprocessor with no location cannot support the transfer statement that is the whole
|
|
77
|
+
* reason for following the chain this far.
|
|
78
|
+
*/
|
|
79
|
+
processingRegions: z.array(z.string().trim().min(1)).min(1),
|
|
80
|
+
});
|
|
81
|
+
export type ProcessorSubprocessor = z.infer<typeof ProcessorSubprocessorSchema>;
|
|
82
|
+
|
|
83
|
+
/**
|
|
84
|
+
* WHICH KIND of subprocessor an entry describes.
|
|
85
|
+
*
|
|
86
|
+
* **Providers are a SUBSET of subprocessors, and this register was built as if they were the whole
|
|
87
|
+
* set.** Every entry keyed on `providerRef` and the schema enforced one entry per provider, which
|
|
88
|
+
* made it structurally unable to hold a subprocessor the application does not configure as a
|
|
89
|
+
* provider — a hosting company, a CDN, a support tool, an accountant. Those are processors under
|
|
90
|
+
* Art. 28 and belong in the same register a notice reads (issue #130).
|
|
91
|
+
*
|
|
92
|
+
* The discriminator exists because the two arms differ in what can be CHECKED, not merely in shape.
|
|
93
|
+
* A configured-provider entry joins to the application's composition, so a claim about a provider it
|
|
94
|
+
* does not configure is detectable and a configured provider with no entry is a reportable gap. An
|
|
95
|
+
* authored entry joins to nothing: no configuration mentions the operator's hosting company, so the
|
|
96
|
+
* framework can neither confirm it nor notice its absence. Collapsing them would present an
|
|
97
|
+
* unverifiable claim with the same authority as a checkable one.
|
|
98
|
+
*/
|
|
99
|
+
export enum ProcessorRegisterEntryKind {
|
|
100
|
+
/** A provider the application configures. Joins to `providerRef`, and its absence is reportable. */
|
|
101
|
+
CONFIGURED_PROVIDER = "CONFIGURED_PROVIDER",
|
|
102
|
+
/** A subprocessor nothing in the configuration mentions. Unverifiable by construction, and stated as authored. */
|
|
103
|
+
AUTHORED = "AUTHORED",
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* The instrument that makes a transfer of personal data out of its origin jurisdiction lawful.
|
|
108
|
+
*
|
|
109
|
+
* spec-cite: GDPR Chapter V — Art. 45 (adequacy), Art. 46(2)(b)–(f) (appropriate safeguards), Art. 47 (binding
|
|
110
|
+
* corporate rules), Art. 49(1) (derogations). The UK GDPR keeps the same structure, so one vocabulary serves
|
|
111
|
+
* both; the INSTRUMENT that fills a member differs by jurisdiction (the EU clauses, the UK Addendum), which is
|
|
112
|
+
* why each safeguard names its instrument in prose beside the member.
|
|
113
|
+
*
|
|
114
|
+
* Recorded, never computed (#126): which mechanism applies is a legal determination with a shelf life —
|
|
115
|
+
* an adequacy decision can be struck down while the vendor stays where it is — so the framework offers the
|
|
116
|
+
* place to write it down and derives nothing from a region.
|
|
117
|
+
*/
|
|
118
|
+
export enum InternationalTransferMechanism {
|
|
119
|
+
/** Art. 45 — the destination is covered by an adequacy decision (for the United States, the Data Privacy Framework, for a certified recipient). */
|
|
120
|
+
ADEQUACY_DECISION = "ADEQUACY_DECISION",
|
|
121
|
+
/** Art. 46(2)(c)/(d) — standard data protection clauses, or a jurisdiction's equivalent (the UK Addendum to them). */
|
|
122
|
+
STANDARD_CONTRACTUAL_CLAUSES = "STANDARD_CONTRACTUAL_CLAUSES",
|
|
123
|
+
/** Art. 46(2)(b) and Art. 47 — binding corporate rules approved for the recipient's group. */
|
|
124
|
+
BINDING_CORPORATE_RULES = "BINDING_CORPORATE_RULES",
|
|
125
|
+
/** Art. 46(2)(e) — an approved code of conduct with binding commitments of the recipient. */
|
|
126
|
+
APPROVED_CODE_OF_CONDUCT = "APPROVED_CODE_OF_CONDUCT",
|
|
127
|
+
/** Art. 46(2)(f) — an approved certification with binding commitments of the recipient. */
|
|
128
|
+
APPROVED_CERTIFICATION = "APPROVED_CERTIFICATION",
|
|
129
|
+
/** Art. 49 — a derogation for a specific situation. Requires {@link InternationalTransferDerogation}. */
|
|
130
|
+
DEROGATION = "DEROGATION",
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/** Which Art. 49 derogation a {@link InternationalTransferMechanism.DEROGATION} relies on. spec-cite: GDPR Art. 49(1). */
|
|
134
|
+
export enum InternationalTransferDerogation {
|
|
135
|
+
/** Art. 49(1)(a) — explicit consent after being informed of the risks. */
|
|
136
|
+
EXPLICIT_CONSENT = "EXPLICIT_CONSENT",
|
|
137
|
+
/** Art. 49(1)(b) — necessary for a contract with the data subject. */
|
|
138
|
+
CONTRACT_WITH_SUBJECT = "CONTRACT_WITH_SUBJECT",
|
|
139
|
+
/** Art. 49(1)(c) — necessary for a contract concluded in the subject's interest with another party. */
|
|
140
|
+
CONTRACT_IN_SUBJECT_INTEREST = "CONTRACT_IN_SUBJECT_INTEREST",
|
|
141
|
+
/** Art. 49(1)(d) — important reasons of public interest. */
|
|
142
|
+
PUBLIC_INTEREST = "PUBLIC_INTEREST",
|
|
143
|
+
/** Art. 49(1)(e) — establishment, exercise or defence of legal claims. */
|
|
144
|
+
LEGAL_CLAIMS = "LEGAL_CLAIMS",
|
|
145
|
+
/** Art. 49(1)(f) — vital interests where the subject cannot consent. */
|
|
146
|
+
VITAL_INTERESTS = "VITAL_INTERESTS",
|
|
147
|
+
/** Art. 49(1)(g) — a transfer from a public register. */
|
|
148
|
+
PUBLIC_REGISTER = "PUBLIC_REGISTER",
|
|
149
|
+
/** Art. 49(1), second subparagraph — compelling legitimate interests, for a non-repetitive transfer. */
|
|
150
|
+
COMPELLING_LEGITIMATE_INTERESTS = "COMPELLING_LEGITIMATE_INTERESTS",
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* Whether reaching this processor moves personal data out of the jurisdiction it came from.
|
|
155
|
+
*
|
|
156
|
+
* A DETERMINATION, recorded by the operator, because regions are free text: nothing can compare
|
|
157
|
+
* `United States` or `eu-west-1` with a declared operating jurisdiction, so the framework cannot tell a
|
|
158
|
+
* domestic processor from a foreign one and does not guess.
|
|
159
|
+
*/
|
|
160
|
+
export enum ProcessorTransferDeterminationKind {
|
|
161
|
+
/** Every region this processor (and its subprocessors) uses lies within the jurisdictions the data comes from. */
|
|
162
|
+
NO_TRANSFER = "NO_TRANSFER",
|
|
163
|
+
/** Personal data leaves its origin jurisdiction to reach this processor, under the safeguards named. */
|
|
164
|
+
TRANSFER = "TRANSFER",
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
/** The safeguard one origin jurisdiction's data travels under. */
|
|
168
|
+
export const ProcessorTransferSafeguardSchema = z
|
|
169
|
+
.strictObject({
|
|
170
|
+
/** The jurisdiction the data leaves — one of the application's `operatingJurisdictions`. */
|
|
171
|
+
originJurisdictionSlug: z.string().trim().min(1),
|
|
172
|
+
mechanism: z.enum(InternationalTransferMechanism).systemEnum("InternationalTransferMechanism"),
|
|
173
|
+
/** Required with {@link InternationalTransferMechanism.DEROGATION}, refused otherwise. */
|
|
174
|
+
derogation: z.enum(InternationalTransferDerogation).systemEnum("InternationalTransferDerogation").optional(),
|
|
175
|
+
/**
|
|
176
|
+
* The instrument, as a reader could look it up: "EU SCCs (Commission Decision 2021/914), Module Two",
|
|
177
|
+
* "UK Addendum to the EU SCCs", "EU-US Data Privacy Framework — recipient certified". A mechanism
|
|
178
|
+
* member alone tells a reader the article, not the document that binds the recipient.
|
|
179
|
+
*/
|
|
180
|
+
instrument: z.string().trim().min(1),
|
|
181
|
+
})
|
|
182
|
+
.superRefine((safeguard, context) => {
|
|
183
|
+
const isDerogation = safeguard.mechanism === InternationalTransferMechanism.DEROGATION;
|
|
184
|
+
if (isDerogation !== (safeguard.derogation !== undefined)) {
|
|
185
|
+
context.addIssue({
|
|
186
|
+
code: "custom",
|
|
187
|
+
path: ["derogation"],
|
|
188
|
+
message: isDerogation ? "a derogation must name which Art. 49 ground it relies on" : "only a DEROGATION mechanism names a derogation",
|
|
189
|
+
});
|
|
190
|
+
}
|
|
191
|
+
});
|
|
192
|
+
export type ProcessorTransferSafeguard = z.infer<typeof ProcessorTransferSafeguardSchema>;
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* The operator's transfer determination for one register entry.
|
|
196
|
+
*
|
|
197
|
+
* Carried by the ENTRY, not the provider, and not per subprocessor: a vendor's regions change when it opens
|
|
198
|
+
* a data centre, a mechanism changes when a court rules, and the processor's own contract is what binds its
|
|
199
|
+
* onward transfers to its subprocessors — so the determination for reaching this processor covers the chain
|
|
200
|
+
* behind it. It is OPTIONAL, and absence means "not determined": the `international-transfers` fact then
|
|
201
|
+
* answers nothing, because a register with an undetermined entry cannot support either "no transfer" or a
|
|
202
|
+
* list of safeguards.
|
|
203
|
+
*/
|
|
204
|
+
export const ProcessorTransferDeterminationSchema = z.discriminatedUnion("kind", [
|
|
205
|
+
z.strictObject({
|
|
206
|
+
kind: z.literal(ProcessorTransferDeterminationKind.NO_TRANSFER).systemEnum("ProcessorTransferDeterminationKind"),
|
|
207
|
+
/** Why none of the regions is outside the origin jurisdictions — the comparison the framework cannot make. */
|
|
208
|
+
rationale: z.string().trim().min(1),
|
|
209
|
+
}),
|
|
210
|
+
z
|
|
211
|
+
.strictObject({
|
|
212
|
+
kind: z.literal(ProcessorTransferDeterminationKind.TRANSFER).systemEnum("ProcessorTransferDeterminationKind"),
|
|
213
|
+
/** One safeguard per origin jurisdiction whose data reaches this processor. */
|
|
214
|
+
safeguards: z.array(ProcessorTransferSafeguardSchema).min(1),
|
|
215
|
+
})
|
|
216
|
+
.superRefine((determination, context) => {
|
|
217
|
+
const origins = determination.safeguards.map((safeguard) => safeguard.originJurisdictionSlug);
|
|
218
|
+
if (new Set(origins).size !== origins.length) {
|
|
219
|
+
context.addIssue({ code: "custom", path: ["safeguards"], message: "one safeguard per origin jurisdiction" });
|
|
220
|
+
}
|
|
221
|
+
}),
|
|
222
|
+
]);
|
|
223
|
+
export type ProcessorTransferDetermination = z.infer<typeof ProcessorTransferDeterminationSchema>;
|
|
224
|
+
|
|
225
|
+
const ProcessorIdentityFieldsSchema = z.object({
|
|
226
|
+
/**
|
|
227
|
+
* The processor's LEGAL entity — the party a data-protection obligation actually binds.
|
|
228
|
+
*
|
|
229
|
+
* Not the brand. "Anthropic" is a product name; a notice, a DPA and a supervisory authority all need
|
|
230
|
+
* the entity that signs.
|
|
231
|
+
*/
|
|
232
|
+
legalEntityName: z.string().trim().min(1),
|
|
233
|
+
/**
|
|
234
|
+
* Where this processor processes personal data for this application.
|
|
235
|
+
*
|
|
236
|
+
* A LIST at the processor level rather than per capability. The issue that opened this suggested
|
|
237
|
+
* per-capability regions, "where a provider offers regional endpoints" — declined for the reason
|
|
238
|
+
* that settled the retention schedule the same day: an operator decides a small number of things and
|
|
239
|
+
* defends them, and a granularity nobody maintains produces a register that is precise and wrong.
|
|
240
|
+
* An operator using one vendor in two regions declares both, which is what a notice states anyway.
|
|
241
|
+
*
|
|
242
|
+
* Free text rather than a closed vocabulary: region names are genuinely open (`eu-west-1`, `EU`,
|
|
243
|
+
* `Ireland`, `United States`), and a fixed list would be wrong for the next vendor.
|
|
244
|
+
*/
|
|
245
|
+
processingRegions: z.array(z.string().trim().min(1)).min(1),
|
|
246
|
+
/**
|
|
247
|
+
* The processor's own subprocessors.
|
|
248
|
+
*
|
|
249
|
+
* EMPTY is a real answer — "this processor discloses no subprocessors" — and it is available only
|
|
250
|
+
* because the whole entry is an authored declaration. An operator who has not checked omits the
|
|
251
|
+
* ENTRY, not this field, keeping one clean absence axis: present means established, absent means
|
|
252
|
+
* nobody has looked.
|
|
253
|
+
*/
|
|
254
|
+
subprocessors: z.array(ProcessorSubprocessorSchema),
|
|
255
|
+
/** Whether reaching this processor is an international transfer, and under what. See {@link ProcessorTransferDeterminationSchema}. */
|
|
256
|
+
transferDetermination: ProcessorTransferDeterminationSchema.optional(),
|
|
257
|
+
});
|
|
258
|
+
|
|
259
|
+
/** One entry in the register — a configured provider, or a subprocessor nothing configures. */
|
|
260
|
+
export const ApplicationProcessorDeclarationSchema = z.discriminatedUnion("kind", [
|
|
261
|
+
ProcessorIdentityFieldsSchema.extend({
|
|
262
|
+
kind: z.literal(ProcessorRegisterEntryKind.CONFIGURED_PROVIDER).systemEnum('ProcessorRegisterEntryKind'),
|
|
263
|
+
/**
|
|
264
|
+
* The configured provider this describes — the same ref the application's composition uses.
|
|
265
|
+
*
|
|
266
|
+
* The join is what makes this arm checkable: a declaration naming a provider the application does
|
|
267
|
+
* not configure describes a relationship it does not have, and a configured provider with no
|
|
268
|
+
* declaration is the gap {@link undeclaredProcessorRefs} reports.
|
|
269
|
+
*/
|
|
270
|
+
providerRef: z.string().trim().min(1),
|
|
271
|
+
/**
|
|
272
|
+
* Why this processor is used, where the capability does not already say.
|
|
273
|
+
*
|
|
274
|
+
* OPTIONAL on this arm alone, and the asymmetry is the point: a configured provider's purpose is
|
|
275
|
+
* implied by the capability it serves — `AI_LLM` takes prompt content, `EMAIL` takes recipient
|
|
276
|
+
* addresses — so restating it is a second authority for one fact. Supply it only where the
|
|
277
|
+
* capability under-describes what this particular vendor does for this application.
|
|
278
|
+
*/
|
|
279
|
+
purpose: z.string().trim().min(1).optional(),
|
|
280
|
+
}).strict(),
|
|
281
|
+
ProcessorIdentityFieldsSchema.extend({
|
|
282
|
+
kind: z.literal(ProcessorRegisterEntryKind.AUTHORED).systemEnum('ProcessorRegisterEntryKind'),
|
|
283
|
+
/**
|
|
284
|
+
* A stable slug for a subprocessor the configuration never mentions — `hosting`, `cdn`,
|
|
285
|
+
* `support-desk`. Its own key, because there is no `providerRef` to borrow.
|
|
286
|
+
*/
|
|
287
|
+
subprocessorRef: z.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/),
|
|
288
|
+
/**
|
|
289
|
+
* Why this subprocessor is used. REQUIRED here, because nothing else can say.
|
|
290
|
+
*
|
|
291
|
+
* The configured-provider arm can lean on its capability; this arm has no capability, no
|
|
292
|
+
* configuration and no runtime binding to imply anything. Without a purpose the entry is a name
|
|
293
|
+
* and a region, which tells a reader that someone else holds their data and not what for.
|
|
294
|
+
*/
|
|
295
|
+
purpose: z.string().trim().min(1),
|
|
296
|
+
}).strict(),
|
|
297
|
+
]);
|
|
298
|
+
export type ApplicationProcessorDeclaration = z.infer<typeof ApplicationProcessorDeclarationSchema>;
|
|
299
|
+
|
|
300
|
+
/**
|
|
301
|
+
* The application's accepted processor register.
|
|
302
|
+
*
|
|
303
|
+
* Deliberately NOT requiring an entry per configured provider. Requiring completeness would make the
|
|
304
|
+
* register unauthorable until every vendor had been researched, which is the blocking this whole
|
|
305
|
+
* capability exists to remove — a partial register is useful, and its holes are reported rather than
|
|
306
|
+
* hidden.
|
|
307
|
+
*/
|
|
308
|
+
export const ApplicationProcessorRegisterSchema = z
|
|
309
|
+
.strictObject({
|
|
310
|
+
schemaVersion: z.literal(1),
|
|
311
|
+
processors: z.array(ApplicationProcessorDeclarationSchema),
|
|
312
|
+
})
|
|
313
|
+
.superRefine((register, context) => {
|
|
314
|
+
/*
|
|
315
|
+
* Uniqueness PER ARM, on each arm's own key.
|
|
316
|
+
*
|
|
317
|
+
* Not one shared namespace: a `providerRef` and a `subprocessorRef` are addresses in different
|
|
318
|
+
* spaces, and colliding them would refuse an application whose hosting company happens to share a
|
|
319
|
+
* slug with a provider it configures — a refusal with no compliance meaning at all.
|
|
320
|
+
*/
|
|
321
|
+
const seenProviderRefs = new Set<string>();
|
|
322
|
+
const seenSubprocessorRefs = new Set<string>();
|
|
323
|
+
|
|
324
|
+
register.processors.forEach((processor, index) => {
|
|
325
|
+
if (processor.kind === ProcessorRegisterEntryKind.CONFIGURED_PROVIDER) {
|
|
326
|
+
if (seenProviderRefs.has(processor.providerRef)) {
|
|
327
|
+
context.addIssue({
|
|
328
|
+
code: "custom",
|
|
329
|
+
path: ["processors", index, "providerRef"],
|
|
330
|
+
message: `"${processor.providerRef}" is declared twice; one provider carries one processor identity`,
|
|
331
|
+
});
|
|
332
|
+
}
|
|
333
|
+
seenProviderRefs.add(processor.providerRef);
|
|
334
|
+
return;
|
|
335
|
+
}
|
|
336
|
+
|
|
337
|
+
if (seenSubprocessorRefs.has(processor.subprocessorRef)) {
|
|
338
|
+
context.addIssue({
|
|
339
|
+
code: "custom",
|
|
340
|
+
path: ["processors", index, "subprocessorRef"],
|
|
341
|
+
message: `"${processor.subprocessorRef}" is declared twice; one subprocessor carries one identity`,
|
|
342
|
+
});
|
|
343
|
+
}
|
|
344
|
+
seenSubprocessorRefs.add(processor.subprocessorRef);
|
|
345
|
+
});
|
|
346
|
+
});
|
|
347
|
+
export type ApplicationProcessorRegister = z.infer<typeof ApplicationProcessorRegisterSchema>;
|
|
348
|
+
```
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# Per-provider compliance choice
|
|
2
|
+
|
|
3
|
+
Where a privacy notice's "who processes this, and where" comes from: the deployment model and
|
|
4
|
+
processing region an application declares for each provider it has configured.
|
|
5
|
+
|
|
6
|
+
Read this when:
|
|
7
|
+
|
|
8
|
+
- a notice or processor-register entry has to state where personal data goes;
|
|
9
|
+
- you are adding a provider and need to say whether the vendor or the operator runs it;
|
|
10
|
+
- the configuration is refused for a missing or a surplus processing region;
|
|
11
|
+
- you are checking whether the regions an application asserts agree with what its vendors declare.
|
|
12
|
+
|
|
13
|
+
The last one is the case with no mechanism behind it — see the warning in the extracted source.
|
|
14
|
+
|
|
15
|
+
## Import Origins
|
|
16
|
+
|
|
17
|
+
- `@wildo-ai/saas-models`
|
|
18
|
+
|
|
19
|
+
## Source Excerpts
|
|
20
|
+
|
|
21
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
22
|
+
|
|
23
|
+
```typescript
|
|
24
|
+
/**
|
|
25
|
+
* The application's CHOICE among what a provider offers — one entry per configured provider.
|
|
26
|
+
*
|
|
27
|
+
* The provider declares possibilities ({@link ProviderComplianceProfileSchema}); this is where an
|
|
28
|
+
* operator says which of them applies to their deployment. Keeping the two apart is the whole point
|
|
29
|
+
* of the layering: a vendor's regions change when it opens a data centre, an operator's choice
|
|
30
|
+
* changes when they migrate, and collapsing them would make one edit look like the other.
|
|
31
|
+
*
|
|
32
|
+
* Not carried inside `providerConfigurations`, which is an opaque `Record<string, unknown>` bag for a
|
|
33
|
+
* provider's own runtime profile. A compliance answer must not live somewhere nothing can read it
|
|
34
|
+
* without knowing the provider.
|
|
35
|
+
*/
|
|
36
|
+
export const ApplicationProviderComplianceChoiceSchema = z.strictObject({
|
|
37
|
+
/**
|
|
38
|
+
* Who runs this provider in THIS deployment.
|
|
39
|
+
*
|
|
40
|
+
* Required even when the provider supports only one model. The redundancy is deliberate: whether
|
|
41
|
+
* personal data leaves the operator's control is the single most consequential fact a notice states
|
|
42
|
+
* about a provider, and reading it out of a framework default rather than an operator's declaration
|
|
43
|
+
* is how a wrong one goes unnoticed.
|
|
44
|
+
*/
|
|
45
|
+
deploymentModel: z.enum(ProviderDeploymentModel),
|
|
46
|
+
/**
|
|
47
|
+
* Which region this provider processes in, chosen from what the provider declares possible.
|
|
48
|
+
*
|
|
49
|
+
* NOT validated here, and NOT validated at boot either. This schema cannot see the provider
|
|
50
|
+
* registry, and refusing an unlisted region would make a vendor's new data centre an application
|
|
51
|
+
* build failure, so the intended posture is warn-do-not-block: a region outside the provider's
|
|
52
|
+
* declared list is APP-ASSERTED and reported, never refused.
|
|
53
|
+
*
|
|
54
|
+
* WIRED since 2026-09-10 (issue #308). `appAssertedProcessingRegions` below computes exactly that
|
|
55
|
+
* set, and the companion's compliance-primary-facts section reports it per provider, naming both the
|
|
56
|
+
* configured value and what the provider declares — because a divergence is either a typo or a stale
|
|
57
|
+
* provider module, and those are opposite work. It took this long only because of a DATA PATH: the
|
|
58
|
+
* vendor's region list lives on the backend provider module and the renderer reads provider
|
|
59
|
+
* SPECIFICATIONS, so the helper could not be called until `complianceProfile` was mirrored onto the
|
|
60
|
+
* specification contract. Any future report must call this helper rather than re-derive the
|
|
61
|
+
* comparison.
|
|
62
|
+
*/
|
|
63
|
+
processingRegion: z.string().trim().min(1).optional(),
|
|
64
|
+
}).superRefine((choice, context) => {
|
|
65
|
+
/*
|
|
66
|
+
* The pairing, in both directions.
|
|
67
|
+
*
|
|
68
|
+
* A VENDOR_HOSTED choice with no region leaves the notice unable to state where the data goes,
|
|
69
|
+
* which is the question this whole layer exists to answer. A SELF_HOSTED choice WITH one is the
|
|
70
|
+
* fiction the provider layer already refuses: the operator runs it, so its region is wherever they
|
|
71
|
+
* run it, and a value here would be a guess presented as a configuration.
|
|
72
|
+
*/
|
|
73
|
+
if (choice.deploymentModel === ProviderDeploymentModel.VENDOR_HOSTED && choice.processingRegion === undefined) {
|
|
74
|
+
context.addIssue({
|
|
75
|
+
code: 'custom',
|
|
76
|
+
path: ['processingRegion'],
|
|
77
|
+
message: 'a VENDOR_HOSTED provider must be configured with the region it processes in — without one, no notice can state where this data goes',
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
if (choice.deploymentModel === ProviderDeploymentModel.SELF_HOSTED && choice.processingRegion !== undefined) {
|
|
81
|
+
context.addIssue({
|
|
82
|
+
code: 'custom',
|
|
83
|
+
path: ['processingRegion'],
|
|
84
|
+
message: 'a SELF_HOSTED provider runs wherever the operator runs it, so a processing region here is a guess presented as configuration — drop it',
|
|
85
|
+
});
|
|
86
|
+
}
|
|
87
|
+
});
|
|
88
|
+
export type ApplicationProviderComplianceChoice = z.infer<typeof ApplicationProviderComplianceChoiceSchema>;
|
|
89
|
+
|
|
90
|
+
/** Per configured provider ref, the operator's compliance choice. */
|
|
91
|
+
export const ApplicationProviderComplianceChoicesSchema = z.record(
|
|
92
|
+
z.string().trim().min(1),
|
|
93
|
+
ApplicationProviderComplianceChoiceSchema,
|
|
94
|
+
);
|
|
95
|
+
export type ApplicationProviderComplianceChoices = z.infer<typeof ApplicationProviderComplianceChoicesSchema>;
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* Regions an application asserts that the provider does not declare.
|
|
99
|
+
*
|
|
100
|
+
* Reported, never refused — a vendor opening a data centre must not become a build failure, and an
|
|
101
|
+
* operator who genuinely knows better than a stale framework list should be able to say so. What the
|
|
102
|
+
* framework owes is that the divergence is VISIBLE, which is the same trade the personal-data
|
|
103
|
+
* declaration report makes.
|
|
104
|
+
*/
|
|
105
|
+
export function appAssertedProcessingRegions(params: {
|
|
106
|
+
readonly choices: ApplicationProviderComplianceChoices;
|
|
107
|
+
readonly profilesByProviderRef: Readonly<Record<string, ProviderComplianceProfile>>;
|
|
108
|
+
}): ReadonlyArray<{ readonly providerRef: string; readonly region: string }> {
|
|
109
|
+
const asserted: Array<{ providerRef: string; region: string }> = [];
|
|
110
|
+
|
|
111
|
+
for (const [providerRef, choice] of Object.entries(params.choices)) {
|
|
112
|
+
if (choice.processingRegion === undefined) continue;
|
|
113
|
+
const profile = params.profilesByProviderRef[providerRef];
|
|
114
|
+
// No profile is not an assertion about a region — it is a provider that declares no compliance
|
|
115
|
+
// profile at all, which is a different gap and belongs to whoever reports THAT.
|
|
116
|
+
if (profile === undefined) continue;
|
|
117
|
+
if (profile.processingRegions.includes(choice.processingRegion)) continue;
|
|
118
|
+
asserted.push({ providerRef, region: choice.processingRegion });
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
return asserted;
|
|
122
|
+
}
|
|
123
|
+
```
|
|
@@ -37,6 +37,7 @@ them.
|
|
|
37
37
|
| Module command items| `frontend/src/modules/<module>/app-shell.module.frontend.ts` (`commandMenuItems` contribution)|
|
|
38
38
|
| Module scope fields | `frontend/src/modules/<module>/app-shell.module.frontend.ts` (`quickSwitcherFields` contribution)|
|
|
39
39
|
| Other app config | `frontend/src/config/*.config.ts` (navigation, design-system, global-views) |
|
|
40
|
+
| Public-page identity | `frontend/src/modules-registry.frontend.ts` (`publicShellIdentityMode` — NOT `app-shell.config.ts`) |
|
|
40
41
|
| Translation labels | `frontend/src/i18n/`, `frontend/src/labels/` (depending on app convention) |
|
|
41
42
|
| Hotkey bindings | Resolved by the engine from `[ApplicationLevelComponentType.HOTKEY]` + per-component `openShortcut` |
|
|
42
43
|
|
|
@@ -53,6 +54,7 @@ them.
|
|
|
53
54
|
- Adjusting user dropdown sections / avatar display
|
|
54
55
|
- Toggling deferred shell surfaces (activity bar, utility panel, control panel)
|
|
55
56
|
- Changing responsive policy (sidebar burger threshold, etc.)
|
|
57
|
+
- Naming the application on its sign-in / registration pages (`publicShellIdentityMode`)
|
|
56
58
|
|
|
57
59
|
## When NOT to Use
|
|
58
60
|
|
|
@@ -135,6 +137,24 @@ dropdown rows, `presentation` for the closed control. Read
|
|
|
135
137
|
for what the declaration wires for free (ambient scope, URL promotion,
|
|
136
138
|
bi-directional mirroring, deselection).
|
|
137
139
|
|
|
140
|
+
### Step 3d: Name the application on its public pages
|
|
141
|
+
|
|
142
|
+
Sign-in, registration and every other pre-authentication card can carry the
|
|
143
|
+
application's mark and name. It is opt-in and off by default.
|
|
144
|
+
|
|
145
|
+
It is one property, inside the existing `buildFrontendModuleConfigOverrides({ … })`
|
|
146
|
+
call in `frontend/src/modules-registry.frontend.ts`, beside `homeDefinition` and
|
|
147
|
+
`errorPageConfig`:
|
|
148
|
+
|
|
149
|
+
`publicShellIdentityMode: PublicShellIdentityMode.BRAND_HEADER` (imported from
|
|
150
|
+
`@wildo-ai/saas-frontend-lib`).
|
|
151
|
+
|
|
152
|
+
Two things to know before you reach for `appShellConfig` instead: this is not an
|
|
153
|
+
`ApplicationLevelComponentType` key and putting it there silently configures
|
|
154
|
+
nothing, and the mode is a PERMISSION rather than a promise that a logo exists —
|
|
155
|
+
an application with no generated brand shows its name alone. Read
|
|
156
|
+
`references/framework-public-shell-identity-api.md` for the full render matrix.
|
|
157
|
+
|
|
138
158
|
### Step 4: Labels
|
|
139
159
|
|
|
140
160
|
Any new user-visible chrome string (command names, section titles,
|
|
@@ -225,7 +245,6 @@ export const appShellConfig : AppConfiguration_Frontend['appComponentsConfigurat
|
|
|
225
245
|
responsiveBreakpoint: ViewportBreakpoint.MOBILE,
|
|
226
246
|
responsivePolicy: SidebarResponsivePolicy.BURGER,
|
|
227
247
|
defaultSection: 'main',
|
|
228
|
-
showUncategorized: true,
|
|
229
248
|
// HOME as the app's BRAND HEADER: the generated Your Application symbol + the
|
|
230
249
|
// application display name, pinned above the search trigger and doubling as
|
|
231
250
|
// the home button (so no separate "Home" row renders). The alternatives are
|
|
@@ -278,6 +297,11 @@ export const appShellConfig : AppConfiguration_Frontend['appComponentsConfigurat
|
|
|
278
297
|
[ApplicationLevelComponentType.QUICK_ACTION_BUTTON]: true,
|
|
279
298
|
|
|
280
299
|
[ApplicationLevelComponentType.QUICK_SWITCHER]: true,
|
|
300
|
+
/**
|
|
301
|
+
* OFF, and that is an answer rather than an omission (#504). This application's settings and
|
|
302
|
+
* actions are served by the settings hub overlay, so a persistent rail would duplicate it. It is
|
|
303
|
+
* switched on by the first application that genuinely wants one.
|
|
304
|
+
*/
|
|
281
305
|
[ApplicationLevelComponentType.CONTROL_PANEL]: false,
|
|
282
306
|
[ApplicationLevelComponentType.STATUS_BAR]: {
|
|
283
307
|
showMemoryUsage: false,
|
|
@@ -296,18 +320,49 @@ export const appShellConfig : AppConfiguration_Frontend['appComponentsConfigurat
|
|
|
296
320
|
],
|
|
297
321
|
showOrgSwitcher: true,
|
|
298
322
|
showLogout: true,
|
|
299
|
-
mergeSettings: false,
|
|
300
323
|
},
|
|
301
324
|
|
|
302
|
-
[ApplicationLevelComponentType.SETTINGS_DROPDOWN]: {
|
|
303
|
-
mergedWith: ApplicationLevelComponentType.USER_DROPDOWN,
|
|
304
|
-
},
|
|
305
325
|
|
|
306
326
|
[ApplicationLevelComponentType.NAVIGATION_CONTROL]: true,
|
|
307
327
|
|
|
308
|
-
|
|
328
|
+
/**
|
|
329
|
+
* The Gmail-style right-side panel, holding the Todo Assistant (#504).
|
|
330
|
+
*
|
|
331
|
+
* It hosts a VIEW rather than a component, and that distinction is the point. The assistant is an
|
|
332
|
+
* ACTOR SYSTEM — `todo-assistant`, declared by the backend addon and exposed as the
|
|
333
|
+
* `todo-assistant-view` flows-actors view — not a chat widget, and an actor is not necessarily an
|
|
334
|
+
* agent: `Actor_ExecutionMode` is `AGENTIC | FLOW_EXECUTION | HUMAN_INTERACTION`, so the same
|
|
335
|
+
* surface renders a programmatic node as readily as a model-backed one. A `CUSTOM_COMPONENT` item
|
|
336
|
+
* is rendered with no arguments and so could never be told WHICH system to show.
|
|
337
|
+
*
|
|
338
|
+
* The panel is where this belongs rather than a route: an assistant grounded in what you are
|
|
339
|
+
* looking at has to stay beside the workspace, and `/flows-actors/todo-assistant-view` replaces it.
|
|
340
|
+
* Nothing in the panel navigates, so hosting a view here needs no navigation zone of its own —
|
|
341
|
+
* see the `UTILITY_PANEL` declaration for when that changes.
|
|
342
|
+
*/
|
|
343
|
+
[ApplicationLevelComponentType.UTILITY_PANEL]: {
|
|
344
|
+
position: HorizontalPlacement.END,
|
|
345
|
+
items: [
|
|
346
|
+
{
|
|
347
|
+
kind: LauncherItemTargetKind.VIEW,
|
|
348
|
+
viewRef: 'todo-assistant-view',
|
|
349
|
+
// semantic-literal-boundary: the value of `StandardIconReference.BRAIN`. That enum is not on
|
|
350
|
+
// the `/companion` entrypoint this file imports from, and reaching it through the package
|
|
351
|
+
// root would pull the frontend runtime graph into a config the companion parses statically —
|
|
352
|
+
// which is the coupling that entrypoint exists to prevent.
|
|
353
|
+
icon: 'brain',
|
|
354
|
+
label: 'Todo Assistant',
|
|
355
|
+
},
|
|
356
|
+
],
|
|
357
|
+
},
|
|
358
|
+
|
|
359
|
+
/**
|
|
360
|
+
* OFF, and that is an answer rather than an omission (#504). The activity bar selects `AppMode`s
|
|
361
|
+
* and this application declares none, so switching it on renders an empty rail — it would
|
|
362
|
+
* demonstrate the gap instead of the surface. It is switched on by the first application that
|
|
363
|
+
* declares more than one mode; the condition is recorded at the engine declaration too.
|
|
364
|
+
*/
|
|
309
365
|
[ApplicationLevelComponentType.ACTIVITY_BAR]: false,
|
|
310
|
-
[ApplicationLevelComponentType.UTILITY_PANEL]: false,
|
|
311
366
|
};
|
|
312
367
|
```
|
|
313
368
|
|
|
@@ -363,10 +418,12 @@ What earns its place:
|
|
|
363
418
|
`[ApplicationLevelComponentType.HOTKEY]: true` to the platform hotkey
|
|
364
419
|
provider, which is what makes `Cmd+K` reachable.
|
|
365
420
|
- `USER_DROPDOWN.sections: [UserDropdownSection.*, ...]` orders the
|
|
366
|
-
dropdown contents. `
|
|
367
|
-
dropdown
|
|
368
|
-
|
|
369
|
-
|
|
421
|
+
dropdown contents. `settingsEntries: ['profile', 'security']` surfaces
|
|
422
|
+
those Settings Hub sections inline in the dropdown, in that order; omit
|
|
423
|
+
it (or leave it empty) to render the single "Settings" button that opens
|
|
424
|
+
the hub at its default section. The refs name **settings-hub sections**,
|
|
425
|
+
the same vocabulary `settings-hub.config.ts` places — never sidebar
|
|
426
|
+
section refs. There is no separate enable flag: the list is the intent.
|
|
370
427
|
- Deferred surfaces (`ACTIVITY_BAR`, `UTILITY_PANEL`,
|
|
371
428
|
`CONTROL_PANEL`) are explicitly set to `false`. This is **not**
|
|
372
429
|
optional — explicit disable signals "we know this exists, we chose
|
|
@@ -613,11 +670,13 @@ What earns its place:
|
|
|
613
670
|
|
|
614
671
|
## References
|
|
615
672
|
|
|
673
|
+
- `references/framework-brand-identity-api.md` — `useBrandIdentity()` for any shell surface rendering the brand, and why a tool must declare `shellIdentity` or it shows its customer's brand as its own
|
|
616
674
|
- `references/app-shell-surfaces.md` — author-facing surface list
|
|
617
675
|
- `references/framework-app-shell-api.md` — engine app-level component vocabulary + configuration schema
|
|
618
676
|
- `references/framework-command-menu-omnibox-api.md` — command-menu policy (`CommandBarPolicy`) + omnibox `searchResources` (`CommandMenuSearchResource`) contract
|
|
619
677
|
- `references/framework-app-shell-hosted-components-api.md` — menubar/sidebar `hostedComponents` entry shape (`MenubarHostedComponent` / `SidebarHostedComponent`) + per-placement `triggerWidth`
|
|
620
678
|
- `references/framework-quick-switcher-scope-field-api.md` — `quickSwitcherFields` entry shape (`QuickSwitcherScopeField`), the two independent presentation axes (`optionDisplayMode` / `presentation`), and what a scope declaration wires for free
|
|
679
|
+
- `references/framework-public-shell-identity-api.md` — naming the application on its public/auth cards: where the field goes, and what actually renders for each brand state
|
|
621
680
|
|
|
622
681
|
## Verification
|
|
623
682
|
|
|
@@ -647,6 +706,7 @@ Run from the app root:
|
|
|
647
706
|
| Sidebar section refs are unique | `rg -oN "ref:\s+'\K[a-z-]+" frontend/src/config/app-shell.config.ts \| sort \| uniq -d` (must return empty) |
|
|
648
707
|
| Command menu has an `openShortcut` | `rg -n "openShortcut:" frontend/src/config/app-shell.config.ts` |
|
|
649
708
|
| Every `commands: []` entry resolves to a registered `commandId` | `rg -oN "commandId:\s+'\K[A-Z_.]+" frontend/src/config/app-shell.config.ts \| sort -u` then verify each appears in `frontend/src/commands/**/*.ts` (or the engine command registry) |
|
|
709
|
+
| `publicShellIdentityMode` is NOT in the shell config | `rg -n "publicShellIdentityMode" frontend/src/config/app-shell.config.ts` (must return empty; it belongs in `frontend/src/modules-registry.frontend.ts`) |
|
|
650
710
|
| `searchResources` implies `policy: OMNIBOX` | `rg -n "searchResources:" frontend/src/config/app-shell.config.ts` — if it matches, `rg -n "CommandBarPolicy.OMNIBOX" frontend/src/config/app-shell.config.ts` must also match |
|
|
651
711
|
| Module command items are typed launcher refs | `rg -n "kind:\s+LauncherItemTargetKind\." frontend/src/modules/*/app-shell.module.frontend.ts` (each `commandMenuItems` entry must be a typed `LauncherItemTargetKind`, never a string) |
|
|
652
712
|
| Hosted-component placement uses the typed enum | `rg -n "placement:\s+(Horizontal\|Vertical)Placement\." frontend/src/config/app-shell.config.ts` (every `hostedComponents` entry that sets `placement` must use `HorizontalPlacement.*` in the menubar / `VerticalPlacement.*` in the sidebar) |
|
|
@@ -677,6 +737,8 @@ spec or navigation that targets the section.
|
|
|
677
737
|
| "Add a clear button next to the switcher so users can deselect" | The control already renders a clear affordance inside its trigger whenever a value is selected. A sibling button reads as one more chrome icon in the cluster and names no owner. |
|
|
678
738
|
| "The scope field must exist on the resource schema" | It need not. With no matching schema field the framework falls back to the target resource's primary key — which is why the option-rendering mode is declared on the FIELD and cannot come from a `.foreignKeyUI(...)` decorator. |
|
|
679
739
|
| "`presentation: LABEL_ABOVE` will break the menubar's alignment" | The bar has no fixed height and centre-aligns its row: it grows to fit the tallest hosted control and shorter siblings re-centre. Pick `LABEL_ABOVE` when you want the label and accept a taller bar; `ICON_LED` when you want identity at one row height. |
|
|
740
|
+
| "`publicShellIdentityMode` is shell config, so it goes in `appShellConfig`." | It is not an `ApplicationLevelComponentType` key. Placed there it configures nothing and raises no error — those keys govern the AUTHENTICATED shell, which does not exist on a public page. It belongs in the `buildFrontendModuleConfigOverrides` call. |
|
|
741
|
+
| "We have no logo yet, so turning on the public identity would render a broken image." | The mode is a permission, not a promise. With no generated brand the card shows the name alone, and starts showing the mark by itself once one exists — nothing to revisit. |
|
|
680
742
|
|
|
681
743
|
## Red Flags
|
|
682
744
|
|
|
@@ -692,6 +754,7 @@ spec or navigation that targets the section.
|
|
|
692
754
|
- A scope field's `resourceType` given as a string literal — it bypasses typecheck and silently names no registered resource, so the picker loads no options (catch with the **Scope-field resource types are typed** grep — must return empty).
|
|
693
755
|
- `optionDisplayMode` / `presentation` given quoted strings instead of their enums (catch with the **Presentation axes use their typed enums** grep — every extracted value must be an enum member).
|
|
694
756
|
- A hand-rolled "clear scope" button authored beside the switcher — duplicates the affordance the control already renders inside its trigger (catch with the **No hand-rolled clear button** verification item; grep the app for a scope-clear handler).
|
|
757
|
+
- `publicShellIdentityMode` appearing inside `frontend/src/config/app-shell.config.ts` — catch with the public-identity grep below
|
|
695
758
|
|
|
696
759
|
## Related Skills
|
|
697
760
|
|