@wildo-ai/framework-knowledge 1.1.3 → 1.1.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +349 -17
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +125 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +177 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +213 -7
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +326 -8
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +21 -14
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +63 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +179 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +76 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +10 -5
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +82 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +25 -9
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +124 -7
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +67 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +83 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +71 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +71 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +88 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +97 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +156 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +167 -9
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +171 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +146 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +157 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +172 -4
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +5 -4
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +8 -7
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +22 -3
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +21 -12
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +192 -27
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +172 -33
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +182 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +191 -5
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +3 -2
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +154 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +214 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +6 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +7 -3
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +32 -4
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +27 -3
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +5 -3
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +18 -4
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +155 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +187 -4
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +6 -5
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +18 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +43 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +79 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +65 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1122 -76
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +49 -13
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +671 -47
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +31 -35
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -16
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +95 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +80 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +90 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +107 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +8 -8
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +14 -13
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +165 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +74 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +219 -140
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +55 -22
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +138 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +69 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +63 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +116 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +79 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +70 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +68 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +873 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +186 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -16
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +343 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +28 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +8 -15
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +25 -49
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -17
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +101 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +209 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +68 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +39 -12
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +18 -66
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +103 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +75 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +48 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -44
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +43 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +45 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +247 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +71 -0
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +11 -7
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -16
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +59 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +12 -5
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +15 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +23 -14
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -17
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +13 -17
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +581 -7
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +155 -0
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +21 -0
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +8 -12
- package/dist/knowledge/references/example.config.app-shell.full.md +42 -7
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +4 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +6 -10
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +88 -11
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +38 -3
- package/dist/knowledge/references/example.provider.backend-module-shape.md +31 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +103 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +20 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +7 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +11 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +3 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +94 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +79 -0
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +311 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +132 -9
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +269 -0
- package/dist/knowledge/references/integration-plan.config.md +185 -0
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.channel.config.md +3 -3
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +2 -2
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +2 -2
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +2 -2
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +369 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +0 -21
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.models.labelling.sections.md +14 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +86 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +187 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +25 -1
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +6 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +17 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +200 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +51 -42
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +41 -11
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.billing-context.md +108 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +45 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +65 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +127 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +327 -11
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +198 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -9
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +155 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +82 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +77 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +192 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +81 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +85 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +61 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +43 -4
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +76 -110
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +2 -2
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +124 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +99 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +150 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +70 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +138 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +256 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +50 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +8 -5
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +72 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +111 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -4
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +10 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +14 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +635 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +198 -1
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +88 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +774 -53
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +211 -14
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +364 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +333 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +8 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +22 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +64 -2
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +32 -12
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +14 -1
- package/dist/knowledge/references/saas.website.blog.bridge.md +21 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +67 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.runtime.context.md +43 -7
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +205 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +51 -4
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +54 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +35 -0
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +90 -14
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +84 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +140 -4
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +46 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +31 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +2 -0
- package/dist/knowledge/references/zod.factories.duration.md +2 -0
- package/dist/knowledge/references/zod.factories.money.md +2 -0
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +1215 -11
- package/dist/knowledge/registries/playbooks.json +454 -50
- package/dist/knowledge/registries/source-tags.json +3153 -1043
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +108 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +46 -11
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +80 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +94 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +50 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +26 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +25 -1
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +75 -12
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +207 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +31 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +135 -5
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +369 -111
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +142 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +722 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +348 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +123 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +74 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +85 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +43 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +85 -2
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +2 -2
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +54 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +232 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +172 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +146 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +86 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +199 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +179 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +153 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +242 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +93 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +785 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +58 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +316 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +121 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +27 -22
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +27 -15
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +41 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +36 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +169 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +187 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +76 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +280 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +168 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +41 -69
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +120 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +19 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +54 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +33 -24
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +10 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +5 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +46 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +34 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +151 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +6 -10
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +258 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3983 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +211 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +13 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +3 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +14 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +237 -37
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +174 -21
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/journey-approve/SKILL.md +28 -8
- package/dist/knowledge/skills/journey-approve/references/specification-family-map.md +88 -0
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +37 -2
- package/dist/knowledge/skills/journey-next/SKILL.md +41 -1
- package/dist/knowledge/skills/journey-report/SKILL.md +16 -3
- package/dist/knowledge/skills/journey-run/SKILL.md +92 -7
- package/dist/knowledge/skills/journey-run/references/expert-personas-and-deliberations.md +46 -0
- package/dist/knowledge/skills/journey-run/references/framework-playbook-approval-policy.md +108 -0
- package/dist/knowledge/skills/journey-status/SKILL.md +14 -4
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +153 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +253 -33
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +1 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +1 -1
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-channels/SKILL.md +3 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +226 -14
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +226 -14
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +56 -9
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +32 -9
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +3 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +17 -2
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -2
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +2 -2
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +15 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +1 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +1 -1
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +198 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +140 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +211 -14
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -33
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +50 -1
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +142 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +62 -0
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +279 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +33 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +241 -9
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +196 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +80 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +71 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +58 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +275 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +64 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +12 -5
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +373 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +116 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +133 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +26 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +122 -4
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +25 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +93 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +136 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +85 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +859 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +124 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +457 -15
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +162 -46
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +452 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +5 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +327 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +228 -15
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +54 -7
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +87 -113
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +13 -8
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +69 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +43 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +96 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +32 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +75 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +182 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +46 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +480 -15
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +74 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +236 -18
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +54 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +35 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +327 -11
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +140 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +155 -5
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +165 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +9 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +33 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +205 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +38 -3
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +211 -14
- package/dist/knowledge/skills/spec-component-update/SKILL.md +30 -11
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +47 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +3 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +30 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +13 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +3 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +43 -7
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +21 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +21 -0
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +41 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +735 -211
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +54 -7
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +67 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +19 -5
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +94 -7
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +96 -146
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-faq/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-hero/SKILL.md +37 -26
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +19 -20
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -20
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +14 -1
- package/dist/knowledge/skills/worker-authoring/SKILL.md +164 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +5335 -1010
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -22,13 +22,15 @@ import {
|
|
|
22
22
|
resolveFeatureGatedCoreResourceExclusions,
|
|
23
23
|
describeCaughtError,
|
|
24
24
|
} from '@wildo-ai/saas-backend-lib';
|
|
25
|
-
import { CoreResourceType, ErrorCustomMessageReference, ErrorType } from '@wildo-ai/saas-models';
|
|
25
|
+
import { AuthMethod, CoreResourceType, ErrorCustomMessageReference, ErrorType, getEnabledMethods } from '@wildo-ai/saas-models';
|
|
26
26
|
import { AppFrontendType, loadConfig } from '@wildo-ai/platform-config-lib';
|
|
27
27
|
import {
|
|
28
|
+
assertApplicationDocumentationChapterApiReferencesResolve,
|
|
28
29
|
generateOpenApiDocuments,
|
|
29
30
|
resolveTechnicalDocumentationForbiddenPublicSentinels,
|
|
30
31
|
resolveTechnicalDocumentationOutputBudgets,
|
|
31
32
|
OpenApiGenerationInputSchema,
|
|
33
|
+
applyAuthoredRoleLabelsToOperationAccess,
|
|
32
34
|
resolveApplicationOrganizationRoleDocumentation,
|
|
33
35
|
type ApplicationOrganizationRoleDocumentationSource,
|
|
34
36
|
type ApplicationOrganizationUnitResourceDocumentation,
|
|
@@ -37,12 +39,19 @@ import {
|
|
|
37
39
|
type OperationProjection,
|
|
38
40
|
type ResourceTag,
|
|
39
41
|
type TechnicalDocGenerateOpenApiResult,
|
|
42
|
+
type ApplicationConnectionServer,
|
|
43
|
+
type ApplicationAuthenticationDocumentationSource,
|
|
44
|
+
type ApplicationMcpToolSource,
|
|
45
|
+
type ApplicationWebhookEventSource,
|
|
40
46
|
} from '@wildo-ai/saas-technical-doc/companion';
|
|
41
47
|
import {
|
|
42
48
|
createApiReferenceLinkIndex,
|
|
49
|
+
getTechnicalDocumentationApiReferenceTargetAvailability,
|
|
43
50
|
resolveTechnicalDocumentationApiReferenceLink,
|
|
51
|
+
TechnicalDocumentationApiReferenceTargetAvailability,
|
|
44
52
|
type WildoTechnicalDocConfig,
|
|
45
53
|
} from '@wildo-ai/saas-technical-doc';
|
|
54
|
+
import type { TechnicalDocumentationApiReferenceTargetV1 } from '@wildo-ai/saas-specifications/technical-documentation';
|
|
46
55
|
import { createConservedApiReferenceModel } from '@wildo-ai/saas-technical-doc/openapi-reference-model';
|
|
47
56
|
|
|
48
57
|
import { TechnicalDocumentationPilotCompanionService } from './technical-documentation-pilot.companion.service';
|
|
@@ -57,6 +66,7 @@ import type {
|
|
|
57
66
|
TechnicalDocumentationEnvironmentIdentityInput,
|
|
58
67
|
} from './technical-documentation-environment-identity.companion.service';
|
|
59
68
|
import { getCompanionConfiguredPrimaryLanguage } from '../../core/config/primary-language.companion.utils';
|
|
69
|
+
import { loadSpecificationsCompanionExports } from '../../core/context/companion-package-loaders.companion';
|
|
60
70
|
import { readPerUnitLabels, resolvePerUnitFilePath } from '../../i18n-labelling/utils/per-unit-file.utils';
|
|
61
71
|
import { ROLE_LABELLING_UNIT_FILE_PATH_HINT } from '../../i18n-labelling/utils/role-lifecycle-keys.utils';
|
|
62
72
|
|
|
@@ -104,6 +114,13 @@ interface OpenApiGenerationInputSubprocessOutput {
|
|
|
104
114
|
/** Source-derived application activation facts; independent from the API-reference selection. */
|
|
105
115
|
readonly hasConfiguredMcpToolOperations: boolean;
|
|
106
116
|
readonly hasConfiguredA2aSkills: boolean;
|
|
117
|
+
/**
|
|
118
|
+
* The two integration inventories the same walk collects. Row types come from the ENGINE, not
|
|
119
|
+
* from the subprocess module, so this mirror cannot drift on their shape while the parent still
|
|
120
|
+
* never loads subprocess code.
|
|
121
|
+
*/
|
|
122
|
+
readonly mcpTools: readonly ApplicationMcpToolSource[];
|
|
123
|
+
readonly webhookEvents: readonly ApplicationWebhookEventSource[];
|
|
107
124
|
/**
|
|
108
125
|
* Source-derived role semantics cross the subprocess boundary unchanged.
|
|
109
126
|
* The parent then joins the application's primary-locale labels before a
|
|
@@ -121,6 +138,15 @@ interface OpenApiGenerationInputSubprocessOutput {
|
|
|
121
138
|
* projector's wire shape; see `openapi-generation-input.behavior.ts`.
|
|
122
139
|
*/
|
|
123
140
|
resourceTags: ResourceTag[];
|
|
141
|
+
/**
|
|
142
|
+
* Which of those resources come from the application's OWN registry rather than the core map.
|
|
143
|
+
*
|
|
144
|
+
* Optional on this mirror, and read with a `?? []` at the call site, because the parent must not
|
|
145
|
+
* import subprocess code: an older projector build reaching a newer parent is a real state
|
|
146
|
+
* during a watch cycle, and it should publish documentation with no domain section rather than
|
|
147
|
+
* throw on a field it has never heard of.
|
|
148
|
+
*/
|
|
149
|
+
applicationOwnedResourceIdentifiers?: string[];
|
|
124
150
|
stats: OpenApiGenerationProjectorStats;
|
|
125
151
|
}
|
|
126
152
|
|
|
@@ -147,13 +173,17 @@ export class TechnicalDocCompanionService {
|
|
|
147
173
|
|
|
148
174
|
|
|
149
175
|
/**
|
|
150
|
-
* Produces one
|
|
151
|
-
*
|
|
152
|
-
* The caller selects the environment backend service; the
|
|
153
|
-
* the environment identity and source-derived
|
|
154
|
-
*
|
|
155
|
-
*
|
|
156
|
-
*
|
|
176
|
+
* Produces one private derivation, including the resolved organization-role
|
|
177
|
+
* inventory and the chapters the application authored, and its public
|
|
178
|
+
* pre-render bundle. The caller selects the environment backend service; the
|
|
179
|
+
* companion resolves the environment identity and source-derived
|
|
180
|
+
* operation-exposure evidence.
|
|
181
|
+
*
|
|
182
|
+
* The ONE application-family input is the documentation-chapter pair — the
|
|
183
|
+
* accepted plan and the chapter bodies joined to it (#874), read from the
|
|
184
|
+
* specifications package's companion exports. It never selects documentation
|
|
185
|
+
* on the application's behalf: an authored page exists because the
|
|
186
|
+
* application's own plan declares it.
|
|
157
187
|
*/
|
|
158
188
|
public async deriveApplicationDocumentationBundles(
|
|
159
189
|
input: TechnicalDocumentationEnvironmentIdentityInput,
|
|
@@ -165,14 +195,143 @@ export class TechnicalDocCompanionService {
|
|
|
165
195
|
excludedCoreResourceTypes ? [...excludedCoreResourceTypes].sort() : undefined,
|
|
166
196
|
);
|
|
167
197
|
const organizationRoles = await this.resolveApplicationOrganizationRoles(input.backendServiceKey, subprocessOutput.organizationRoles);
|
|
198
|
+
return this.deriveFromProjection(input, subprocessOutput, technicalDocConfig, organizationRoles);
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/**
|
|
202
|
+
* The ONE assembly of a derivation's inputs, shared by the bundle route and by managed publication
|
|
203
|
+
* so the two cannot disagree about what the portal is derived from — including the application's
|
|
204
|
+
* authored documentation chapters (#874), which reach the derivation only through here.
|
|
205
|
+
*/
|
|
206
|
+
private async deriveFromProjection(
|
|
207
|
+
input: TechnicalDocumentationEnvironmentIdentityInput,
|
|
208
|
+
subprocessOutput: OpenApiGenerationInputSubprocessOutput,
|
|
209
|
+
technicalDocConfig: WildoTechnicalDocConfig,
|
|
210
|
+
organizationRoles: Awaited<ReturnType<TechnicalDocCompanionService['resolveApplicationOrganizationRoles']>>,
|
|
211
|
+
): Promise<TechnicalDocumentationApplicationDerivationResult> {
|
|
168
212
|
return this.applicationDerivationService.deriveAuthorizedBundles({
|
|
169
213
|
...input,
|
|
170
|
-
operations: subprocessOutput.operations,
|
|
214
|
+
operations: applyAuthoredRoleLabelsToOperationAccess(subprocessOutput.operations, TechnicalDocCompanionService.roleLabels(organizationRoles)),
|
|
171
215
|
hasConfiguredMcpToolOperations: subprocessOutput.hasConfiguredMcpToolOperations,
|
|
172
216
|
hasConfiguredA2aSkills: subprocessOutput.hasConfiguredA2aSkills,
|
|
173
217
|
organizationRoles,
|
|
174
218
|
organizationUnitAwareResources: subprocessOutput.organizationUnitAwareResources,
|
|
219
|
+
...this.resolveApplicationConnectionInputs(technicalDocConfig),
|
|
220
|
+
authentication: this.resolveApplicationAuthenticationInputs(),
|
|
221
|
+
integration: { mcpTools: subprocessOutput.mcpTools, webhookEvents: subprocessOutput.webhookEvents },
|
|
222
|
+
/*
|
|
223
|
+
* The CATEGORISED tags, not the raw ones. The categoriser is what attaches the application's
|
|
224
|
+
* own grouping and validates it (every published resource named exactly once, no unknown
|
|
225
|
+
* names), so passing the raw list would silently drop the grouping and put the whole domain
|
|
226
|
+
* in one unnamed pile.
|
|
227
|
+
*/
|
|
228
|
+
resourceTags: applyApiReferenceResourceCategories(subprocessOutput.resourceTags, technicalDocConfig.apiReferenceResourceCategories),
|
|
229
|
+
applicationOwnedResourceIdentifiers: subprocessOutput.applicationOwnedResourceIdentifiers ?? [],
|
|
230
|
+
...await this.resolveAuthoredDocumentationChapters(),
|
|
231
|
+
});
|
|
232
|
+
}
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* The application's documentation plan and its authored chapter bodies (#874), exactly as the
|
|
236
|
+
* specifications package exports them. Parsed by the engine projector, not here.
|
|
237
|
+
*
|
|
238
|
+
* Read from the WORKING TREE — `loadSpecificationsCompanionExports` evaluates what the developer is
|
|
239
|
+
* writing — exactly as every other specification-derived page is, so an uncommitted chapter can be
|
|
240
|
+
* previewed. Acceptance is git's, not this method's: a chapter is accepted when its source and the
|
|
241
|
+
* regenerated portal output are committed together.
|
|
242
|
+
*
|
|
243
|
+
* An application with no specifications package has authored nothing, and publishes its derived
|
|
244
|
+
* pages alone. One that HAS a package that fails to load is a refusal rather than an absence:
|
|
245
|
+
* publishing without its chapters would silently drop pages the application accepted.
|
|
246
|
+
*/
|
|
247
|
+
private async resolveAuthoredDocumentationChapters(): Promise<{
|
|
248
|
+
readonly documentationPlan?: unknown;
|
|
249
|
+
readonly documentationChapters?: unknown;
|
|
250
|
+
}> {
|
|
251
|
+
if (!this.companionContext.resolvedSpecifications) return {};
|
|
252
|
+
const specifications = await loadSpecificationsCompanionExports(this.companionContext);
|
|
253
|
+
return {
|
|
254
|
+
...(specifications.documentationPlan === undefined ? {} : { documentationPlan: specifications.documentationPlan }),
|
|
255
|
+
...(specifications.documentationChapters === undefined ? {} : { documentationChapters: specifications.documentationChapters }),
|
|
256
|
+
};
|
|
257
|
+
}
|
|
258
|
+
|
|
259
|
+
/**
|
|
260
|
+
* The application facts the documentation names instead of hedging: the product's own name and
|
|
261
|
+
* the base URLs it publishes.
|
|
262
|
+
*
|
|
263
|
+
* The name is what a customer calls the product — `displayName` from `wildo.saas.config.ts`,
|
|
264
|
+
* falling back to the application's `name`. Deliberately NOT `publicMarketingTitle`: that is the documentation SITE's
|
|
265
|
+
* title ("Your Application — Technical Documentation") and reads wrong inside a sentence.
|
|
266
|
+
*
|
|
267
|
+
* The base URLs are the ones the application already authors for its API reference, so the
|
|
268
|
+
* guides and the reference name the same origins by construction.
|
|
269
|
+
*/
|
|
270
|
+
private resolveApplicationConnectionInputs(technicalDocConfig: WildoTechnicalDocConfig): {
|
|
271
|
+
applicationName: string;
|
|
272
|
+
apiServers: readonly ApplicationConnectionServer[];
|
|
273
|
+
} {
|
|
274
|
+
const saasConfig = this.companionContext.saasConfig;
|
|
275
|
+
const applicationName = saasConfig.displayName?.trim() || saasConfig.name.trim();
|
|
276
|
+
if (applicationName.length === 0) {
|
|
277
|
+
throw new Error('technical-documentation requires the application to declare a name (displayName or name in wildo.saas.config.ts)');
|
|
278
|
+
}
|
|
279
|
+
return {
|
|
280
|
+
applicationName,
|
|
281
|
+
apiServers: (technicalDocConfig.apiServers ?? []).map((server) => ({
|
|
282
|
+
url: server.url,
|
|
283
|
+
...(server.description === undefined ? {} : { description: server.description }),
|
|
284
|
+
})),
|
|
285
|
+
};
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* The sign-in policy this application actually applies, per user type.
|
|
290
|
+
*
|
|
291
|
+
* Read from `userTypes[<key>].auth`, which is where all authentication policy lives — there are
|
|
292
|
+
* no global defaults. Enabled methods go through `getEnabledMethods`, the same helper the runtime
|
|
293
|
+
* uses, rather than re-reading the boolean-or-object shorthand here; and they are ordered by the
|
|
294
|
+
* engine's own enum so two applications list the same methods in the same order.
|
|
295
|
+
*/
|
|
296
|
+
private resolveApplicationAuthenticationInputs(): ApplicationAuthenticationDocumentationSource {
|
|
297
|
+
const userTypes = Object.entries(this.appConfigService.config.userTypes ?? {}).map(([userTypeKey, definition]) => {
|
|
298
|
+
const auth = definition.auth;
|
|
299
|
+
const enabled = getEnabledMethods(auth.authMethodsEnabled);
|
|
300
|
+
return {
|
|
301
|
+
userTypeKey,
|
|
302
|
+
enabledMethods: Object.values(AuthMethod).filter((method) => enabled.has(method)),
|
|
303
|
+
multifactor: {
|
|
304
|
+
required: auth.mfaPolicy.requireMFA,
|
|
305
|
+
strongRequired: auth.mfaPolicy.requireStrongMFA,
|
|
306
|
+
enrollmentGracePeriodDays: auth.mfaPolicy.enrollmentGracePeriodDays,
|
|
307
|
+
passkeyExemptFromMultifactor: auth.mfaPolicy.passkeyExemptFromMFA,
|
|
308
|
+
...(auth.mfaPolicy.acceptableMFAMethods === undefined ? {} : { acceptableMethods: auth.mfaPolicy.acceptableMFAMethods }),
|
|
309
|
+
},
|
|
310
|
+
password: {
|
|
311
|
+
minLength: auth.passwordPolicy.minLength,
|
|
312
|
+
maxLength: auth.passwordPolicy.maxLength,
|
|
313
|
+
requireUppercase: auth.passwordPolicy.requireUppercase,
|
|
314
|
+
requireLowercase: auth.passwordPolicy.requireLowercase,
|
|
315
|
+
requireNumbers: auth.passwordPolicy.requireNumbers,
|
|
316
|
+
requireSpecialChars: auth.passwordPolicy.requireSpecialChars,
|
|
317
|
+
expiryDays: auth.passwordPolicy.expiryDays,
|
|
318
|
+
},
|
|
319
|
+
session: {
|
|
320
|
+
durationMinutes: auth.sessionDurationMinutes,
|
|
321
|
+
...(auth.maxConcurrentSessions === undefined ? {} : { maxConcurrentSessions: auth.maxConcurrentSessions }),
|
|
322
|
+
},
|
|
323
|
+
lockout: {
|
|
324
|
+
maxLoginAttempts: auth.lockoutPolicy.maxLoginAttempts,
|
|
325
|
+
lockoutDurationMinutes: auth.lockoutPolicy.lockoutDurationMinutes,
|
|
326
|
+
progressive: auth.lockoutPolicy.progressiveLockout,
|
|
327
|
+
maxProgressiveLockoutHours: auth.lockoutPolicy.maxProgressiveLockoutHours,
|
|
328
|
+
},
|
|
329
|
+
};
|
|
175
330
|
});
|
|
331
|
+
if (userTypes.length === 0) {
|
|
332
|
+
throw new Error('technical-documentation requires the application to declare at least one user type');
|
|
333
|
+
}
|
|
334
|
+
return { userTypes };
|
|
176
335
|
}
|
|
177
336
|
|
|
178
337
|
/**
|
|
@@ -201,24 +360,73 @@ export class TechnicalDocCompanionService {
|
|
|
201
360
|
createConservedApiReferenceModel(section);
|
|
202
361
|
}
|
|
203
362
|
const apiReferenceLinkIndex = createApiReferenceLinkIndex(generated.documents.sections);
|
|
363
|
+
/*
|
|
364
|
+
* BEFORE anything is written: an authored chapter citing a contract the rendered reference does
|
|
365
|
+
* not carry fails the whole publication, where an engine page's missing target merely degrades
|
|
366
|
+
* below. The asymmetry is deliberate and explained at the assertion.
|
|
367
|
+
*/
|
|
368
|
+
assertApplicationDocumentationChapterApiReferencesResolve(generated.derivation.publicBundle, apiReferenceLinkIndex);
|
|
369
|
+
if (generated.derivation.plannedChapterRefsWithoutBody.length > 0) {
|
|
370
|
+
this.logger.warn('technical-documentation: planned chapters with no authored body are not published yet', {
|
|
371
|
+
chapterRefs: generated.derivation.plannedChapterRefsWithoutBody,
|
|
372
|
+
authoredIn: 'specifications/src/technical-documentation/index.ts',
|
|
373
|
+
});
|
|
374
|
+
}
|
|
375
|
+
if (generated.derivation.authoredChapterRefsWithoutPlan.length > 0) {
|
|
376
|
+
this.logger.warn('technical-documentation: authored chapters the documentation plan does not declare are withheld', {
|
|
377
|
+
chapterRefs: generated.derivation.authoredChapterRefsWithoutPlan,
|
|
378
|
+
declareIn: 'specifications/src/documentation-plan/index.ts',
|
|
379
|
+
});
|
|
380
|
+
}
|
|
204
381
|
const publisher = new TechnicalDocumentationPilotCompanionService(this.companionContext.saasRoot);
|
|
205
382
|
await publisher.publishOpenApiDocuments({
|
|
206
383
|
documents: generated.documents,
|
|
207
384
|
sourceUnitRefs: [`technical-documentation:source/openapi/${this.companionContext.saasConfig.slug}`],
|
|
208
385
|
});
|
|
209
386
|
|
|
210
|
-
|
|
387
|
+
/*
|
|
388
|
+
* A guide may link to an API-reference target this application does not publish — the engine
|
|
389
|
+
* hardcodes 43 `apiReferenceTargets` naming engine resources an application may feature-gate
|
|
390
|
+
* off. Those links DEGRADE to plain text and the rest of the portal publishes (#472).
|
|
391
|
+
*
|
|
392
|
+
* Reporting is the half that keeps the degradation from becoming the next silent gap: every
|
|
393
|
+
* dropped target is collected here and named after publication, so an author sees which links
|
|
394
|
+
* their configuration removed rather than discovering a thinner portal.
|
|
395
|
+
*/
|
|
396
|
+
const degradedApiReferenceTargets: string[] = [];
|
|
397
|
+
const resolveApiReferenceTarget = (target: TechnicalDocumentationApiReferenceTargetV1): string | null => {
|
|
398
|
+
if (getTechnicalDocumentationApiReferenceTargetAvailability(apiReferenceLinkIndex, target)
|
|
399
|
+
=== TechnicalDocumentationApiReferenceTargetAvailability.UNAVAILABLE) {
|
|
400
|
+
degradedApiReferenceTargets.push(JSON.stringify(target));
|
|
401
|
+
return null;
|
|
402
|
+
}
|
|
403
|
+
return resolveTechnicalDocumentationApiReferenceLink(apiReferenceLinkIndex, target);
|
|
404
|
+
};
|
|
405
|
+
|
|
406
|
+
const publication = await publisher.generateValidateAndPublish({
|
|
211
407
|
derivation: generated.derivation,
|
|
212
408
|
supportedApiVersion: technicalDocConfig.supportedApiVersion,
|
|
213
409
|
forbiddenPublicSentinels: resolveTechnicalDocumentationForbiddenPublicSentinels(
|
|
214
410
|
technicalDocConfig.forbiddenPublicSentinels,
|
|
215
411
|
),
|
|
216
412
|
budgets: resolveTechnicalDocumentationOutputBudgets(technicalDocConfig.outputBudgets),
|
|
217
|
-
resolveApiReferenceTarget
|
|
413
|
+
resolveApiReferenceTarget,
|
|
218
414
|
...(input.refuseProvisionalAssets === undefined
|
|
219
415
|
? {}
|
|
220
416
|
: { refuseProvisionalAssets: input.refuseProvisionalAssets }),
|
|
221
417
|
});
|
|
418
|
+
|
|
419
|
+
if (degradedApiReferenceTargets.length > 0) {
|
|
420
|
+
// Deduplicated: one target linked from several guides is ONE configuration fact, and
|
|
421
|
+
// repeating it per link would bury the distinct ones.
|
|
422
|
+
const distinct = [...new Set(degradedApiReferenceTargets)].sort();
|
|
423
|
+
this.logger.warn('technical-documentation API-reference links degraded to plain text — this application does not publish these targets', {
|
|
424
|
+
count: distinct.length,
|
|
425
|
+
targets: distinct,
|
|
426
|
+
});
|
|
427
|
+
}
|
|
428
|
+
|
|
429
|
+
return publication;
|
|
222
430
|
}
|
|
223
431
|
|
|
224
432
|
/**
|
|
@@ -248,15 +456,12 @@ export class TechnicalDocCompanionService {
|
|
|
248
456
|
excludedCoreResourceTypes ? [...excludedCoreResourceTypes].sort() : undefined,
|
|
249
457
|
);
|
|
250
458
|
const organizationRoles = await this.resolveApplicationOrganizationRoles(input.backendServiceKey, subprocessOutput.organizationRoles);
|
|
251
|
-
const derivation = await this.
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
organizationUnitAwareResources: subprocessOutput.organizationUnitAwareResources,
|
|
258
|
-
});
|
|
259
|
-
const generationInput = this.assembleGenerationInput(subprocessOutput, technicalDocConfig);
|
|
459
|
+
const derivation = await this.deriveFromProjection(input, subprocessOutput, technicalDocConfig, organizationRoles);
|
|
460
|
+
const generationInput = this.assembleGenerationInput(
|
|
461
|
+
subprocessOutput,
|
|
462
|
+
technicalDocConfig,
|
|
463
|
+
TechnicalDocCompanionService.roleLabels(organizationRoles),
|
|
464
|
+
);
|
|
260
465
|
|
|
261
466
|
return Object.freeze({
|
|
262
467
|
derivation,
|
|
@@ -293,7 +498,11 @@ export class TechnicalDocCompanionService {
|
|
|
293
498
|
technicalDocConfig.apiDocResources,
|
|
294
499
|
excludedCoreResourceTypes ? [...excludedCoreResourceTypes].sort() : undefined,
|
|
295
500
|
);
|
|
296
|
-
const generationInput = this.assembleGenerationInput(
|
|
501
|
+
const generationInput = this.assembleGenerationInput(
|
|
502
|
+
subprocessOutput,
|
|
503
|
+
technicalDocConfig,
|
|
504
|
+
await this.resolveRoleLabelsBestEffort(subprocessOutput.organizationRoles),
|
|
505
|
+
);
|
|
297
506
|
const documents = generateOpenApiDocuments(generationInput);
|
|
298
507
|
|
|
299
508
|
this.logDebug('technical-doc generate-openapi — success', {
|
|
@@ -372,22 +581,31 @@ export class TechnicalDocCompanionService {
|
|
|
372
581
|
}
|
|
373
582
|
|
|
374
583
|
const data: unknown = introspection.data;
|
|
375
|
-
|
|
376
|
-
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
584
|
+
/*
|
|
585
|
+
* Collect EVERY unmet expectation rather than short-circuiting on the first, and name each one.
|
|
586
|
+
* The previous form was a single `||` chain whose message listed all eight expectations and
|
|
587
|
+
* identified none of them, so a real refusal — the row-conservation clause, once the projector
|
|
588
|
+
* grew a second producer of operations — presented as an opaque 500 and had to be re-derived by
|
|
589
|
+
* hand from a running companion. Which clause refused, and on which numbers, is knowable here.
|
|
590
|
+
*/
|
|
591
|
+
const violations: string[] = [];
|
|
592
|
+
if (!isPlainObject(data)) {
|
|
593
|
+
violations.push(`payload: expected an object, received ${describeReceivedValue(data)}`);
|
|
594
|
+
} else {
|
|
595
|
+
if (!Array.isArray(data.operations)) violations.push(`operations: expected OperationProjection[], received ${describeReceivedValue(data.operations)}`);
|
|
596
|
+
if (typeof data.hasConfiguredMcpToolOperations !== 'boolean') violations.push(`hasConfiguredMcpToolOperations: expected boolean, received ${describeReceivedValue(data.hasConfiguredMcpToolOperations)}`);
|
|
597
|
+
if (typeof data.hasConfiguredA2aSkills !== 'boolean') violations.push(`hasConfiguredA2aSkills: expected boolean, received ${describeReceivedValue(data.hasConfiguredA2aSkills)}`);
|
|
598
|
+
if (!isPlainObject(data.errorResponseSchema)) violations.push(`errorResponseSchema: expected object, received ${describeReceivedValue(data.errorResponseSchema)}`);
|
|
599
|
+
if (!Array.isArray(data.resourceTags)) violations.push(`resourceTags: expected ResourceTag[], received ${describeReceivedValue(data.resourceTags)}`);
|
|
600
|
+
if (!Array.isArray(data.organizationRoles)) violations.push(`organizationRoles: expected OrganizationRole[], received ${describeReceivedValue(data.organizationRoles)}`);
|
|
601
|
+
if (!Array.isArray(data.organizationUnitAwareResources)) violations.push(`organizationUnitAwareResources: expected OrganizationUnitAwareResource[], received ${describeReceivedValue(data.organizationUnitAwareResources)}`);
|
|
602
|
+
violations.push(...describeOpenApiGenerationProjectorStatsViolations(data.stats));
|
|
603
|
+
}
|
|
604
|
+
if (violations.length > 0) {
|
|
386
605
|
throw this.errorBuilder.buildError(ErrorType.INTERNAL, undefined, {
|
|
387
606
|
customMessageReference: ErrorCustomMessageReference.INTERNAL,
|
|
388
607
|
context: {
|
|
389
|
-
message:
|
|
390
|
-
+ '`{ operations: OperationProjection[], hasConfiguredMcpToolOperations: boolean, hasConfiguredA2aSkills: boolean, organizationRoles: OrganizationRole[], organizationUnitAwareResources: OrganizationUnitAwareResource[], errorResponseSchema: object, resourceTags: ResourceTag[], stats: { ... } }`.',
|
|
608
|
+
message: `openapi-generation-input subprocess returned a malformed payload — ${violations.join('; ')}`,
|
|
391
609
|
},
|
|
392
610
|
});
|
|
393
611
|
}
|
|
@@ -417,6 +635,7 @@ export class TechnicalDocCompanionService {
|
|
|
417
635
|
private assembleGenerationInput(
|
|
418
636
|
subprocessOutput: OpenApiGenerationInputSubprocessOutput,
|
|
419
637
|
technicalDocConfig: WildoTechnicalDocConfig,
|
|
638
|
+
roleLabelsByRole: Readonly<Record<string, string>>,
|
|
420
639
|
): OpenApiGenerationInput {
|
|
421
640
|
const saasConfig = this.companionContext.saasConfig;
|
|
422
641
|
const candidateInput: OpenApiGenerationInput = {
|
|
@@ -426,7 +645,7 @@ export class TechnicalDocCompanionService {
|
|
|
426
645
|
...(technicalDocConfig.publicMarketingTitle
|
|
427
646
|
? { publicMarketingTitle: technicalDocConfig.publicMarketingTitle }
|
|
428
647
|
: {}),
|
|
429
|
-
operations: subprocessOutput.operations,
|
|
648
|
+
operations: [...applyAuthoredRoleLabelsToOperationAccess(subprocessOutput.operations, roleLabelsByRole)],
|
|
430
649
|
errorResponseSchema: subprocessOutput.errorResponseSchema,
|
|
431
650
|
...(subprocessOutput.resourceTags && subprocessOutput.resourceTags.length > 0
|
|
432
651
|
? { resourceTags: applyApiReferenceResourceCategories(subprocessOutput.resourceTags, technicalDocConfig.apiReferenceResourceCategories) }
|
|
@@ -548,7 +767,12 @@ export class TechnicalDocCompanionService {
|
|
|
548
767
|
|
|
549
768
|
let loaded: WildoTechnicalDocConfig;
|
|
550
769
|
try {
|
|
551
|
-
|
|
770
|
+
// `freshModuleCache` is what makes the docblock's "evaluated for every request" true. Calling
|
|
771
|
+
// `loadConfig` again is NOT enough on its own: jiti's module cache is process-global, so
|
|
772
|
+
// without this the second evaluation returns the first one's result and a valid taxonomy,
|
|
773
|
+
// server or overview edit stays invisible until an unrelated restart — precisely the outcome
|
|
774
|
+
// the contract above rejects. Same defect as issue #170, different read site.
|
|
775
|
+
loaded = await loadConfig<WildoTechnicalDocConfig>(techDocConfigPath, { freshModuleCache: true });
|
|
552
776
|
} catch (e) {
|
|
553
777
|
throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
|
|
554
778
|
customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
|
|
@@ -572,6 +796,37 @@ export class TechnicalDocCompanionService {
|
|
|
572
796
|
* member-management interface, so an incomplete label unit blocks
|
|
573
797
|
* publication instead of falling back to a prettified role token.
|
|
574
798
|
*/
|
|
799
|
+
/**
|
|
800
|
+
* The authored label per role, as the join needs it.
|
|
801
|
+
*
|
|
802
|
+
* Reached only AFTER {@link resolveApplicationOrganizationRoles}, which refuses a role whose
|
|
803
|
+
* primary-locale label the application has not generated — so on this path every role has one.
|
|
804
|
+
*/
|
|
805
|
+
private static roleLabels(roles: readonly { readonly role: string; readonly label: string }[]): Readonly<Record<string, string>> {
|
|
806
|
+
return Object.fromEntries(roles.map((role) => [role.role, role.label]));
|
|
807
|
+
}
|
|
808
|
+
|
|
809
|
+
/**
|
|
810
|
+
* The same labels for the READ door, WITHOUT the refusal.
|
|
811
|
+
*
|
|
812
|
+
* `generateOpenApiDocuments` generates a document and writes nothing. Failing it closed because an
|
|
813
|
+
* application has not generated its role labels yet would make a read unavailable for an authoring
|
|
814
|
+
* gap whose remedy is elsewhere — a read path must never fail closed on something whose remedy it
|
|
815
|
+
* cannot reach. Publication keeps the refusal, which is where it belongs; here a role with
|
|
816
|
+
* no authored label keeps its token.
|
|
817
|
+
*/
|
|
818
|
+
private async resolveRoleLabelsBestEffort(roles: readonly ApplicationOrganizationRoleDocumentationSource[]): Promise<Readonly<Record<string, string>>> {
|
|
819
|
+
try {
|
|
820
|
+
const resolved = await this.resolveApplicationOrganizationRoles(this.pickProjectorCarrierServiceKey(), roles);
|
|
821
|
+
return TechnicalDocCompanionService.roleLabels(resolved);
|
|
822
|
+
} catch (error) {
|
|
823
|
+
this.logDebug('technical-doc generate-openapi — role labels unavailable, roles keep their tokens', {
|
|
824
|
+
reason: describeCaughtError(error),
|
|
825
|
+
});
|
|
826
|
+
return {};
|
|
827
|
+
}
|
|
828
|
+
}
|
|
829
|
+
|
|
575
830
|
private async resolveApplicationOrganizationRoles(
|
|
576
831
|
backendServiceKey: string,
|
|
577
832
|
roles: readonly ApplicationOrganizationRoleDocumentationSource[],
|
|
@@ -614,13 +869,6 @@ export class TechnicalDocCompanionService {
|
|
|
614
869
|
}
|
|
615
870
|
return backendServiceKey;
|
|
616
871
|
}
|
|
617
|
-
|
|
618
|
-
private pickFrontendApplicationServiceKey(): string {
|
|
619
|
-
const frontendServiceKey = Object.entries(this.companionContext.servicesByKey)
|
|
620
|
-
.find(([, service]) => service.frontendType === AppFrontendType.SAAS_APP)?.[0];
|
|
621
|
-
if (!frontendServiceKey) throw new Error('technical-documentation frontend runtime evidence requires one SAAS_APP service');
|
|
622
|
-
return frontendServiceKey;
|
|
623
|
-
}
|
|
624
872
|
}
|
|
625
873
|
|
|
626
874
|
/**
|
|
@@ -634,6 +882,18 @@ export class TechnicalDocCompanionService {
|
|
|
634
882
|
* Once an application elects to declare categories, an exact inventory join is
|
|
635
883
|
* required: an uncategorised new resource or a stale config name must stop
|
|
636
884
|
* publication instead of quietly producing a misleading partial navigation.
|
|
885
|
+
*
|
|
886
|
+
* The completeness rule is about the RESULT, not about this config: a resource
|
|
887
|
+
* satisfies it either by being assigned here or by already carrying the
|
|
888
|
+
* engine's own sub-domain category (`projectResourceTag`). That distinction is
|
|
889
|
+
* what makes the declaration usable at all — a generated application publishes
|
|
890
|
+
* roughly eight resources of its own beside fifty-two of the engine's, so a
|
|
891
|
+
* rule demanding the config name every one of them means an application must
|
|
892
|
+
* hand-classify the engine's catalogue, and re-classify it whenever the engine
|
|
893
|
+
* grows. Wonder CRM opted out entirely for that reason and rendered its whole
|
|
894
|
+
* reference as one flat list. An explicit assignment still WINS over the
|
|
895
|
+
* engine's default, so an application that wants its own product-shaped
|
|
896
|
+
* taxonomy across engine and application resources keeps it.
|
|
637
897
|
*/
|
|
638
898
|
export function applyApiReferenceResourceCategories(
|
|
639
899
|
resourceTags: readonly ResourceTag[],
|
|
@@ -643,7 +903,12 @@ export function applyApiReferenceResourceCategories(
|
|
|
643
903
|
const tagsByName = new Map(resourceTags.map((tag) => [tag.name, tag]));
|
|
644
904
|
if (tagsByName.size !== resourceTags.length) throw new Error('OpenAPI resource tags must be unique before category assignment');
|
|
645
905
|
|
|
646
|
-
|
|
906
|
+
/*
|
|
907
|
+
* `NonNullable<…>` before `[number]`: the config field is OPTIONAL, so its type is
|
|
908
|
+
* `Array | undefined` and indexing `| undefined` with `[number]` is not a thing (#352). The guard
|
|
909
|
+
* three lines up narrows the VALUE, which a type expression cannot see.
|
|
910
|
+
*/
|
|
911
|
+
const categoryByResourceName = new Map<string, NonNullable<WildoTechnicalDocConfig['apiReferenceResourceCategories']>[number]>();
|
|
647
912
|
const categoryIds = new Set<string>();
|
|
648
913
|
const unavailableResourceNames: string[] = [];
|
|
649
914
|
for (const category of categories) {
|
|
@@ -662,12 +927,16 @@ export function applyApiReferenceResourceCategories(
|
|
|
662
927
|
if (unavailableResourceNames.length > 0) {
|
|
663
928
|
throw new Error(`API-reference categories name unavailable resources: ${unavailableResourceNames.sort().join(', ')}`);
|
|
664
929
|
}
|
|
665
|
-
const
|
|
666
|
-
|
|
667
|
-
|
|
930
|
+
const uncategorisedResourceNames = resourceTags
|
|
931
|
+
.filter((tag) => !categoryByResourceName.has(tag.name) && tag.category === undefined)
|
|
932
|
+
.map((tag) => tag.name)
|
|
933
|
+
.sort();
|
|
934
|
+
if (uncategorisedResourceNames.length > 0) {
|
|
935
|
+
throw new Error(`API-reference resources have no category, from this config or from the engine: ${uncategorisedResourceNames.join(', ')}`);
|
|
668
936
|
}
|
|
669
937
|
return resourceTags.map((tag) => {
|
|
670
|
-
const category = categoryByResourceName.get(tag.name)
|
|
938
|
+
const category = categoryByResourceName.get(tag.name);
|
|
939
|
+
if (category === undefined) return { ...tag };
|
|
671
940
|
return {
|
|
672
941
|
...tag,
|
|
673
942
|
category: {
|
|
@@ -693,8 +962,20 @@ function isNonNegativeInteger(value: unknown): value is number {
|
|
|
693
962
|
* flattening it; this parent-side join prevents a future projector filter,
|
|
694
963
|
* collapse or mapper change from merely adjusting a count while dropping the
|
|
695
964
|
* operation that the count represented.
|
|
965
|
+
*
|
|
966
|
+
* TOTAL OVER THE PROJECTOR'S PRODUCERS, and that is the part that has to be
|
|
967
|
+
* maintained. The registry inventory is a bijection onto its own rows; the
|
|
968
|
+
* manual controller-route catalog contributes rows that are deliberately not in
|
|
969
|
+
* that inventory and are counted separately. So the identity is
|
|
970
|
+
* `registry + manual = payload`, with every registry entry present. Written
|
|
971
|
+
* flat (`registry = payload`) it silently became false the day the manual
|
|
972
|
+
* family was added, and refused every publication in the whole fleet.
|
|
973
|
+
*
|
|
974
|
+
* A future third producer belongs in this sum as its own named term. Do NOT
|
|
975
|
+
* relax the equality to an inequality or a subset test to accommodate one — the
|
|
976
|
+
* whole value of this join is that a dropped operation cannot hide inside slack.
|
|
696
977
|
*/
|
|
697
|
-
function assertResolvedHttpOperationProjectionConservation(output: OpenApiGenerationInputSubprocessOutput): void {
|
|
978
|
+
export function assertResolvedHttpOperationProjectionConservation(output: OpenApiGenerationInputSubprocessOutput): void {
|
|
698
979
|
const key = (entry: {
|
|
699
980
|
readonly identity: {
|
|
700
981
|
readonly contractVersion: number;
|
|
@@ -724,53 +1005,112 @@ function assertResolvedHttpOperationProjectionConservation(output: OpenApiGenera
|
|
|
724
1005
|
section: operation.consumerApiSection,
|
|
725
1006
|
roles: operation.roles,
|
|
726
1007
|
})));
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
1008
|
+
const manualRowCount = output.stats.manualControllerRouteRowCount;
|
|
1009
|
+
const violations: string[] = [];
|
|
1010
|
+
if (source.size !== output.stats.resolvedExternalHttpOperations.length) {
|
|
1011
|
+
violations.push(
|
|
1012
|
+
`stats.resolvedExternalHttpOperations contains duplicate identities: ${output.stats.resolvedExternalHttpOperations.length} entries collapse to ${source.size} distinct keys`,
|
|
1013
|
+
);
|
|
1014
|
+
}
|
|
1015
|
+
if (projections.size !== output.operations.length) {
|
|
1016
|
+
violations.push(
|
|
1017
|
+
`operations contains duplicate identities: ${output.operations.length} rows collapse to ${projections.size} distinct keys`,
|
|
1018
|
+
);
|
|
1019
|
+
}
|
|
1020
|
+
if (projections.size !== source.size + manualRowCount) {
|
|
1021
|
+
violations.push(
|
|
1022
|
+
`row conservation: ${projections.size} distinct projected rows ≠ ${source.size} registry-resolved + ${manualRowCount} manual controller-route rows (${source.size + manualRowCount})`,
|
|
1023
|
+
);
|
|
1024
|
+
}
|
|
1025
|
+
const dropped = [...source].filter((entry) => !projections.has(entry));
|
|
1026
|
+
if (dropped.length > 0) {
|
|
1027
|
+
violations.push(
|
|
1028
|
+
`${dropped.length} registry-resolved HTTP operation(s) reached no projection row; first: ${dropped[0]}`,
|
|
1029
|
+
);
|
|
1030
|
+
}
|
|
1031
|
+
if (violations.length > 0) {
|
|
1032
|
+
throw new Error(
|
|
1033
|
+
`openapi-generation-input subprocess violated resolved HTTP operation → projection conservation — ${violations.join('; ')}`,
|
|
1034
|
+
);
|
|
734
1035
|
}
|
|
735
1036
|
}
|
|
736
1037
|
|
|
737
|
-
/**
|
|
738
|
-
|
|
739
|
-
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
743
|
-
|
|
744
|
-
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
|
|
1038
|
+
/**
|
|
1039
|
+
* Validate the complete diagnostics object received from the subprocess, and
|
|
1040
|
+
* REPORT WHICH EXPECTATION FAILED.
|
|
1041
|
+
*
|
|
1042
|
+
* This used to be a boolean type predicate feeding one `||` chain, so the
|
|
1043
|
+
* caller could only say that some one of eight expectations was unmet. When the
|
|
1044
|
+
* payload really did stop conserving rows, establishing WHICH clause refused
|
|
1045
|
+
* cost a companion log, an auth token, a hand-driven introspection call and a
|
|
1046
|
+
* predicate-by-predicate comparison — for a fact the guard held in its hand at
|
|
1047
|
+
* the moment it threw. A guard that refuses without naming the failed clause
|
|
1048
|
+
* charges an investigation every time it fires, so this returns the clause and
|
|
1049
|
+
* its two numbers instead.
|
|
1050
|
+
*
|
|
1051
|
+
* @returns one message per unmet expectation; empty means the value is a
|
|
1052
|
+
* well-formed {@link OpenApiGenerationProjectorStats}.
|
|
1053
|
+
*/
|
|
1054
|
+
export function describeOpenApiGenerationProjectorStatsViolations(value: unknown): string[] {
|
|
1055
|
+
if (!isPlainObject(value)) return [`stats: expected an object, received ${describeReceivedValue(value)}`];
|
|
1056
|
+
|
|
1057
|
+
const violations: string[] = [];
|
|
1058
|
+
const requireNonNegativeInteger = (field: keyof OpenApiGenerationProjectorStats): boolean => {
|
|
1059
|
+
if (isNonNegativeInteger(value[field])) return true;
|
|
1060
|
+
violations.push(`stats.${field}: expected a non-negative integer, received ${describeReceivedValue(value[field])}`);
|
|
1061
|
+
return false;
|
|
1062
|
+
};
|
|
1063
|
+
const requireArray = (field: string): boolean => {
|
|
1064
|
+
if (Array.isArray(value[field])) return true;
|
|
1065
|
+
violations.push(`stats.${field}: expected an array, received ${describeReceivedValue(value[field])}`);
|
|
748
1066
|
return false;
|
|
1067
|
+
};
|
|
1068
|
+
|
|
1069
|
+
const hasProjectedRowCount = requireNonNegativeInteger('projectedRowCount');
|
|
1070
|
+
const hasManualRowCount = requireNonNegativeInteger('manualControllerRouteRowCount');
|
|
1071
|
+
requireNonNegativeInteger('resourceCount');
|
|
1072
|
+
requireNonNegativeInteger('consideredOperationCount');
|
|
1073
|
+
requireNonNegativeInteger('skippedOperationWithoutInitiatorInfosCount');
|
|
1074
|
+
const hasResolvedOperations = requireArray('resolvedExternalHttpOperations');
|
|
1075
|
+
const hasSkippedOperations = requireArray('skippedOperationsWithoutInitiatorInfos');
|
|
1076
|
+
|
|
1077
|
+
if (hasResolvedOperations && hasManualRowCount && hasProjectedRowCount) {
|
|
1078
|
+
/*
|
|
1079
|
+
* The projector has TWO producers of `OperationProjection` rows and this is where their sum is
|
|
1080
|
+
* checked, so the message names all three terms. Compare the identity join in
|
|
1081
|
+
* `assertResolvedHttpOperationProjectionConservation`, which checks the same statement against
|
|
1082
|
+
* the actual rows rather than against the counts — a count can be adjusted, identities cannot.
|
|
1083
|
+
*/
|
|
1084
|
+
const resolved = (value.resolvedExternalHttpOperations as unknown[]).length;
|
|
1085
|
+
const manual = value.manualControllerRouteRowCount as number;
|
|
1086
|
+
const projected = value.projectedRowCount as number;
|
|
1087
|
+
if (resolved + manual !== projected) {
|
|
1088
|
+
violations.push(
|
|
1089
|
+
`stats row conservation: resolvedExternalHttpOperations (${resolved}) + manualControllerRouteRowCount (${manual}) = ${resolved + manual}, but projectedRowCount is ${projected}`,
|
|
1090
|
+
);
|
|
1091
|
+
}
|
|
749
1092
|
}
|
|
750
1093
|
|
|
751
|
-
if (
|
|
752
|
-
|
|
753
|
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
|
|
758
|
-
&& entry.roles.every((role) => typeof role === 'string'))
|
|
759
|
-
) {
|
|
760
|
-
return false;
|
|
1094
|
+
if (hasResolvedOperations && !(value.resolvedExternalHttpOperations as unknown[]).every((entry) =>
|
|
1095
|
+
isPlainObject(entry)
|
|
1096
|
+
&& isPlainObject(entry.identity)
|
|
1097
|
+
&& typeof entry.section === 'string'
|
|
1098
|
+
&& Array.isArray(entry.roles)
|
|
1099
|
+
&& entry.roles.every((role) => typeof role === 'string'))) {
|
|
1100
|
+
violations.push('stats.resolvedExternalHttpOperations: every entry must be `{ identity: object, section: string, roles: string[] }`');
|
|
761
1101
|
}
|
|
762
1102
|
|
|
763
|
-
if (
|
|
764
|
-
|
|
765
|
-
&& (
|
|
1103
|
+
if (value.excludedCoreResources !== undefined) {
|
|
1104
|
+
if (
|
|
766
1105
|
!Array.isArray(value.excludedCoreResources)
|
|
767
1106
|
|| !value.excludedCoreResources.every((entry) =>
|
|
768
1107
|
typeof entry === 'string' && Object.values(CoreResourceType).includes(entry as CoreResourceType))
|
|
769
|
-
)
|
|
770
|
-
|
|
771
|
-
|
|
1108
|
+
) {
|
|
1109
|
+
violations.push('stats.excludedCoreResources: expected an array of CoreResourceType values');
|
|
1110
|
+
}
|
|
772
1111
|
}
|
|
773
|
-
|
|
1112
|
+
|
|
1113
|
+
if (hasSkippedOperations && !(value.skippedOperationsWithoutInitiatorInfos as unknown[]).every((entry) =>
|
|
774
1114
|
isPlainObject(entry)
|
|
775
1115
|
&& typeof entry.resourceIdentifier === 'string'
|
|
776
1116
|
&& typeof entry.operationIdentifier === 'string'
|
|
@@ -778,20 +1118,20 @@ function isOpenApiGenerationProjectorStats(value: unknown): value is OpenApiGene
|
|
|
778
1118
|
&& (entry.variantKey === undefined || typeof entry.variantKey === 'string')
|
|
779
1119
|
&& (entry.isOperationDefault === undefined || typeof entry.isOperationDefault === 'boolean')
|
|
780
1120
|
&& (entry.isBulkOperation === undefined || typeof entry.isBulkOperation === 'boolean'))) {
|
|
781
|
-
|
|
1121
|
+
violations.push('stats.skippedOperationsWithoutInitiatorInfos: every entry must carry string `resourceIdentifier`, `operationIdentifier` and `variantType`');
|
|
782
1122
|
}
|
|
783
|
-
|
|
784
|
-
|
|
785
|
-
|
|
1123
|
+
|
|
1124
|
+
if (value.skippedCoreResources !== undefined) {
|
|
1125
|
+
if (
|
|
786
1126
|
!Array.isArray(value.skippedCoreResources)
|
|
787
1127
|
|| !value.skippedCoreResources.every((entry) => isPlainObject(entry) && typeof entry.resourceType === 'string' && typeof entry.reason === 'string')
|
|
788
|
-
)
|
|
789
|
-
|
|
790
|
-
|
|
1128
|
+
) {
|
|
1129
|
+
violations.push('stats.skippedCoreResources: expected an array of `{ resourceType: string, reason: string }`');
|
|
1130
|
+
}
|
|
791
1131
|
}
|
|
792
|
-
|
|
793
|
-
|
|
794
|
-
|
|
1132
|
+
|
|
1133
|
+
if (value.collapsedCoreOperations !== undefined) {
|
|
1134
|
+
if (
|
|
795
1135
|
!Array.isArray(value.collapsedCoreOperations)
|
|
796
1136
|
|| !value.collapsedCoreOperations.every((entry) =>
|
|
797
1137
|
isPlainObject(entry)
|
|
@@ -799,11 +1139,26 @@ function isOpenApiGenerationProjectorStats(value: unknown): value is OpenApiGene
|
|
|
799
1139
|
&& typeof entry.operationKey === 'string'
|
|
800
1140
|
&& typeof entry.httpVerb === 'string'
|
|
801
1141
|
&& typeof entry.path === 'string')
|
|
802
|
-
)
|
|
803
|
-
|
|
804
|
-
|
|
1142
|
+
) {
|
|
1143
|
+
violations.push('stats.collapsedCoreOperations: expected an array of `{ resourceType, operationKey, httpVerb, path }` strings');
|
|
1144
|
+
}
|
|
805
1145
|
}
|
|
806
1146
|
|
|
807
|
-
return
|
|
1147
|
+
return violations;
|
|
1148
|
+
}
|
|
1149
|
+
|
|
1150
|
+
/**
|
|
1151
|
+
* A short, safe rendering of a rejected value for a diagnostic message.
|
|
1152
|
+
*
|
|
1153
|
+
* Type plus a bounded preview: the point of the message is to tell the reader
|
|
1154
|
+
* whether the field is absent, the wrong type, or the right type with a wrong
|
|
1155
|
+
* value, and the first two are invisible if only the type is printed.
|
|
1156
|
+
*/
|
|
1157
|
+
function describeReceivedValue(value: unknown): string {
|
|
1158
|
+
if (value === undefined) return 'undefined (absent)';
|
|
1159
|
+
if (value === null) return 'null';
|
|
1160
|
+
if (Array.isArray(value)) return `an array of ${value.length}`;
|
|
1161
|
+
if (typeof value === 'object') return 'an object';
|
|
1162
|
+
return `${typeof value} ${JSON.stringify(value)?.slice(0, 40) ?? ''}`.trim();
|
|
808
1163
|
}
|
|
809
1164
|
```
|