@wildo-ai/framework-knowledge 1.1.4 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +227 -6
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -54,6 +54,7 @@ export interface SpecificationsCompanionExports<
|
|
|
54
54
|
TRequirementsSnapshot = RequirementsSnapshot,
|
|
55
55
|
TRoadmapSnapshot = RoadmapSnapshot,
|
|
56
56
|
TBuildPlanTaskGraph = BuildPlanTaskGraph,
|
|
57
|
+
TPlacementPlan = PlacementPlan,
|
|
57
58
|
TDomainPlanOutputSet = DomainPlanOutputSet,
|
|
58
59
|
TBusinessModelLiteSnapshot = BusinessModelLiteSnapshot,
|
|
59
60
|
// Appended STRICTLY LAST (positional generics — never insert mid-list):
|
|
@@ -81,6 +82,41 @@ export interface SpecificationsCompanionExports<
|
|
|
81
82
|
// Appended STRICTLY LAST: release-process selection is a separate accepted
|
|
82
83
|
// decision, never an implicit default of routing or document necessity.
|
|
83
84
|
TDocumentReleasePolicySpecification = ApplicationDocumentReleasePolicySpecification,
|
|
85
|
+
TDocumentReleaseSet = ApplicationDocumentReleaseSet,
|
|
86
|
+
// Appended STRICTLY LAST: WHO else processes personal data, under what legal
|
|
87
|
+
// identity and where (issue #88). Optional, and the optionality is the design:
|
|
88
|
+
// a partial register is useful and its holes are REPORTED per provider against
|
|
89
|
+
// the application's configured set, rather than blocking anything.
|
|
90
|
+
TProcessorRegister = ApplicationProcessorRegister,
|
|
91
|
+
// Appended STRICTLY LAST: the human half of the document facts, in its own
|
|
92
|
+
// family, because the derived one is REGENERATED whole (#192).
|
|
93
|
+
TAuthoredDocumentFactSpecification = ApplicationAuthoredDocumentFactSpecification,
|
|
94
|
+
// Appended STRICTLY LAST: the releases the application has DECIDED to make,
|
|
95
|
+
// which `wildo config document-releases` composes into recorded data (#968).
|
|
96
|
+
TDocumentReleaseCompositions = readonly GovernedDocumentReleaseComposition[],
|
|
97
|
+
// Appended STRICTLY LAST: WHICH RISKS the application carries and under what
|
|
98
|
+
// posture (#300). Optional like every family slot, and the companion is what
|
|
99
|
+
// reads it — see the field below for why a family without a slot is invisible.
|
|
100
|
+
TRiskRegister = ApplicationRiskRegister,
|
|
101
|
+
// Appended STRICTLY LAST: the creator's interview answers — the dossier's
|
|
102
|
+
// committed half (#1454). Optional like every family slot; a playbook run
|
|
103
|
+
// reads its interview from here by default.
|
|
104
|
+
TCreatorInputs = ApplicationCreatorInputs,
|
|
105
|
+
// Appended STRICTLY LAST: which composition scenarios the application needs,
|
|
106
|
+
// derived from its definition families (#1491). Optional like every family
|
|
107
|
+
// slot; the foundation executor is what reads it.
|
|
108
|
+
TCapabilityComposition = CapabilityComposition,
|
|
109
|
+
// Appended STRICTLY LAST: what the marketing website says, page by page (#1492).
|
|
110
|
+
// Optional like every family slot; the decomposer is what reads it.
|
|
111
|
+
TWebsitePlan = WebsitePlan,
|
|
112
|
+
// Appended STRICTLY LAST: the application's views, shell and navigation composition (#1493).
|
|
113
|
+
TExperiencePlan = ExperiencePlan,
|
|
114
|
+
// Appended STRICTLY LAST: which chapters the documentation portal carries (#1494).
|
|
115
|
+
TApplicationDocumentationPlan = ApplicationDocumentationPlan,
|
|
116
|
+
// Appended STRICTLY LAST: the workers, minions and provider bindings (#1495).
|
|
117
|
+
TIntegrationPlan = IntegrationPlan,
|
|
118
|
+
// Appended STRICTLY LAST: where the application stands against its own requirements (#1496).
|
|
119
|
+
TApplicationMaturity = ApplicationMaturity,
|
|
84
120
|
> {
|
|
85
121
|
resourceSpecifications: TResourceSpecifications;
|
|
86
122
|
applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
|
|
@@ -120,7 +156,7 @@ export interface SpecificationsCompanionExports<
|
|
|
120
156
|
* Role overlays exposed to the dev companion.
|
|
121
157
|
*
|
|
122
158
|
* **Required** (promoted 2026-04-22, carryforward #5). Engine ships
|
|
123
|
-
*
|
|
159
|
+
* 13 explicit core-role overlays via `engineRoleSpecifications` (one
|
|
124
160
|
* per `CORE_APP_ROLES.*` member), so apps always have something to
|
|
125
161
|
* expose. Apps with no app-level roles should pass
|
|
126
162
|
* `engineRoleSpecifications` directly.
|
|
@@ -311,6 +347,22 @@ export interface SpecificationsCompanionExports<
|
|
|
311
347
|
* `validateBuildPlanTaskGraph` on the value before wiring it here.
|
|
312
348
|
*/
|
|
313
349
|
buildPlanSpecification?: TBuildPlanTaskGraph;
|
|
350
|
+
/**
|
|
351
|
+
* Application **placement** specification — WHERE every settings destination,
|
|
352
|
+
* resource operation and app view sits in the shell, and WHY (`PlacementPlan`,
|
|
353
|
+
* `_core/placement-plan/`).
|
|
354
|
+
*
|
|
355
|
+
* Produced by the `bottom_up.placement-plan` playbook as an expert-panel
|
|
356
|
+
* DELIBERATION rather than a creator elicitation: the creator does not choose
|
|
357
|
+
* placement, so each decision carries a `rationale` that answers "why is this
|
|
358
|
+
* here?" without re-running the panel. Consumed by build-decompose, which
|
|
359
|
+
* turns it into the coding tasks that author `settings-hub.config.ts` and
|
|
360
|
+
* `app-shell.config.ts`.
|
|
361
|
+
*
|
|
362
|
+
* Optional until an application reaches the bottom-up phase; app bootstraps
|
|
363
|
+
* should run `validatePlacementPlan` on the value before wiring it here.
|
|
364
|
+
*/
|
|
365
|
+
placementPlanSpecification?: TPlacementPlan;
|
|
314
366
|
/**
|
|
315
367
|
* Application **domain-plan** specification — the atomic module decomposition
|
|
316
368
|
* PLUS relationship drafts (`DomainPlanOutputSet`, `_core/domain-plan/`);
|
|
@@ -411,10 +463,11 @@ export interface SpecificationsCompanionExports<
|
|
|
411
463
|
*
|
|
412
464
|
* The exact locale × jurisdiction combinations in which this application
|
|
413
465
|
* publishes public governed documents. It is the ONLY source a governed
|
|
414
|
-
* document candidate may take its locale and jurisdictions from
|
|
415
|
-
*
|
|
416
|
-
*
|
|
417
|
-
*
|
|
466
|
+
* document candidate may take its locale and jurisdictions from.
|
|
467
|
+
*
|
|
468
|
+
* That is a contract statement, not a running check: there is no candidate host binding these
|
|
469
|
+
* bytes to the `document-publication` family's retained head, and nothing today refuses a
|
|
470
|
+
* combination that is not an exact member. Whatever begins producing candidates owes the refusal.
|
|
418
471
|
*
|
|
419
472
|
* Distinct from `complianceSpecification` by design. The assurance program
|
|
420
473
|
* decides which documents are required and who approves them; this slot
|
|
@@ -423,8 +476,8 @@ export interface SpecificationsCompanionExports<
|
|
|
423
476
|
*
|
|
424
477
|
* **Optional** at the aggregate contract boundary. An application that
|
|
425
478
|
* declares no `document-publication` family publishes no public governed
|
|
426
|
-
* document
|
|
427
|
-
*
|
|
479
|
+
* document. Candidate creation is INTENDED to fail closed there rather than default to a locale
|
|
480
|
+
* or jurisdiction nobody accepted; as above, no code enforces that yet.
|
|
428
481
|
*/
|
|
429
482
|
documentPublicationSpecification?: TDocumentPublicationSpecification;
|
|
430
483
|
/**
|
|
@@ -435,20 +488,164 @@ export interface SpecificationsCompanionExports<
|
|
|
435
488
|
* qualified review.
|
|
436
489
|
*/
|
|
437
490
|
documentReleasePolicySpecification?: TDocumentReleasePolicySpecification;
|
|
491
|
+
/**
|
|
492
|
+
* The governed-document **releases** the application has composed.
|
|
493
|
+
*
|
|
494
|
+
* Optional, and an EMPTY set is the honest answer for an application that has
|
|
495
|
+
* drafted nothing yet. What this slot must never be read as is a list of
|
|
496
|
+
* PUBLISHED documents: every release states its own `approvalState`, and one
|
|
497
|
+
* nobody has approved is `UNAPPROVED` and present here anyway — approval is a
|
|
498
|
+
* workflow act that happens at the end, so an application holds its releases
|
|
499
|
+
* from the moment they are composed.
|
|
500
|
+
*
|
|
501
|
+
* A surface serving a REAL reader obeys `compliance.governedDocumentApprovalGate`; nothing in
|
|
502
|
+
* this slot does that filtering for it.
|
|
503
|
+
*/
|
|
504
|
+
documentReleaseSet?: TDocumentReleaseSet;
|
|
505
|
+
/**
|
|
506
|
+
* The governed-document releases the application has **decided** to make — which draft, which
|
|
507
|
+
* declared variant, when it takes effect — as composer inputs (wildo-ai/wildo-ai#968).
|
|
508
|
+
*
|
|
509
|
+
* Decisions, not releases. `wildo config document-releases` composes each decision whose release
|
|
510
|
+
* identity is not yet in `documentReleaseSet` and records the finished release, text included, as
|
|
511
|
+
* committed data. A recorded release is never recomposed, so editing a draft afterwards changes no
|
|
512
|
+
* release; publishing new text is a new decision with the next `releaseVersion`.
|
|
513
|
+
*
|
|
514
|
+
* Optional: an application that composes no releases declares none, and one that already records
|
|
515
|
+
* its releases some other way loses nothing.
|
|
516
|
+
*/
|
|
517
|
+
documentReleaseCompositions?: TDocumentReleaseCompositions;
|
|
438
518
|
/**
|
|
439
519
|
* Accepted application **governed-document facts**.
|
|
440
520
|
*
|
|
441
|
-
* This optional slot carries
|
|
442
|
-
*
|
|
443
|
-
*
|
|
444
|
-
*
|
|
445
|
-
* receipts; application code never authors those host identities.
|
|
521
|
+
* This optional slot carries the `document-facts` family: declarations answered from the accepted
|
|
522
|
+
* specification, under `APPLICATION_SPECIFICATION` authority only. `refinement.document-facts`
|
|
523
|
+
* produces it and a commit accepts it; creator decisions and qualified reviews live in the authored
|
|
524
|
+
* slot below. Nothing is sealed or digested — validation re-reads the file.
|
|
446
525
|
*
|
|
447
|
-
*
|
|
448
|
-
* releases are runtime/private custody and are forbidden from this slot.
|
|
526
|
+
* Candidates and releases belong to their own families and are not carried here.
|
|
449
527
|
* Omitting it is honest: unresolved document facts remain visible gaps.
|
|
450
528
|
*/
|
|
451
529
|
documentFactSpecification?: TDocumentFactSpecification;
|
|
530
|
+
/**
|
|
531
|
+
* Accepted application governed-document facts **only a human may establish** — a creator decision
|
|
532
|
+
* or a qualified review (`document-facts-authored`).
|
|
533
|
+
*
|
|
534
|
+
* The same shape as the slot above, and a separate family on purpose. `refinement.document-facts`
|
|
535
|
+
* rewrites the derived file whole, so a human decision sharing that file is destroyed on the next
|
|
536
|
+
* run with nothing to notice: there is no compare-and-swap here, deliberately — nothing is kept
|
|
537
|
+
* that cannot branch and merge on git. Two families put the two writers out of each
|
|
538
|
+
* other's reach.
|
|
539
|
+
*
|
|
540
|
+
* No producer may write this family — it has no generation contract, and that absence is the design
|
|
541
|
+
* rather than an omission.
|
|
542
|
+
*
|
|
543
|
+
* A reader wanting "the application's facts" needs BOTH slots. `collectComplianceDocumentFactAvailability`
|
|
544
|
+
* is variadic for exactly that reason.
|
|
545
|
+
*/
|
|
546
|
+
authoredDocumentFactSpecification?: TAuthoredDocumentFactSpecification;
|
|
547
|
+
/**
|
|
548
|
+
* WHO else processes this application's personal data — legal identity, processing region and the
|
|
549
|
+
* processor's own subprocessors (issue #88).
|
|
550
|
+
*
|
|
551
|
+
* A configured provider already establishes THAT a third party is involved and what function it
|
|
552
|
+
* performs. None of that is what a privacy notice's recipient statement needs, and an
|
|
553
|
+
* international-transfer statement cannot be made at all without a region.
|
|
554
|
+
*
|
|
555
|
+
* Optional, and its holes are reported rather than blocking: the companion compares this register
|
|
556
|
+
* against the application's CONFIGURED providers and names each one that is undeclared, so a partial
|
|
557
|
+
* register is useful and an empty one still produces an actionable document. An absent entry means
|
|
558
|
+
* nobody has established that processor's identity — never that the provider is unused.
|
|
559
|
+
*/
|
|
560
|
+
processorRegister?: TProcessorRegister;
|
|
561
|
+
/**
|
|
562
|
+
* WHICH RISKS this application carries, and under what posture — the accepted risk register (#300).
|
|
563
|
+
*
|
|
564
|
+
* ## Why a family that "the runtime does not consume" still needs a slot
|
|
565
|
+
*
|
|
566
|
+
* This slot was almost omitted on the reasoning that the application RUNTIME never reads the
|
|
567
|
+
* register: it is accepted by a human and read by assurance tooling over the committed file, which
|
|
568
|
+
* is exactly the case `ApplicationSpecificationSemanticSchemaBinding.companionExportsField`
|
|
569
|
+
* describes as "lands as a file to review, and is deliberately not wired".
|
|
570
|
+
*
|
|
571
|
+
* That reasoning is about the runtime and the question is about the COMPANION.
|
|
572
|
+
* `family-aspects.behavior.ts` reads a landed family through this aggregate and nowhere else — a
|
|
573
|
+
* binding with no slot yields an undefined snapshot, so every aspect of that family projects an
|
|
574
|
+
* empty item list. The register's rows would have been addressable, navigable, labelled, and
|
|
575
|
+
* permanently absent: a resource that cannot ever hold a row.
|
|
576
|
+
*
|
|
577
|
+
* Optional, like every family slot: an application that has not accepted a register simply has
|
|
578
|
+
* none, and the aspect resource is empty because there is nothing rather than because nothing can
|
|
579
|
+
* reach it.
|
|
580
|
+
*/
|
|
581
|
+
riskRegister?: TRiskRegister;
|
|
582
|
+
/**
|
|
583
|
+
* WHAT THE CREATOR SAID — every interview answer, by playbook and question ref (#1454, Step 5).
|
|
584
|
+
*
|
|
585
|
+
* The slot is what makes the dossier READABLE by the companion, exactly as the risk register's
|
|
586
|
+
* note above explains: a playbook run resolves its interview answers through this aggregate and
|
|
587
|
+
* nowhere else, so a landed dossier with no slot would be a file nobody reads. Optional, because
|
|
588
|
+
* an application that has answered nothing simply has no dossier yet.
|
|
589
|
+
*/
|
|
590
|
+
creatorInputs?: TCreatorInputs;
|
|
591
|
+
/**
|
|
592
|
+
* WHICH COMPOSITION SCENARIOS the application needs — website, documentation portal, workers,
|
|
593
|
+
* minions, locales — one decision per scenario the framework ships, each naming the declaration
|
|
594
|
+
* it was derived from (#1491). The foundation executor reads it through this slot and applies
|
|
595
|
+
* the NEEDED ones; a landed composition with no slot would be a file nobody reads, exactly as
|
|
596
|
+
* the risk register's note above explains.
|
|
597
|
+
*/
|
|
598
|
+
capabilityComposition?: TCapabilityComposition;
|
|
599
|
+
/**
|
|
600
|
+
* WHAT THE MARKETING WEBSITE SAYS — its pages, their sections in reading order, and the market
|
|
601
|
+
* entries each draws on (#1492). Read by `bottom_up.build-decompose`, which turns each page and
|
|
602
|
+
* each section into a build task bound to the skill that authors it. Optional: an application
|
|
603
|
+
* whose capability composition declined a website lands a NOT_APPLICABLE plan, and one that has
|
|
604
|
+
* not reached the website step has none at all.
|
|
605
|
+
*/
|
|
606
|
+
websitePlan?: TWebsitePlan;
|
|
607
|
+
/**
|
|
608
|
+
* WHAT THE APPLICATION'S EXPERIENCE IS — the views it carries beyond its resources' generated
|
|
609
|
+
* screens, the shell and navigation composition, and the preset components each view reuses
|
|
610
|
+
* (#1493). Read by `bottom_up.build-decompose`, which turns each entry into a build task bound to
|
|
611
|
+
* the skill its kind names. Optional: an application that has not reached the experience step has
|
|
612
|
+
* none, and its build plan simply carries no view or configuration task.
|
|
613
|
+
*/
|
|
614
|
+
experiencePlan?: TExperiencePlan;
|
|
615
|
+
/**
|
|
616
|
+
* WHICH CHAPTERS the documentation portal carries, what each documents and who it is for (#1494).
|
|
617
|
+
* Read by `bottom_up.build-decompose`, which turns each chapter into a task, and by the documentation
|
|
618
|
+
* publication, which takes each chapter's identity from here and its body from
|
|
619
|
+
* `documentationChapters` below (#874).
|
|
620
|
+
*/
|
|
621
|
+
documentationPlan?: TApplicationDocumentationPlan;
|
|
622
|
+
/**
|
|
623
|
+
* THE AUTHORED BODY of each chapter `documentationPlan` declares, keyed by `chapterRef` (#874) —
|
|
624
|
+
* from `specifications/src/technical-documentation/index.ts`, accepted by being committed.
|
|
625
|
+
*
|
|
626
|
+
* Read by the documentation publication, which joins each body to its planned chapter and publishes
|
|
627
|
+
* it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
|
|
628
|
+
* withheld and reported, and an API reference that does not resolve against the rendered reference
|
|
629
|
+
* fails the publication. Optional, and absent is honest: the portal then carries only its derived pages.
|
|
630
|
+
*
|
|
631
|
+
* Typed directly rather than through a positional generic: no application narrows it, and a new
|
|
632
|
+
* positional parameter would only add a slot for every consumer to skip.
|
|
633
|
+
*/
|
|
634
|
+
documentationChapters?: ApplicationDocumentationChapterSet;
|
|
635
|
+
/**
|
|
636
|
+
* WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
|
|
637
|
+
* minion's tick may touch, and the providers this application binds (#1495). Read by
|
|
638
|
+
* `bottom_up.build-decompose`, which turns each into a build task bound to `worker-authoring`,
|
|
639
|
+
* `minion-authoring` or the provider skills.
|
|
640
|
+
*/
|
|
641
|
+
integrationPlan?: TIntegrationPlan;
|
|
642
|
+
/**
|
|
643
|
+
* WHERE THIS APPLICATION STANDS against what it asked of itself (#1496) — one row per requirement
|
|
644
|
+
* with the evidence that exists for it, and the stage that follows. A READING: derived from the
|
|
645
|
+
* requirements, the decided-element graph and the build plan's landing probe, never generated and
|
|
646
|
+
* never a gate. Read by the coherence report and the workbench.
|
|
647
|
+
*/
|
|
648
|
+
applicationMaturity?: TApplicationMaturity;
|
|
452
649
|
/**
|
|
453
650
|
* Accepted application-declared semantic causality between whole
|
|
454
651
|
* specification-family states. This is not the registry's physical
|
|
@@ -38,6 +38,16 @@ export interface CompositeViewSpecificationConfig {
|
|
|
38
38
|
textSlots?: TranslationSlotSpecificationMap;
|
|
39
39
|
/** Meaning of each declared section inside the composite. */
|
|
40
40
|
sections?: Record<string, StructuralTranslationSlotSpecification>;
|
|
41
|
+
/**
|
|
42
|
+
* Meaning of each label the view DECLARES for its own text (`labels` on the authored definition) —
|
|
43
|
+
* the captions, KPI names and failure sentences its component renders beyond the title,
|
|
44
|
+
* description and section headings.
|
|
45
|
+
*
|
|
46
|
+
* Keyed by the declared label ref. Without it the generator words a label from its bare ref, and
|
|
47
|
+
* a ref is an identifier, not a meaning: `stat_in_flight` was generated as "In progress" — the
|
|
48
|
+
* words of one status — for a tile that counts two. Validated like `sections`, both directions.
|
|
49
|
+
*/
|
|
50
|
+
labels?: TranslationSlotSpecificationMap;
|
|
41
51
|
/** Additional domain constraints that matter beyond raw runtime structure. */
|
|
42
52
|
businessConstraints?: string[];
|
|
43
53
|
/** Import-oriented coding/transposition metadata. */
|
|
@@ -0,0 +1,364 @@
|
|
|
1
|
+
# saas.specifications.governed-document-release.contract
|
|
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
|
+
* Turning an APPROVED DRAFT into a RELEASE — the step whose absence meant a
|
|
14
|
+
* drafted governed document could never become a published one (issue #245).
|
|
15
|
+
*
|
|
16
|
+
* The lane could draft: an application holds a real
|
|
17
|
+
* `ComplianceDocumentCandidate` with its sections, clauses and prose. What it
|
|
18
|
+
* had no way to do was say *this draft, in this language, for these
|
|
19
|
+
* jurisdictions, is approved and takes effect on this date* — measured
|
|
20
|
+
* 2026-09-02 and re-measured 2026-09-11, `GovernedDocumentReleaseSchema`
|
|
21
|
+
* appeared in exactly two files, its own definition and its unit test, and
|
|
22
|
+
* nothing anywhere constructed one.
|
|
23
|
+
*
|
|
24
|
+
* **This is a composition, not a custody protocol, and the distinction is the
|
|
25
|
+
* whole design.** `0924c256` removed the previous publication lane — "a sealed
|
|
26
|
+
* machine that had never run" — and said what should replace it: *"A governed
|
|
27
|
+
* document is a file; publishing one is a commit. When an application has a
|
|
28
|
+
* document to serve, serving is rebuilt from files — a read, not a custody
|
|
29
|
+
* protocol."* So there is no bundle here, no digest, no content-addressed
|
|
30
|
+
* store and no byte-exact retrieval transport. A release is a record an
|
|
31
|
+
* application COMMITS, and {@link resolveEffectiveDocumentRelease} is the read.
|
|
32
|
+
*
|
|
33
|
+
* **Most of a release is DERIVED rather than authored**, which is the other
|
|
34
|
+
* half of the design. The accepted `AssuranceDocumentDefinition` already
|
|
35
|
+
* decides the document's class, who it addresses, which channels may carry it
|
|
36
|
+
* and which interactions it permits — so asking an author to restate them
|
|
37
|
+
* would invite five ways to disagree with the catalog, and the disagreement
|
|
38
|
+
* would be invisible. What is genuinely a human decision is the narrow part:
|
|
39
|
+
* which draft, which variant, which approval, and when it takes effect.
|
|
40
|
+
*/
|
|
41
|
+
export enum GovernedDocumentReleaseCompositionIssueKind {
|
|
42
|
+
/** The candidate drafts a different document from the one being released. */
|
|
43
|
+
CANDIDATE_DOCUMENT_MISMATCH = "CANDIDATE_DOCUMENT_MISMATCH",
|
|
44
|
+
/** The requested variant is not one the application declared it publishes in. */
|
|
45
|
+
VARIANT_NOT_PUBLISHED = "VARIANT_NOT_PUBLISHED",
|
|
46
|
+
/** The candidate states a locale or jurisdictions that contradict the variant being released. */
|
|
47
|
+
CANDIDATE_VARIANT_CONTRADICTION = "CANDIDATE_VARIANT_CONTRADICTION",
|
|
48
|
+
/** The governance subject is not one the document's definition governs. */
|
|
49
|
+
GOVERNANCE_SUBJECT_NOT_PERMITTED = "GOVERNANCE_SUBJECT_NOT_PERMITTED",
|
|
50
|
+
/** A release that replaces another must supersede the SAME document. */
|
|
51
|
+
REPLACES_DIFFERENT_DOCUMENT = "REPLACES_DIFFERENT_DOCUMENT",
|
|
52
|
+
/** The release policy consulted governs a different document from the one being released. */
|
|
53
|
+
RELEASE_POLICY_FOR_OTHER_REQUIREMENT = "RELEASE_POLICY_FOR_OTHER_REQUIREMENT",
|
|
54
|
+
/** The composed record does not satisfy `GovernedDocumentReleaseSchema`. */
|
|
55
|
+
RELEASE_RECORD_INVALID = "RELEASE_RECORD_INVALID",
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
export interface GovernedDocumentReleaseCompositionIssue {
|
|
59
|
+
readonly kind: GovernedDocumentReleaseCompositionIssueKind;
|
|
60
|
+
readonly message: string;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* What is TRUE about a composed release that a human must eventually act on — never a reason to
|
|
65
|
+
* refuse composing it.
|
|
66
|
+
*
|
|
67
|
+
* The split from {@link GovernedDocumentReleaseCompositionIssueKind} is the design, not a severity
|
|
68
|
+
* scale. An ISSUE means the record would be FALSE: it names a document the candidate does not draft,
|
|
69
|
+
* or publishes an `en-GB` draft as `fr-FR`. An ADVISORY means the record is TRUE and the workflow is
|
|
70
|
+
* not finished — nobody has approved it yet, or the application's own policy keeps this document in
|
|
71
|
+
* the draft-only lane.
|
|
72
|
+
*
|
|
73
|
+
* Wildo is agent-first, so the second kind may never stop the mechanism. A compliance workflow
|
|
74
|
+
* standing in front of application creation is exactly the shape this framework refuses: the system
|
|
75
|
+
* must WORK first, and
|
|
76
|
+
* restrictions arrive later as judge-style guards rather than ceremony wired into the mechanism.
|
|
77
|
+
*/
|
|
78
|
+
export enum GovernedDocumentReleaseAdvisoryKind {
|
|
79
|
+
/** Composed without an approval decision. The release says so in `approvalState`. */
|
|
80
|
+
NOT_APPROVED = "NOT_APPROVED",
|
|
81
|
+
/**
|
|
82
|
+
* The application's accepted policy keeps this document in the DRAFT_ONLY lane.
|
|
83
|
+
*
|
|
84
|
+
* It refused composition until 2026-09-11, and that was the error this whole split corrects: a
|
|
85
|
+
* lane an application chose for its OWN document became a wall in front of its own build. The
|
|
86
|
+
* release is composed, marked UNAPPROVED, and the lane is reported — so the decision to serve it
|
|
87
|
+
* is taken where serving happens, which is Gate 3's to arm.
|
|
88
|
+
*/
|
|
89
|
+
POLICY_IS_DRAFT_ONLY = "POLICY_IS_DRAFT_ONLY",
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
export interface GovernedDocumentReleaseAdvisory {
|
|
93
|
+
readonly kind: GovernedDocumentReleaseAdvisoryKind;
|
|
94
|
+
readonly message: string;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/** What a human actually decides. Everything else on the record is derived from the accepted definition. */
|
|
98
|
+
export interface GovernedDocumentReleaseComposition {
|
|
99
|
+
/** The framework-accepted definition. Supplies class, audiences, channels and permitted interactions. */
|
|
100
|
+
readonly definition: AssuranceDocumentDefinition;
|
|
101
|
+
/** The approved draft whose content this release publishes. */
|
|
102
|
+
readonly candidate: ComplianceDocumentCandidate;
|
|
103
|
+
/** The exact locale x jurisdiction combination being published. */
|
|
104
|
+
readonly variant: AssuranceDocumentPublicationVariant;
|
|
105
|
+
/** Every variant the application declared it publishes in; the variant above must be one of them. */
|
|
106
|
+
readonly publishedVariants: readonly AssuranceDocumentPublicationVariant[];
|
|
107
|
+
/**
|
|
108
|
+
* The application's accepted release-policy selection for THIS document's requirement.
|
|
109
|
+
*
|
|
110
|
+
* REQUIRED, because releasing is the act that policy exists to govern. `DRAFT_ONLY` means the
|
|
111
|
+
* document "may be generated and retained, but cannot be released or published" — a sentence with
|
|
112
|
+
* no effect unless something refuses, and the only place that can refuse is here. An optional
|
|
113
|
+
* input would have made the strictest lane the easiest one to skip: omit the field, get a release.
|
|
114
|
+
*
|
|
115
|
+
* The other two lanes do not branch here. Whether an operator attestation or a qualified review
|
|
116
|
+
* actually happened is recorded in `approvalDecisions`, and the selection's own schema already
|
|
117
|
+
* requires an attested lane to carry its explicit limitations.
|
|
118
|
+
*/
|
|
119
|
+
readonly releasePolicy: ApplicationDocumentReleasePolicySelectionV1;
|
|
120
|
+
/** The requirement the policy must govern — the join is by requirement, never by document ref. */
|
|
121
|
+
readonly requirement: { readonly requirementRef: string; readonly requirementVersion: number };
|
|
122
|
+
readonly identity: GovernedDocumentReleaseIdentity;
|
|
123
|
+
readonly governanceScope: GovernedDocumentRelease["governanceScope"];
|
|
124
|
+
/**
|
|
125
|
+
* The approvals retained for this release, if any yet.
|
|
126
|
+
*
|
|
127
|
+
* EMPTY is a first-class answer, not a missing input: it composes an UNAPPROVED release and an
|
|
128
|
+
* advisory saying so. Requiring one here would mean an application could only hold a release by
|
|
129
|
+
* forging an approval identity, which is worse than having none.
|
|
130
|
+
*/
|
|
131
|
+
readonly approvalDecisions: readonly GovernedDocumentApprovalDecisionIdentity[];
|
|
132
|
+
readonly issuedAt: string;
|
|
133
|
+
readonly effectiveAt: string;
|
|
134
|
+
readonly expiresAt?: string;
|
|
135
|
+
/**
|
|
136
|
+
* Superseding another release, stated ONCE as the materiality decision.
|
|
137
|
+
*
|
|
138
|
+
* The release record carries both `replacesRelease` and `materialityDecision`, and its schema
|
|
139
|
+
* requires them to be present together AND to name the same previous release. So the caller gives
|
|
140
|
+
* the decision and `replacesRelease` is DERIVED from `previousRelease` — two fields that must
|
|
141
|
+
* agree are not two decisions, and asking for both would only create a way to disagree.
|
|
142
|
+
*
|
|
143
|
+
* The decision itself is the governance question a replacement owes: did the change matter enough
|
|
144
|
+
* that the audience must meet the document again? `requiredInteractionKinds` is where that lands.
|
|
145
|
+
*/
|
|
146
|
+
readonly supersedes?: GovernedDocumentMaterialityDecisionIdentity;
|
|
147
|
+
}
|
|
148
|
+
const sorted = (values: readonly string[]): string[] => [...values].sort();
|
|
149
|
+
const sameSet = (left: readonly string[], right: readonly string[]): boolean =>
|
|
150
|
+
left.length === right.length && sorted(left).every((value, index) => value === sorted(right)[index]);
|
|
151
|
+
|
|
152
|
+
/**
|
|
153
|
+
* Compose one release, or report why the parts do not agree.
|
|
154
|
+
*
|
|
155
|
+
* Returns issues rather than throwing, following the `_core` validator convention: a caller
|
|
156
|
+
* assembling several releases wants all the disagreements at once, not the first one.
|
|
157
|
+
*/
|
|
158
|
+
export function composeGovernedDocumentRelease(
|
|
159
|
+
composition: GovernedDocumentReleaseComposition,
|
|
160
|
+
): {
|
|
161
|
+
readonly release: GovernedDocumentRelease | undefined;
|
|
162
|
+
readonly issues: readonly GovernedDocumentReleaseCompositionIssue[];
|
|
163
|
+
readonly advisories: readonly GovernedDocumentReleaseAdvisory[];
|
|
164
|
+
} {
|
|
165
|
+
const issues: GovernedDocumentReleaseCompositionIssue[] = [];
|
|
166
|
+
const advisories: GovernedDocumentReleaseAdvisory[] = [];
|
|
167
|
+
const { candidate, variant, identity, definition } = composition;
|
|
168
|
+
|
|
169
|
+
if (candidate.documentRef !== identity.document.documentRef) {
|
|
170
|
+
issues.push({
|
|
171
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.CANDIDATE_DOCUMENT_MISMATCH,
|
|
172
|
+
message: `candidate drafts "${candidate.documentRef}" but the release identifies "${identity.document.documentRef}"`,
|
|
173
|
+
});
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
if (composition.releasePolicy.requirementRef !== composition.requirement.requirementRef
|
|
177
|
+
|| composition.releasePolicy.requirementVersion !== composition.requirement.requirementVersion) {
|
|
178
|
+
issues.push({
|
|
179
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.RELEASE_POLICY_FOR_OTHER_REQUIREMENT,
|
|
180
|
+
message: `release policy governs "${composition.releasePolicy.requirementRef}@${composition.releasePolicy.requirementVersion}" `
|
|
181
|
+
+ `but this release is for "${composition.requirement.requirementRef}@${composition.requirement.requirementVersion}"`,
|
|
182
|
+
});
|
|
183
|
+
}
|
|
184
|
+
if (composition.releasePolicy.lane === ApplicationDocumentReleasePolicyLane.DRAFT_ONLY) {
|
|
185
|
+
advisories.push({
|
|
186
|
+
kind: GovernedDocumentReleaseAdvisoryKind.POLICY_IS_DRAFT_ONLY,
|
|
187
|
+
message: `the accepted release policy puts "${composition.requirement.requirementRef}" in the DRAFT_ONLY lane: compose and retain it, but nothing may serve it as published`,
|
|
188
|
+
});
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
const variantKey = assuranceDocumentPublicationVariantKey(variant);
|
|
192
|
+
if (!composition.publishedVariants.some((published) => assuranceDocumentPublicationVariantKey(published) === variantKey)) {
|
|
193
|
+
issues.push({
|
|
194
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.VARIANT_NOT_PUBLISHED,
|
|
195
|
+
message: `variant "${variantKey}" is not among the variants the application declared it publishes in`,
|
|
196
|
+
});
|
|
197
|
+
}
|
|
198
|
+
|
|
199
|
+
/*
|
|
200
|
+
* A candidate MAY leave locale and jurisdictions open — that is deliberate upstream, so a draft can
|
|
201
|
+
* exist before the routing decision. What it may not do is state them and DISAGREE: releasing an
|
|
202
|
+
* `en-GB` draft as the `fr-FR` variant would publish text under a claim it does not make.
|
|
203
|
+
*/
|
|
204
|
+
if (candidate.locale !== undefined && candidate.locale !== variant.locale) {
|
|
205
|
+
issues.push({
|
|
206
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.CANDIDATE_VARIANT_CONTRADICTION,
|
|
207
|
+
message: `candidate states locale "${candidate.locale}" but the release publishes "${variant.locale}"`,
|
|
208
|
+
});
|
|
209
|
+
}
|
|
210
|
+
if (candidate.jurisdictionRefs !== undefined && !sameSet(candidate.jurisdictionRefs, variant.jurisdictionRefs)) {
|
|
211
|
+
issues.push({
|
|
212
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.CANDIDATE_VARIANT_CONTRADICTION,
|
|
213
|
+
message: `candidate states jurisdictions [${sorted(candidate.jurisdictionRefs).join(", ")}] but the release publishes [${sorted(variant.jurisdictionRefs).join(", ")}]`,
|
|
214
|
+
});
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
if (!definition.governanceSubjectKinds.includes(composition.governanceScope.subjectKind as GovernedDocumentGovernanceSubjectKind)) {
|
|
218
|
+
issues.push({
|
|
219
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.GOVERNANCE_SUBJECT_NOT_PERMITTED,
|
|
220
|
+
message: `definition "${definition.identity.definitionRef}" governs [${definition.governanceSubjectKinds.join(", ")}], not "${composition.governanceScope.subjectKind}"`,
|
|
221
|
+
});
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
const replacesRelease: GovernedDocumentReleaseIdentity | undefined = composition.supersedes?.previousRelease;
|
|
225
|
+
if (replacesRelease !== undefined && replacesRelease.document.documentRef !== identity.document.documentRef) {
|
|
226
|
+
issues.push({
|
|
227
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.REPLACES_DIFFERENT_DOCUMENT,
|
|
228
|
+
message: `a release may only supersede the same document: replacing "${replacesRelease.document.documentRef}" with "${identity.document.documentRef}"`,
|
|
229
|
+
});
|
|
230
|
+
}
|
|
231
|
+
|
|
232
|
+
const approvalState = composition.approvalDecisions.length > 0
|
|
233
|
+
? GovernedDocumentReleaseApprovalState.APPROVED
|
|
234
|
+
: GovernedDocumentReleaseApprovalState.UNAPPROVED;
|
|
235
|
+
if (approvalState === GovernedDocumentReleaseApprovalState.UNAPPROVED) {
|
|
236
|
+
advisories.push({
|
|
237
|
+
kind: GovernedDocumentReleaseAdvisoryKind.NOT_APPROVED,
|
|
238
|
+
message: `no approval decision is retained for "${identity.document.documentRef}"; the release is composed and marked UNAPPROVED`,
|
|
239
|
+
});
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
// ONLY incoherence stops here. Everything above that is workflow travels with the release.
|
|
243
|
+
if (issues.length > 0) return { release: undefined, issues, advisories };
|
|
244
|
+
|
|
245
|
+
const parsed = GovernedDocumentReleaseSchema.safeParse({
|
|
246
|
+
schemaVersion: 1,
|
|
247
|
+
identity,
|
|
248
|
+
definition: definition.identity,
|
|
249
|
+
governanceScope: composition.governanceScope,
|
|
250
|
+
// DERIVED, every one of them — see this module's header.
|
|
251
|
+
documentClass: definition.documentClass,
|
|
252
|
+
audienceKinds: [...definition.audienceKinds],
|
|
253
|
+
publicationChannelKinds: [...definition.publicationChannelKinds],
|
|
254
|
+
allowedInteractionKinds: [...definition.allowedInteractionKinds],
|
|
255
|
+
locale: variant.locale,
|
|
256
|
+
jurisdictionRefs: [...variant.jurisdictionRefs],
|
|
257
|
+
/*
|
|
258
|
+
* The text this release publishes, CAPTURED here (#968). Every later read of the release — the
|
|
259
|
+
* one in force, the one it superseded, the one scheduled next — shows the text it was composed
|
|
260
|
+
* with, not whatever the draft says by then. That only holds if the composed record is what gets
|
|
261
|
+
* committed; recomposing from the live draft on every import re-captures today's text.
|
|
262
|
+
*/
|
|
263
|
+
content: draftPublicContent(candidate, variant),
|
|
264
|
+
// The shape of `content` above — not a caller's choice, so not an input.
|
|
265
|
+
contentMediaType: GOVERNED_DOCUMENT_PUBLIC_CONTENT_MEDIA_TYPE,
|
|
266
|
+
issuedAt: composition.issuedAt,
|
|
267
|
+
effectiveAt: composition.effectiveAt,
|
|
268
|
+
...(composition.expiresAt === undefined ? {} : { expiresAt: composition.expiresAt }),
|
|
269
|
+
approvalDecisions: [...composition.approvalDecisions],
|
|
270
|
+
approvalState,
|
|
271
|
+
// Both, or neither — and both from ONE input, so the schema's pairing rule cannot be violated here.
|
|
272
|
+
...(composition.supersedes === undefined ? {} : { replacesRelease, materialityDecision: composition.supersedes }),
|
|
273
|
+
});
|
|
274
|
+
if (!parsed.success) {
|
|
275
|
+
return {
|
|
276
|
+
release: undefined,
|
|
277
|
+
issues: [{
|
|
278
|
+
kind: GovernedDocumentReleaseCompositionIssueKind.RELEASE_RECORD_INVALID,
|
|
279
|
+
message: parsed.error.issues.map((issue) => `${issue.path.join(".") || "<root>"}: ${issue.message}`).join("; "),
|
|
280
|
+
}],
|
|
281
|
+
advisories,
|
|
282
|
+
};
|
|
283
|
+
}
|
|
284
|
+
return { release: parsed.data, issues: [], advisories };
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
/** What a reader knows: which document, in which language, for which jurisdictions, at which instant. */
|
|
288
|
+
export interface GovernedDocumentReleaseQuery {
|
|
289
|
+
readonly documentRef: string;
|
|
290
|
+
readonly locale: string;
|
|
291
|
+
readonly jurisdictionRefs: readonly string[];
|
|
292
|
+
/** ISO-8601. The instant the answer is wanted FOR — usually now, but a past instant is what an audit asks. */
|
|
293
|
+
readonly at: string;
|
|
294
|
+
/**
|
|
295
|
+
* ⚠️ THE GATE POINT, and it is OFF by default. Deliberately.
|
|
296
|
+
*
|
|
297
|
+
* Serving an UNAPPROVED release to a real reader is a legally-binding statement leaving the
|
|
298
|
+
* system, which `one-source-of-truth.md` D5 names as a critical gate point — and says such points
|
|
299
|
+
* stay MARKED in every mechanism, notifying and proceeding under the current autonomy posture,
|
|
300
|
+
* with ARMING them part of Gate 3's membership test ("an application may face a real user").
|
|
301
|
+
*
|
|
302
|
+
* So this defaults to `false`: an application under construction reads its own documents, and a
|
|
303
|
+
* compliance workflow may not stand in front of the mechanism that builds it. Every returned
|
|
304
|
+
* release carries `approvalState`, so a caller always knows what it has.
|
|
305
|
+
*
|
|
306
|
+
* A surface that genuinely faces a real user passes `true`. When Gate 3 is armed, what changes is
|
|
307
|
+
* that passing it stops being the caller's choice — not that this parameter appears.
|
|
308
|
+
*/
|
|
309
|
+
readonly requireApproved?: boolean;
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
/**
|
|
313
|
+
* THE READ — which release is in force for one document, variant and instant.
|
|
314
|
+
*
|
|
315
|
+
* This is the half `0924c256` asked for when it deleted the custody machine: serving rebuilt as a
|
|
316
|
+
* read over committed files. It takes the releases an application has committed and answers from
|
|
317
|
+
* them alone; there is no store to consult and nothing to retrieve.
|
|
318
|
+
*
|
|
319
|
+
* What decides:
|
|
320
|
+
*
|
|
321
|
+
* - the variant must match EXACTLY. Locale and jurisdictions are one inseparable pair, and nothing
|
|
322
|
+
* here recombines them — an `en-GB` release for `jurisdiction:gb` is not an answer for
|
|
323
|
+
* `jurisdiction:eu`, even though both are `en-GB`;
|
|
324
|
+
* - `effectiveAt` must not be in the future and `expiresAt`, when present, must not have passed.
|
|
325
|
+
* A release that has been ISSUED is not yet in force; the difference is the whole point of
|
|
326
|
+
* carrying both dates;
|
|
327
|
+
* - of those in force, the one that took effect LAST wins, and `releaseVersion` breaks a tie. Two
|
|
328
|
+
* releases sharing an instant is an authoring fault rather than a question, and answering
|
|
329
|
+
* deterministically is better than answering arbitrarily.
|
|
330
|
+
*
|
|
331
|
+
* It does NOT filter by approval unless asked to — see `requireApproved`, which is the marked gate
|
|
332
|
+
* point and is off by default. An application being built must be able to read what it has.
|
|
333
|
+
*
|
|
334
|
+
* Returns `undefined` when nothing is in force, and a caller must treat that as "this application
|
|
335
|
+
* publishes no such document here yet" rather than as an error — for most of an application's life
|
|
336
|
+
* that is the true answer, and it is the state every consumer meets first.
|
|
337
|
+
*/
|
|
338
|
+
export function resolveEffectiveDocumentRelease(
|
|
339
|
+
releases: readonly GovernedDocumentRelease[],
|
|
340
|
+
query: GovernedDocumentReleaseQuery,
|
|
341
|
+
): GovernedDocumentRelease | undefined {
|
|
342
|
+
const at = Date.parse(query.at);
|
|
343
|
+
if (Number.isNaN(at)) return undefined;
|
|
344
|
+
const inForce = releases.filter((release) =>
|
|
345
|
+
(query.requireApproved !== true || release.approvalState === GovernedDocumentReleaseApprovalState.APPROVED)
|
|
346
|
+
&& release.identity.document.documentRef === query.documentRef
|
|
347
|
+
&& release.locale === query.locale
|
|
348
|
+
&& sameSet(release.jurisdictionRefs, query.jurisdictionRefs)
|
|
349
|
+
/*
|
|
350
|
+
* The interval question is ONE implementation, in `saas-models`, shared with the record side
|
|
351
|
+
* (`composeGovernedDocumentInteraction`). It was written out here and again there, and two
|
|
352
|
+
* copies of a half-open interval is precisely where a `<=`/`<` slip lives — which would mean a
|
|
353
|
+
* surface offering a release that the recorder then refuses as out of force, or worse, the
|
|
354
|
+
* reverse.
|
|
355
|
+
*/
|
|
356
|
+
&& governedDocumentReleaseIsInForce(release, query.at));
|
|
357
|
+
if (inForce.length === 0) return undefined;
|
|
358
|
+
return inForce.reduce((winner, candidate) => {
|
|
359
|
+
const byEffective = Date.parse(candidate.effectiveAt) - Date.parse(winner.effectiveAt);
|
|
360
|
+
if (byEffective !== 0) return byEffective > 0 ? candidate : winner;
|
|
361
|
+
return candidate.identity.releaseVersion > winner.identity.releaseVersion ? candidate : winner;
|
|
362
|
+
});
|
|
363
|
+
}
|
|
364
|
+
```
|