@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,136 @@
|
|
|
1
|
+
# application-documentation-plan.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* WHICH CHAPTERS this application's documentation portal carries, what each documents, and who it is
|
|
14
|
+
* for (#1494) — half of the accepted authoring artifact the documentation publication reads.
|
|
15
|
+
*
|
|
16
|
+
* ## The gap it closes
|
|
17
|
+
*
|
|
18
|
+
* Until #874 the documentation derivation ended its contract by saying application content stayed
|
|
19
|
+
* absent until the app-creator owned an accepted authoring artifact: resource-derived domain guides
|
|
20
|
+
* existed, and an authored cross-resource guide had no accepted input into managed publication.
|
|
21
|
+
* This family is half of that input: a specification
|
|
22
|
+
* FILE in the application's own package, accepted by being committed, that owns each chapter's
|
|
23
|
+
* IDENTITY — ref, title, kind, audiences. The other half is the chapter BODY, authored in
|
|
24
|
+
* `specifications/src/technical-documentation/index.ts` (`application-documentation-chapters.schemas.ts`)
|
|
25
|
+
* and joined to this plan by `chapterRef`; the publication withholds, and reports, a body no chapter
|
|
26
|
+
* here declares.
|
|
27
|
+
*
|
|
28
|
+
* ## Why it lives HERE and not in `_core`
|
|
29
|
+
*
|
|
30
|
+
* A chapter is typed by the documentation engine's OWN vocabularies — `TechnicalDocumentationUnitKind`,
|
|
31
|
+
* `TechnicalDocumentationReaderAudience`, `TechnicalDocumentationAccessClass` — and those are
|
|
32
|
+
* published behind the `/technical-documentation` door. Declaring a second vocabulary in `_core` to
|
|
33
|
+
* avoid the dependency would be the same concept spelled twice, which is the trick this repository
|
|
34
|
+
* refuses; importing them INTO a root-exported `_core` family would put a nominal enum from a
|
|
35
|
+
* subpath-only surface into the root's closure, which `package-public-entrypoints.md` rule 7 exists
|
|
36
|
+
* to catch. So the family sits beside the vocabulary it is typed by — exactly where the risk register
|
|
37
|
+
* sits beside the assurance vocabulary, for the same reason.
|
|
38
|
+
*
|
|
39
|
+
* ## What it is NOT
|
|
40
|
+
*
|
|
41
|
+
* It is not the documentation the portal PUBLISHES. The companion derives units, applies the
|
|
42
|
+
* publication policy and writes the generated tree; no task may write there. This decides what the
|
|
43
|
+
* application OWES its readers, from what its own specifications already say.
|
|
44
|
+
*/
|
|
45
|
+
export enum ApplicationDocumentationPlanVersion {
|
|
46
|
+
V1 = 'v1',
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Stable prefix every planned chapter ref carries; the trusted runtime stamps it, a provider supplies only the slug. */
|
|
50
|
+
export const DOCUMENTATION_CHAPTER_REF_PREFIX = 'chapter-';
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* WHETHER this application publishes a documentation portal at all.
|
|
54
|
+
*
|
|
55
|
+
* Representable rather than refused, exactly as the website plan's is: the capability composition
|
|
56
|
+
* decides whether `add-technical-doc` is applied, and an application that declines it must still be
|
|
57
|
+
* able to RECORD that. A plan producible only for a portal that exists would make "no portal" an
|
|
58
|
+
* absence nobody can read.
|
|
59
|
+
*/
|
|
60
|
+
export enum ApplicationDocumentationPlanDisposition {
|
|
61
|
+
PLANNED = 'PLANNED',
|
|
62
|
+
NOT_APPLICABLE = 'NOT_APPLICABLE',
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
const SlugSchema = z.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/);
|
|
66
|
+
const NonEmptyStringSchema = z.string().trim().min(1);
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* One authored chapter. Its `kind`, `readerAudiences` and `accessClass` are the DOCUMENTATION
|
|
70
|
+
* ENGINE's own vocabularies, so a landed plan speaks the language the derivation already consumes
|
|
71
|
+
* rather than one this family invented for itself.
|
|
72
|
+
*/
|
|
73
|
+
export const ApplicationDocumentationChapterPlanSchema = z.strictObject({
|
|
74
|
+
/** `chapter-<slug>`, stamped by the trusted runtime; the build task's product names it. */
|
|
75
|
+
chapterRef: z.string().regex(new RegExp(`^${DOCUMENTATION_CHAPTER_REF_PREFIX}[a-z0-9]+(?:-[a-z0-9]+)*$`)),
|
|
76
|
+
title: NonEmptyStringSchema,
|
|
77
|
+
kind: z.enum(TechnicalDocumentationUnitKind),
|
|
78
|
+
/**
|
|
79
|
+
* Who this chapter is written for. At least one: a chapter addressed to nobody is one the
|
|
80
|
+
* publication policy cannot route, and the engine's own unit schema refuses an empty audience set.
|
|
81
|
+
*/
|
|
82
|
+
readerAudiences: z.array(z.enum(TechnicalDocumentationReaderAudience)).min(1),
|
|
83
|
+
/*
|
|
84
|
+
* NO `accessClass`, deliberately. The engine's `TechnicalDocumentationAccessClass` has exactly one
|
|
85
|
+
* member today, so a chapter declaring it would decide nothing — a field carrying no semantic
|
|
86
|
+
* weight, which this framework's own mindset refuses. Who may READ a unit is the publication
|
|
87
|
+
* policy's decision, and it is made against the derived unit rather than against this plan; the
|
|
88
|
+
* audiences above are what this plan legitimately knows.
|
|
89
|
+
*/
|
|
90
|
+
/** What a reader can do after reading it that they could not before. */
|
|
91
|
+
purpose: NonEmptyStringSchema,
|
|
92
|
+
/**
|
|
93
|
+
* What in the application's OWN specifications this chapter documents — resource, operation, role
|
|
94
|
+
* or governed-document refs, as those specifications authored them.
|
|
95
|
+
*
|
|
96
|
+
* At least one, and it is the field that keeps a chapter honest: the authoring skill forbids
|
|
97
|
+
* inventing a local source, so a chapter grounded in nothing is a chapter a coding agent would
|
|
98
|
+
* have to invent. A reader checks each ref against the specification that declares it.
|
|
99
|
+
*/
|
|
100
|
+
derivedFromRefs: z.array(NonEmptyStringSchema).min(1),
|
|
101
|
+
});
|
|
102
|
+
export type ApplicationDocumentationChapterPlan = z.infer<typeof ApplicationDocumentationChapterPlanSchema>;
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* THE documentation-plan payload.
|
|
106
|
+
*
|
|
107
|
+
* **Artifact-family id: `documentation-plan`.** Produced by `bottom_up.documentation-plan`, consumed
|
|
108
|
+
* by `bottom_up.build-decompose` (one `DOCUMENTATION_CHAPTER` task per chapter, which authors that
|
|
109
|
+
* chapter's body) and by the documentation publication, which takes each published chapter's title,
|
|
110
|
+
* kind and audiences from here.
|
|
111
|
+
*/
|
|
112
|
+
export const ApplicationDocumentationPlanSchema = z.object({
|
|
113
|
+
version: z.enum(ApplicationDocumentationPlanVersion).default(ApplicationDocumentationPlanVersion.V1),
|
|
114
|
+
disposition: z.enum(ApplicationDocumentationPlanDisposition),
|
|
115
|
+
/** Why this application publishes documentation and for whom — or why it publishes none. */
|
|
116
|
+
rationale: NonEmptyStringSchema,
|
|
117
|
+
chapters: z.array(ApplicationDocumentationChapterPlanSchema).default([]),
|
|
118
|
+
}).superRefine((plan, context) => {
|
|
119
|
+
// Both directions, as on the website plan: a declined portal carrying chapters would be applied
|
|
120
|
+
// against a `technical-doc/` workspace nothing composed, and a planned one with none is vacuity.
|
|
121
|
+
if (plan.disposition === ApplicationDocumentationPlanDisposition.NOT_APPLICABLE && plan.chapters.length > 0) {
|
|
122
|
+
context.addIssue({ code: 'custom', message: 'a NOT_APPLICABLE documentation plan cannot carry chapters; the application publishes no portal to put them in', path: ['chapters'] });
|
|
123
|
+
}
|
|
124
|
+
if (plan.disposition === ApplicationDocumentationPlanDisposition.PLANNED && plan.chapters.length === 0) {
|
|
125
|
+
context.addIssue({ code: 'custom', message: 'a PLANNED documentation plan must carry at least one chapter; planning none is a refusal, not a plan', path: ['chapters'] });
|
|
126
|
+
}
|
|
127
|
+
const chapterRefs = new Set<string>();
|
|
128
|
+
plan.chapters.forEach((chapter, index) => {
|
|
129
|
+
if (chapterRefs.has(chapter.chapterRef)) {
|
|
130
|
+
context.addIssue({ code: 'custom', message: `duplicate chapter ref ${chapter.chapterRef}`, path: ['chapters', index, 'chapterRef'] });
|
|
131
|
+
}
|
|
132
|
+
chapterRefs.add(chapter.chapterRef);
|
|
133
|
+
});
|
|
134
|
+
});
|
|
135
|
+
export type ApplicationDocumentationPlan = z.infer<typeof ApplicationDocumentationPlanSchema>;
|
|
136
|
+
```
|
|
@@ -0,0 +1,319 @@
|
|
|
1
|
+
# application-maturity.config
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* WHERE THIS APPLICATION STANDS against what it asked of itself (#1496) — one row per requirement,
|
|
14
|
+
* with the evidence that exists for it, and the stage that follows.
|
|
15
|
+
*
|
|
16
|
+
* ## There is no "done", and that is the whole design
|
|
17
|
+
*
|
|
18
|
+
* Paul, 2026-09-22: *"there are no 'Done' for an app, there are a measurement face to requirements,
|
|
19
|
+
* with some stage (thresholds, or maybe more complex calculation) face to where we are in the
|
|
20
|
+
* maturity. this measurement should be evolutive."*
|
|
21
|
+
*
|
|
22
|
+
* So this family is a READING, never a gate. Nothing in the creation lane may refuse because of it,
|
|
23
|
+
* and no stage means "finished": the highest stage says only that every requirement currently has
|
|
24
|
+
* the strongest evidence this framework can produce for it, which the next requirement lowers again.
|
|
25
|
+
*
|
|
26
|
+
* ## The denominator is the application's OWN requirements, and nothing else
|
|
27
|
+
*
|
|
28
|
+
* Every row here comes from the `requirements` family. Not a list authored beside it, not a count of
|
|
29
|
+
* files, not a share of build tasks — `derive-before-you-ask.md` shape 2 is exactly the defect of
|
|
30
|
+
* measuring against a population you chose yourself, and it has already cost this repository two
|
|
31
|
+
* false findings. A requirement added tomorrow appears here as `UNADDRESSED` and lowers the reading
|
|
32
|
+
* with no code change; that is the acceptance this family was asked for.
|
|
33
|
+
*
|
|
34
|
+
* ## Evolutive by construction
|
|
35
|
+
*
|
|
36
|
+
* Two things are DECLARATIONS rather than code paths: the evidence LADDER (what counts as stronger
|
|
37
|
+
* evidence) and the THRESHOLDS (what share at which level reaches a stage). The reading carries the
|
|
38
|
+
* thresholds it was computed against, so a later pass that scores differently shows up as a diff of
|
|
39
|
+
* the declaration rather than as a silent change of meaning.
|
|
40
|
+
*/
|
|
41
|
+
export enum ApplicationMaturityVersion {
|
|
42
|
+
V1 = 'v1',
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
* How strong the evidence for ONE requirement is — ORDERED, weakest first, and the order is the
|
|
47
|
+
* meaning: every comparison here is "at or above", so inserting a level between two existing ones
|
|
48
|
+
* changes the ladder rather than the code that walks it.
|
|
49
|
+
*
|
|
50
|
+
* A level names the STRONGEST evidence a requirement has, and nothing more. It is deliberately NOT
|
|
51
|
+
* a claim that the weaker evidence exists too: an observation of the running application is evidence
|
|
52
|
+
* about the PRODUCT, and a requirement somebody exercised but nobody planned a task for is a real
|
|
53
|
+
* state — under-reporting it because no decided element points at it would hide the strongest
|
|
54
|
+
* evidence this framework can produce. What every level above `UNADDRESSED` does guarantee is that
|
|
55
|
+
* SOME evidence exists, which is what `UNADDRESSED` means the absence of.
|
|
56
|
+
*
|
|
57
|
+
* Each level is reached by a MEASUREMENT, never by an assertion:
|
|
58
|
+
*
|
|
59
|
+
* - `UNADDRESSED` — nothing the application decided points at it. Not a failure: an early run has
|
|
60
|
+
* every requirement here, which is what makes the reading move.
|
|
61
|
+
* - `DECIDED` — a decided element links to it: a feature draft, an experience surface, a worker, a
|
|
62
|
+
* build task. Read from the decided-aspect graph's inbound links, so a family that declares an
|
|
63
|
+
* edge to a requirement tomorrow contributes here without this module knowing it exists.
|
|
64
|
+
* - `BUILT` — a BUILD TASK that links to it has landed, judged by the landing probe over committed
|
|
65
|
+
* bytes rather than by any status somebody wrote down.
|
|
66
|
+
* - `VERIFIED` — that landed task's declared product was PROVEN: the probe found what the task said
|
|
67
|
+
* it would produce. A task that landed and could not be proven stops at `BUILT`, deliberately.
|
|
68
|
+
* - `OBSERVED` — something watched the running application do it: a browser drive, a served page, a
|
|
69
|
+
* boot. The strongest evidence this framework can produce, and see
|
|
70
|
+
* {@link ApplicationMaturityFindingCode.NO_RUNTIME_OBSERVATION_SOURCE} for what supplies it.
|
|
71
|
+
* Reachable without any of the levels below, by the paragraph above.
|
|
72
|
+
*/
|
|
73
|
+
export enum RequirementEvidenceLevel {
|
|
74
|
+
UNADDRESSED = 'UNADDRESSED',
|
|
75
|
+
DECIDED = 'DECIDED',
|
|
76
|
+
BUILT = 'BUILT',
|
|
77
|
+
VERIFIED = 'VERIFIED',
|
|
78
|
+
OBSERVED = 'OBSERVED',
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* Each level's RANK — the one place the ordering lives, and a `Record` rather than an array so a
|
|
83
|
+
* level added to the vocabulary tomorrow does not compile until somebody places it on the ladder.
|
|
84
|
+
*
|
|
85
|
+
* An array was the first shape and was wrong in the dangerous direction: an unplaced level made
|
|
86
|
+
* `indexOf` return `-1`, so `isEvidenceAtOrAbove(anything, theNewLevel)` answered TRUE and every
|
|
87
|
+
* row silently passed a threshold declared at it. A total map cannot reach that state.
|
|
88
|
+
*/
|
|
89
|
+
const REQUIREMENT_EVIDENCE_RANK: Readonly<Record<RequirementEvidenceLevel, number>> = {
|
|
90
|
+
[RequirementEvidenceLevel.UNADDRESSED]: 0,
|
|
91
|
+
[RequirementEvidenceLevel.DECIDED]: 1,
|
|
92
|
+
[RequirementEvidenceLevel.BUILT]: 2,
|
|
93
|
+
[RequirementEvidenceLevel.VERIFIED]: 3,
|
|
94
|
+
[RequirementEvidenceLevel.OBSERVED]: 4,
|
|
95
|
+
};
|
|
96
|
+
|
|
97
|
+
/** The ladder in order, weakest first — derived from the ranks, so the two cannot disagree. */
|
|
98
|
+
export const REQUIREMENT_EVIDENCE_LADDER: readonly RequirementEvidenceLevel[] =
|
|
99
|
+
(Object.keys(REQUIREMENT_EVIDENCE_RANK) as RequirementEvidenceLevel[]).sort((a, b) => REQUIREMENT_EVIDENCE_RANK[a] - REQUIREMENT_EVIDENCE_RANK[b]);
|
|
100
|
+
|
|
101
|
+
/** True when `level` is at least as strong as `atLeast` — the only comparison this family makes. */
|
|
102
|
+
export function isEvidenceAtOrAbove(level: RequirementEvidenceLevel, atLeast: RequirementEvidenceLevel): boolean {
|
|
103
|
+
return REQUIREMENT_EVIDENCE_RANK[level] >= REQUIREMENT_EVIDENCE_RANK[atLeast];
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/**
|
|
107
|
+
* Where the APPLICATION stands — the stage its weakest-covered requirements put it at.
|
|
108
|
+
*
|
|
109
|
+
* `NOT_MEASURABLE` is a stage rather than an absent reading, because an application with no landed
|
|
110
|
+
* requirements has a true answer and it is not "stage zero": nothing has been asked of it yet, so
|
|
111
|
+
* there is nothing to measure. Making that representable is what stops a reader inferring
|
|
112
|
+
* "measured, and bad" from an empty file (`application-creation-directive.md`).
|
|
113
|
+
*/
|
|
114
|
+
export enum ApplicationMaturityStage {
|
|
115
|
+
NOT_MEASURABLE = 'NOT_MEASURABLE',
|
|
116
|
+
SPECIFIED = 'SPECIFIED',
|
|
117
|
+
DECIDED = 'DECIDED',
|
|
118
|
+
BUILT = 'BUILT',
|
|
119
|
+
VERIFIED = 'VERIFIED',
|
|
120
|
+
OBSERVED = 'OBSERVED',
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
/** Which half of the requirements family a row came from — the two are counted together and read apart. */
|
|
124
|
+
export enum RequirementFamilyHalf {
|
|
125
|
+
FUNCTIONAL = 'FUNCTIONAL',
|
|
126
|
+
NON_FUNCTIONAL = 'NON_FUNCTIONAL',
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/**
|
|
130
|
+
* A FACTORY rather than a shared constant, and the difference is visible on screen.
|
|
131
|
+
*
|
|
132
|
+
* A UI decorator mutates the instance it is applied to. When one instance served both the reading's
|
|
133
|
+
* `summary` and every row's `requirementRef`, the workbench gave the key its receding identifier
|
|
134
|
+
* treatment and so gave it to the summary as well: the one sentence the reading exists to say
|
|
135
|
+
* rendered as a slug with no field chrome (measured 2026-09-24). One instance per field keeps a
|
|
136
|
+
* display decision about one field from reaching another.
|
|
137
|
+
*/
|
|
138
|
+
function nonEmptyString(): z.ZodString {
|
|
139
|
+
return z.string().trim().min(1);
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* One stage's admission test: the SHARE of requirements that must sit at or above a level.
|
|
144
|
+
*
|
|
145
|
+
* A declaration rather than a branch, so a richer calculation — per-kind weights, a different level
|
|
146
|
+
* per half, a score — arrives as a different declaration and the walk stays the same.
|
|
147
|
+
*/
|
|
148
|
+
export const ApplicationMaturityStageThresholdSchema = z.strictObject({
|
|
149
|
+
stage: z.enum(ApplicationMaturityStage).systemEnum('ApplicationMaturityStage'),
|
|
150
|
+
/** The evidence level the share is measured at. */
|
|
151
|
+
atLeast: z.enum(RequirementEvidenceLevel).systemEnum('RequirementEvidenceLevel'),
|
|
152
|
+
/** The share of requirements that must reach it, 0–1 inclusive. */
|
|
153
|
+
minimumShare: z.number().min(0).max(1),
|
|
154
|
+
});
|
|
155
|
+
export type ApplicationMaturityStageThreshold = z.infer<typeof ApplicationMaturityStageThresholdSchema>;
|
|
156
|
+
|
|
157
|
+
/**
|
|
158
|
+
* The DEFAULT ladder thresholds: every requirement, at that level. One number, and it is not a guess.
|
|
159
|
+
*
|
|
160
|
+
* A share below 1 would be an invented tolerance — "eighty per cent built is BUILT" is a judgement
|
|
161
|
+
* nobody has made, and this family exists to measure rather than to flatter. An application that
|
|
162
|
+
* wants a softer bar declares one, and the reading carries what it was computed against, so the
|
|
163
|
+
* softening is a visible decision rather than a number buried in a function.
|
|
164
|
+
*
|
|
165
|
+
* `SPECIFIED` and `NOT_MEASURABLE` carry no threshold: the first is reached by having requirements
|
|
166
|
+
* at all, the second by having none.
|
|
167
|
+
*/
|
|
168
|
+
export const DEFAULT_APPLICATION_MATURITY_THRESHOLDS: readonly ApplicationMaturityStageThreshold[] = [
|
|
169
|
+
{ stage: ApplicationMaturityStage.DECIDED, atLeast: RequirementEvidenceLevel.DECIDED, minimumShare: 1 },
|
|
170
|
+
{ stage: ApplicationMaturityStage.BUILT, atLeast: RequirementEvidenceLevel.BUILT, minimumShare: 1 },
|
|
171
|
+
{ stage: ApplicationMaturityStage.VERIFIED, atLeast: RequirementEvidenceLevel.VERIFIED, minimumShare: 1 },
|
|
172
|
+
{ stage: ApplicationMaturityStage.OBSERVED, atLeast: RequirementEvidenceLevel.OBSERVED, minimumShare: 1 },
|
|
173
|
+
];
|
|
174
|
+
|
|
175
|
+
/**
|
|
176
|
+
* The stage a set of rows reaches under a threshold declaration — the highest stage whose share is met.
|
|
177
|
+
*
|
|
178
|
+
* It lives in the SCHEMA file, beside the shape it scores, because the schema itself refuses a
|
|
179
|
+
* reading whose stored `stage` is not the one its rows support: putting the walk in the validator
|
|
180
|
+
* would make the schema import the validator that imports the schema, and a stage nothing checks is
|
|
181
|
+
* the single field of this family a reader cannot verify by looking.
|
|
182
|
+
*/
|
|
183
|
+
export function resolveApplicationMaturityStage(reading: Pick<ApplicationMaturity, 'requirements' | 'thresholds'>): ApplicationMaturityStage {
|
|
184
|
+
if (reading.requirements.length === 0) return ApplicationMaturityStage.NOT_MEASURABLE;
|
|
185
|
+
let stage = ApplicationMaturityStage.SPECIFIED;
|
|
186
|
+
/*
|
|
187
|
+
* Walked in LADDER order rather than in declaration order: a threshold list is data an author may
|
|
188
|
+
* write in any order, and a stage reached out of order would let a gap below it pass unnoticed.
|
|
189
|
+
*/
|
|
190
|
+
for (const candidate of [ApplicationMaturityStage.DECIDED, ApplicationMaturityStage.BUILT, ApplicationMaturityStage.VERIFIED, ApplicationMaturityStage.OBSERVED]) {
|
|
191
|
+
const threshold = reading.thresholds.find((entry) => entry.stage === candidate);
|
|
192
|
+
if (threshold === undefined) break;
|
|
193
|
+
const met = reading.requirements.filter((row) => isEvidenceAtOrAbove(row.level, threshold.atLeast)).length;
|
|
194
|
+
if (met / reading.requirements.length < threshold.minimumShare) break;
|
|
195
|
+
stage = candidate;
|
|
196
|
+
}
|
|
197
|
+
return stage;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** One requirement, and what exists for it. */
|
|
201
|
+
export const RequirementMaturityRowSchema = z.strictObject({
|
|
202
|
+
/** The `requirements` family's own ref — the join, and the reason nothing here restates a statement. */
|
|
203
|
+
requirementRef: nonEmptyString(),
|
|
204
|
+
half: z.enum(RequirementFamilyHalf).systemEnum('RequirementFamilyHalf'),
|
|
205
|
+
level: z.enum(RequirementEvidenceLevel).systemEnum('RequirementEvidenceLevel'),
|
|
206
|
+
/**
|
|
207
|
+
* The decided elements that point at this requirement, by their own refs — a feature draft, an
|
|
208
|
+
* experience surface, a worker, a build task.
|
|
209
|
+
*
|
|
210
|
+
* Empty whenever the level is `UNADDRESSED`, and NOT the other way round: a requirement carrying
|
|
211
|
+
* only a runtime observation is `OBSERVED` with nothing addressing it, which is a true reading of
|
|
212
|
+
* a product somebody exercised without anyone planning the work. The refusal below is therefore
|
|
213
|
+
* one-directional on purpose.
|
|
214
|
+
*/
|
|
215
|
+
addressedByRefs: z.array(nonEmptyString()).default([]),
|
|
216
|
+
/** The build tasks addressing it that have LANDED. */
|
|
217
|
+
landedTaskRefs: z.array(nonEmptyString()).default([]),
|
|
218
|
+
/** The landed tasks among those whose declared product was PROVEN. A subset of `landedTaskRefs`. */
|
|
219
|
+
provenTaskRefs: z.array(nonEmptyString()).default([]),
|
|
220
|
+
/** Runtime observations naming this requirement, by their own refs. */
|
|
221
|
+
observationRefs: z.array(nonEmptyString()).default([]),
|
|
222
|
+
});
|
|
223
|
+
export type RequirementMaturityRow = z.infer<typeof RequirementMaturityRowSchema>;
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* THE application-maturity payload.
|
|
227
|
+
*
|
|
228
|
+
* **Artifact-family id: `application-maturity`.** DERIVED — `deriveApplicationMaturity` is a pure
|
|
229
|
+
* function of the requirements, the decided-element graph, the build plan's landing probe and the
|
|
230
|
+
* runtime observations. Nothing generates it, for the same reason the capability composition is not
|
|
231
|
+
* generated: a model asked where an application stands would answer, and the answer would be
|
|
232
|
+
* unfalsifiable.
|
|
233
|
+
*/
|
|
234
|
+
export const ApplicationMaturitySchema = z.object({
|
|
235
|
+
version: z.enum(ApplicationMaturityVersion).default(ApplicationMaturityVersion.V1),
|
|
236
|
+
stage: z.enum(ApplicationMaturityStage).systemEnum('ApplicationMaturityStage'),
|
|
237
|
+
/** The reading in one sentence, naming the counts that decided the stage. */
|
|
238
|
+
summary: nonEmptyString(),
|
|
239
|
+
/**
|
|
240
|
+
* The thresholds this reading was computed against — carried, so a later softening is a diff.
|
|
241
|
+
*
|
|
242
|
+
* At least one, and CONTIGUOUS from `DECIDED` upward (see the refusal below): the walk stops at
|
|
243
|
+
* the first stage with no threshold, so a set that skipped `DECIDED` and declared `VERIFIED`
|
|
244
|
+
* would floor every application at `SPECIFIED` however strong its evidence — silently, because a
|
|
245
|
+
* gap and a failed bar are the same `break`. Declaring only a prefix is legitimate and common
|
|
246
|
+
* ("we only score up to BUILT"); declaring a hole is not.
|
|
247
|
+
*/
|
|
248
|
+
thresholds: z.array(ApplicationMaturityStageThresholdSchema).min(1).default([...DEFAULT_APPLICATION_MATURITY_THRESHOLDS]),
|
|
249
|
+
/** One row per requirement the application declares. TOTAL over the family; never a selection. */
|
|
250
|
+
requirements: z.array(RequirementMaturityRowSchema).default([]),
|
|
251
|
+
}).superRefine((reading, context) => {
|
|
252
|
+
const seen = new Set<string>();
|
|
253
|
+
reading.requirements.forEach((row, index) => {
|
|
254
|
+
if (seen.has(row.requirementRef)) {
|
|
255
|
+
context.addIssue({ code: 'custom', message: `requirement ${row.requirementRef} is measured twice`, path: ['requirements', index, 'requirementRef'] });
|
|
256
|
+
}
|
|
257
|
+
seen.add(row.requirementRef);
|
|
258
|
+
/*
|
|
259
|
+
* The row's own coherence, refused rather than reported: a proven task that is not among the
|
|
260
|
+
* landed ones is a reading that contradicts itself, and a reader cannot tell which half to
|
|
261
|
+
* believe. The SOFT cases — a requirement nothing addresses, a level nothing can reach — are
|
|
262
|
+
* findings, because those describe the application rather than the reading.
|
|
263
|
+
*/
|
|
264
|
+
for (const provenTaskRef of row.provenTaskRefs) {
|
|
265
|
+
if (!row.landedTaskRefs.includes(provenTaskRef)) {
|
|
266
|
+
context.addIssue({ code: 'custom', message: `task ${provenTaskRef} is proven for ${row.requirementRef} without being landed`, path: ['requirements', index, 'provenTaskRefs'] });
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
if (row.level === RequirementEvidenceLevel.UNADDRESSED && row.addressedByRefs.length > 0) {
|
|
270
|
+
context.addIssue({ code: 'custom', message: `${row.requirementRef} is UNADDRESSED and names ${row.addressedByRefs.length} element(s) addressing it`, path: ['requirements', index, 'level'] });
|
|
271
|
+
}
|
|
272
|
+
});
|
|
273
|
+
const stages = new Set<ApplicationMaturityStage>();
|
|
274
|
+
reading.thresholds.forEach((threshold, index) => {
|
|
275
|
+
if (stages.has(threshold.stage)) {
|
|
276
|
+
context.addIssue({ code: 'custom', message: `stage ${threshold.stage} carries two thresholds`, path: ['thresholds', index, 'stage'] });
|
|
277
|
+
}
|
|
278
|
+
stages.add(threshold.stage);
|
|
279
|
+
if (threshold.stage === ApplicationMaturityStage.NOT_MEASURABLE || threshold.stage === ApplicationMaturityStage.SPECIFIED) {
|
|
280
|
+
/*
|
|
281
|
+
* Neither is reachable by a threshold — one means "no requirements", the other "some, and no
|
|
282
|
+
* bar met" — so a threshold on them was silently inert. Refused rather than ignored: an inert
|
|
283
|
+
* declaration reads as a decision somebody made.
|
|
284
|
+
*/
|
|
285
|
+
context.addIssue({ code: 'custom', message: `${threshold.stage} is not reached by a threshold: it is what an application falls back to`, path: ['thresholds', index, 'stage'] });
|
|
286
|
+
}
|
|
287
|
+
});
|
|
288
|
+
/* CONTIGUITY, for the reason on the field above: a hole floors the reading and says nothing. */
|
|
289
|
+
const scored = [ApplicationMaturityStage.DECIDED, ApplicationMaturityStage.BUILT, ApplicationMaturityStage.VERIFIED, ApplicationMaturityStage.OBSERVED];
|
|
290
|
+
const highest = scored.reduce((last, stage, index) => (stages.has(stage) ? index : last), -1);
|
|
291
|
+
for (let index = 0; index <= highest; index += 1) {
|
|
292
|
+
if (!stages.has(scored[index]!)) {
|
|
293
|
+
context.addIssue({
|
|
294
|
+
code: 'custom',
|
|
295
|
+
message: `the threshold set declares ${scored[highest]!} and skips ${scored[index]!} — the walk stops at the gap, so every stage above it is unreachable`,
|
|
296
|
+
path: ['thresholds'],
|
|
297
|
+
});
|
|
298
|
+
}
|
|
299
|
+
}
|
|
300
|
+
/*
|
|
301
|
+
* THE STAGE MUST BE THE ONE ITS OWN ROWS AND THRESHOLDS PRODUCE.
|
|
302
|
+
*
|
|
303
|
+
* The reading is landed as a file and read by the workbench, the creation home and any later
|
|
304
|
+
* pass; a `stage` that disagrees with the rows beside it is the one thing a reader cannot detect,
|
|
305
|
+
* because the stage is the part they read. This is the same refusal as the proven-without-landed
|
|
306
|
+
* one above — a reading that contradicts itself fails closed — and it is a refusal of the
|
|
307
|
+
* ARTIFACT, never of the lane, so it is not a gate on anything.
|
|
308
|
+
*/
|
|
309
|
+
const supported = resolveApplicationMaturityStage({ requirements: reading.requirements, thresholds: reading.thresholds });
|
|
310
|
+
if (reading.stage !== supported) {
|
|
311
|
+
context.addIssue({
|
|
312
|
+
code: 'custom',
|
|
313
|
+
message: `stage ${reading.stage} is not what these ${reading.requirements.length} row(s) and thresholds support (${supported})`,
|
|
314
|
+
path: ['stage'],
|
|
315
|
+
});
|
|
316
|
+
}
|
|
317
|
+
});
|
|
318
|
+
export type ApplicationMaturity = z.infer<typeof ApplicationMaturitySchema>;
|
|
319
|
+
```
|
|
@@ -70,7 +70,7 @@ export const AssertionAuthoredMetadataSchema = z.object({
|
|
|
70
70
|
* `lastAuthoredAt + cadence < now`. When omitted, no staleness
|
|
71
71
|
* check runs (same semantics as the market family).
|
|
72
72
|
*/
|
|
73
|
-
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
73
|
+
reviewCadence: z.enum(ReviewCadence).systemEnum('ReviewCadence').optional(),
|
|
74
74
|
/** Owner accountable for the assertion's content. Free-form name/handle. */
|
|
75
75
|
reviewer: NonEmptyStringSchema.optional(),
|
|
76
76
|
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
@@ -177,7 +177,7 @@ export const AssertionSpecificationConfigSchema = z.object({
|
|
|
177
177
|
* `AuthoredConfidence` vocabulary (LOW / MEDIUM / HIGH) from the
|
|
178
178
|
* authored-metadata pattern.
|
|
179
179
|
*/
|
|
180
|
-
confidence: z.enum(AuthoredConfidence),
|
|
180
|
+
confidence: z.enum(AuthoredConfidence).systemEnum('AuthoredConfidence'),
|
|
181
181
|
/**
|
|
182
182
|
* Prose describing what breaks if the assertion turns out false
|
|
183
183
|
* (e.g. "choreographer AND labelling break together"). Prose over a
|
|
@@ -56,11 +56,10 @@
|
|
|
56
56
|
* fact and `purpose` is a CONSUMPTION fact: they coincide for `MASTER` in
|
|
57
57
|
* the normal pipeline, but a brand whose derivation degraded ships its
|
|
58
58
|
* generated primary AT `PRIMARY`, so the two must not be conflated.
|
|
59
|
-
* - **`generatedAt`**
|
|
60
|
-
*
|
|
61
|
-
* regeneration
|
|
62
|
-
*
|
|
63
|
-
* the i18n-labelling step).
|
|
59
|
+
* - **`generatedAt`** — when it was produced. The validator flags assets
|
|
60
|
+
* older than a re-authored direction from this timestamp (`STALE_ASSETS`).
|
|
61
|
+
* Skipping regeneration is the companion's own throwaway-staging concern
|
|
62
|
+
* and records nothing on the committed asset.
|
|
64
63
|
*/
|
|
65
64
|
export enum BrandAssetComposition {
|
|
66
65
|
/** The symbol/icon alone — square-ish; favicons, app icons, sidebar rail. */
|
|
@@ -134,15 +133,15 @@ export const BrandAssetConfigSchema = z.object({
|
|
|
134
133
|
/** Stable kebab-case identity, unique within `resolvedAssets`. `derivedFrom` addresses it. */
|
|
135
134
|
ref: NonEmptyStringSchema,
|
|
136
135
|
/** The FORM axis — symbol, wordmark, or locked-up. */
|
|
137
|
-
composition: z.enum(BrandAssetComposition),
|
|
136
|
+
composition: z.enum(BrandAssetComposition).systemEnum('BrandAssetComposition'),
|
|
138
137
|
/** The color-context axis. Defaults to the intended full-color mark. */
|
|
139
|
-
theme: z.enum(BrandAssetTheme).default(BrandAssetTheme.DEFAULT),
|
|
138
|
+
theme: z.enum(BrandAssetTheme).systemEnum('BrandAssetTheme').default(BrandAssetTheme.DEFAULT),
|
|
140
139
|
/** The technical consumption axis. Defaults to the base DISPLAY form, never the `MASTER` source. */
|
|
141
|
-
purpose: z.enum(BrandAssetPurpose).default(BrandAssetPurpose.PRIMARY),
|
|
140
|
+
purpose: z.enum(BrandAssetPurpose).systemEnum('BrandAssetPurpose').default(BrandAssetPurpose.PRIMARY),
|
|
142
141
|
/** `APPLICATION`-scoped stored-file reference (never a loose CDN URL). */
|
|
143
142
|
storageRef: NonEmptyStringSchema,
|
|
144
143
|
/** Concrete file format. */
|
|
145
|
-
format: z.enum(BrandAssetFormat),
|
|
144
|
+
format: z.enum(BrandAssetFormat).systemEnum('BrandAssetFormat'),
|
|
146
145
|
/** Pixel width (undefined for scalable SVG). */
|
|
147
146
|
width: z.number().int().positive().optional(),
|
|
148
147
|
/** Pixel height (undefined for scalable SVG). */
|
|
@@ -155,13 +154,6 @@ export const BrandAssetConfigSchema = z.object({
|
|
|
155
154
|
derivedFrom: NonEmptyStringSchema.optional(),
|
|
156
155
|
/** ISO-8601 timestamp the asset was produced. */
|
|
157
156
|
generatedAt: z.iso.datetime(),
|
|
158
|
-
/**
|
|
159
|
-
* Stable digest of the generation inputs (brand direction + tone +
|
|
160
|
-
* enrichment). Lets the companion skip regeneration when nothing
|
|
161
|
-
* upstream changed, and lets the validator flag assets older than a
|
|
162
|
-
* re-authored direction — freshness-lock parity with i18n-labelling.
|
|
163
|
-
*/
|
|
164
|
-
promptDigest: NonEmptyStringSchema.optional(),
|
|
165
157
|
});
|
|
166
158
|
export type BrandAssetConfig = z.infer<typeof BrandAssetConfigSchema>;
|
|
167
159
|
```
|
|
@@ -34,14 +34,14 @@ export const BrandAuthoredMetadataSchema = z.object({
|
|
|
34
34
|
/** ISO-8601 timestamp of the last meaningful authoring touch. */
|
|
35
35
|
lastAuthoredAt: z.iso.datetime(),
|
|
36
36
|
/** Author's self-assessed confidence in the current content. */
|
|
37
|
-
confidence: z.enum(AuthoredConfidence),
|
|
37
|
+
confidence: z.enum(AuthoredConfidence).systemEnum('AuthoredConfidence'),
|
|
38
38
|
/**
|
|
39
39
|
* Cadence at which the entity should be re-reviewed. When set, the
|
|
40
40
|
* snapshot validator emits `STALE_AUTHORED` if `lastAuthoredAt +
|
|
41
41
|
* cadence < now`. When omitted, no staleness check runs (same
|
|
42
42
|
* semantics as the market + vision families).
|
|
43
43
|
*/
|
|
44
|
-
reviewCadence: z.enum(ReviewCadence).optional(),
|
|
44
|
+
reviewCadence: z.enum(ReviewCadence).systemEnum('ReviewCadence').optional(),
|
|
45
45
|
/** Owner accountable for the entity's content. Free-form name/handle. */
|
|
46
46
|
reviewer: NonEmptyStringSchema.optional(),
|
|
47
47
|
/** Free-form authoring notes (rationale, open questions, sources). */
|
|
@@ -33,8 +33,9 @@
|
|
|
33
33
|
* `gpt-image` output usable.
|
|
34
34
|
* - **`backgroundTreatment`** — how the master must be composed so the
|
|
35
35
|
* Layer-4 derivations (favicon/mono/dark-light) are clean. Defaults
|
|
36
|
-
* to a transparent isolated mark
|
|
37
|
-
*
|
|
36
|
+
* to a transparent isolated mark so derived assets do not inherit an unwanted
|
|
37
|
+
* background. Raster resolution and the target role still constrain usable size
|
|
38
|
+
* and detail; transparency does not make enlargement lossless.
|
|
38
39
|
*/
|
|
39
40
|
export enum BrandLogoMarkType {
|
|
40
41
|
/** Text-only, styled name (e.g. "Google"). */
|
|
@@ -55,9 +56,10 @@ export enum BrandLogoMarkType {
|
|
|
55
56
|
|
|
56
57
|
/**
|
|
57
58
|
* How the master logo raster must be composed. Only `TRANSPARENT_ISOLATED`
|
|
58
|
-
*
|
|
59
|
-
* monochrome, dark/light)
|
|
60
|
-
*
|
|
59
|
+
* provides a background-free starting point for Layer-4 derivations (favicon,
|
|
60
|
+
* maskable, monochrome, dark/light). Each role still needs suitable resolution
|
|
61
|
+
* and composition; the raster master is not a resolution-independent vector.
|
|
62
|
+
* Other treatments require background handling and are WARNed by the validator.
|
|
61
63
|
*/
|
|
62
64
|
export enum BrandLogoBackgroundTreatment {
|
|
63
65
|
/** Mark isolated on a transparent canvas. The clean default. */
|
|
@@ -70,7 +72,7 @@ export enum BrandLogoBackgroundTreatment {
|
|
|
70
72
|
|
|
71
73
|
export const BrandLogoDirectionConfigSchema = z.object({
|
|
72
74
|
/** Which of the seven canonical mark archetypes to render. */
|
|
73
|
-
markType: z.enum(BrandLogoMarkType),
|
|
75
|
+
markType: z.enum(BrandLogoMarkType).systemEnum('BrandLogoMarkType'),
|
|
74
76
|
/** Concrete visual elements to include — short noun phrases, not sentences. */
|
|
75
77
|
motifs: z.array(NonEmptyStringSchema).default([]),
|
|
76
78
|
/** The meaning the mark should evoke, derived from mission/idea. */
|
|
@@ -79,7 +81,7 @@ export const BrandLogoDirectionConfigSchema = z.object({
|
|
|
79
81
|
avoid: z.array(NonEmptyStringSchema).default([]),
|
|
80
82
|
/** How the master raster is composed so derivations stay clean. */
|
|
81
83
|
backgroundTreatment: z
|
|
82
|
-
.enum(BrandLogoBackgroundTreatment)
|
|
84
|
+
.enum(BrandLogoBackgroundTreatment).systemEnum('BrandLogoBackgroundTreatment')
|
|
83
85
|
.default(BrandLogoBackgroundTreatment.TRANSPARENT_ISOLATED),
|
|
84
86
|
/** Optional per-entity authoring provenance. */
|
|
85
87
|
authored: BrandAuthoredMetadataSchema.optional(),
|
|
@@ -25,8 +25,16 @@ export enum BrandSnapshotVersion {
|
|
|
25
25
|
* exactly one brand identity per application. It is the visual-identity
|
|
26
26
|
* definition artifact the app-creation top-down catalog reads/writes,
|
|
27
27
|
* and — via `resolvedAssets` — the **single source of truth for every
|
|
28
|
-
* logo/favicon/brand-image consumer in the app**
|
|
29
|
-
*
|
|
28
|
+
* logo/favicon/brand-image consumer in the app** that is actually wired:
|
|
29
|
+
* the app shell, the website, the docs site, the website OG image, and the
|
|
30
|
+
* backend runtime configuration that transactional email resolves its logo
|
|
31
|
+
* from.
|
|
32
|
+
*
|
|
33
|
+
* PDF templates and schema.org are NOT among them. The pdf-templates tree
|
|
34
|
+
* contains no brand or logo reference at all, and the website's structured-data
|
|
35
|
+
* payloads are authored by each section's `getStructuredData()` hook rather than
|
|
36
|
+
* resolved from here. Both would arrive as new propagation destinations; until
|
|
37
|
+
* they do, a PDF or a JSON-LD payload that needs the mark carries it by hand.
|
|
30
38
|
*
|
|
31
39
|
* **Artifact-family id: `brand-brief`.** This schema is the shape of the
|
|
32
40
|
* journey artifact selected by `MetaWorkflow_ArtifactSelector.family ===
|
|
@@ -64,6 +72,12 @@ export const BrandSnapshotSchema = z.object({
|
|
|
64
72
|
logoDirection: BrandLogoDirectionConfigSchema.optional(),
|
|
65
73
|
/** The visual aesthetic register — elicited progressively; WARNed when absent. */
|
|
66
74
|
visualTone: BrandVisualToneConfigSchema.optional(),
|
|
75
|
+
/**
|
|
76
|
+
* WHO the brand is for: the market ICPs (`targetIcpRefs`) its name and tone were chosen to speak to
|
|
77
|
+
* (#1424). Optional, like the two directions — a brand elicited before its market exists has none —
|
|
78
|
+
* and cross-checked against the market by the coherence report, which reports a ref naming no ICP.
|
|
79
|
+
*/
|
|
80
|
+
audience: BrandAudienceConfigSchema.optional(),
|
|
67
81
|
/**
|
|
68
82
|
* The generated + derived assets, each described by the three
|
|
69
83
|
* orthogonal axes (composition × theme × purpose). Populated by the
|
|
@@ -106,13 +106,6 @@ export interface ValidateBrandSnapshotOptions {
|
|
|
106
106
|
* (module-local there too — a shared promotion is part of the deferred
|
|
107
107
|
* authored-metadata generalization).
|
|
108
108
|
*/
|
|
109
|
-
const REVIEW_CADENCE_TO_DAYS: Record<ReviewCadence, number> = {
|
|
110
|
-
[ReviewCadence.WEEKLY]: 7,
|
|
111
|
-
[ReviewCadence.MONTHLY]: 31,
|
|
112
|
-
[ReviewCadence.QUARTERLY]: 92,
|
|
113
|
-
[ReviewCadence.YEARLY]: 366,
|
|
114
|
-
[ReviewCadence.AS_NEEDED]: Number.POSITIVE_INFINITY,
|
|
115
|
-
};
|
|
116
109
|
|
|
117
110
|
/** Square-icon technical purposes — must be square, and imply a symbol. */
|
|
118
111
|
const SQUARE_ICON_PURPOSES: ReadonlySet<BrandAssetPurpose> = new Set([
|