@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
|
@@ -53,7 +53,7 @@ touch first:
|
|
|
53
53
|
Plus a fifth "deep" decision when something is wrong:
|
|
54
54
|
|
|
55
55
|
5. **Boot wiring** — understand the order of operations inside
|
|
56
|
-
|
|
56
|
+
the startup bootstrap (Level-A dispatch, Level-B
|
|
57
57
|
pre/post hooks per resource, LAZY pre-only guards per
|
|
58
58
|
`(resourceType, operation)`, platform-mode skip) so you can
|
|
59
59
|
explain why a seed fired, didn't fire, or fired in an unexpected
|
|
@@ -64,7 +64,7 @@ Plus a fifth "deep" decision when something is wrong:
|
|
|
64
64
|
| Surface | Glob (relative to app root) |
|
|
65
65
|
|---------|------------------------------------------------------------|
|
|
66
66
|
| App config (cron tick override) | `infrastructure/local/wildo.infra.local.config.ts` (and the `infrastructure/<env>/wildo.infra.<env>.config.ts` siblings for staging / prod) — populates `dataSeeding.scheduledRerunCronSchedule` on the resolved `AppConfiguration_Shared_Schema`. |
|
|
67
|
-
| Admin secret | `wildo-
|
|
67
|
+
| Admin secret | **FRAMEWORK-MANAGED — you do not author it.** `application.adminSecret` in the environment's `secrets.json` is minted (48 bytes) at `wildo setup` and filled in by the idempotent self-heal on any later `wildo config sync` / `wildo local dev`, so an environment that predates it acquires one without an operator typing anything. `wildo config sync` then emits it as `APPLICATION_ADMIN_SECRET` into the app backend's env — the local `.env`, the compose `env_file` and the k8s `{appSlug}-secret` alike, all from one producer. Read the value with `wildo secrets show` or out of the environment's `secrets.json`. NOT a typed field on `ApplicationEnvConfigurationSchema`: the two admin controllers read `process.env` directly so each surface stays self-contained to `saas-backend-lib`. |
|
|
68
68
|
| Module backend record (where `schedule?` is declared) | `backend-api/src/modules/<module>/seeds/<seed-key>.seed.ts` — same authoring file `seeding-authoring` covers; the `schedule?` block is one of the optional inputs to `createDataSeedDefinition({...})`. |
|
|
69
69
|
| Custom resolver registration | `backend-api/src/modules/<module>/index.ts` — the `dataSeedScopeResolvers?: Record<string, DataSeedScopeResolver>` slot on the typed `BackendDomainModule` (same record that carries `seeds`). Aggregated by `mergeBackendDomainModules` and threaded through `ApplicationInitializationConfig.dataSeedScopeResolvers`. |
|
|
70
70
|
| Curl runbook | n/a (operator action) — endpoint root is `/internal/admin/data-seeding`, header is `X-Admin-Secret: <APPLICATION_ADMIN_SECRET value>`. |
|
|
@@ -150,9 +150,9 @@ The five iteration strategies determine per-tick fan-out:
|
|
|
150
150
|
|----------|------------------|-------------------|
|
|
151
151
|
| `GLOBAL` | 1 dispatch (no anchor) | `GLOBAL` only |
|
|
152
152
|
| `ALL_APPLICATIONS` | 1 dispatch per `applications` row | `APPLICATION` |
|
|
153
|
-
| `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `
|
|
154
|
-
| `ALL_USERS` | 1 dispatch per `users` row | `
|
|
155
|
-
| `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value |
|
|
153
|
+
| `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `ORGANIZATION` only |
|
|
154
|
+
| `ALL_USERS` | 1 dispatch per `users` row | `USER` only |
|
|
155
|
+
| `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value | `APPLICATION`, `ORGANIZATION`, `USER`, `CUSTOM`; required for `CUSTOM` |
|
|
156
156
|
|
|
157
157
|
Anchoring (N8): the cron batch runs per-app under its own
|
|
158
158
|
application's process. `ALL_ORGANIZATIONS` and `ALL_USERS`
|
|
@@ -290,9 +290,11 @@ re-runs in the last 24 hours").
|
|
|
290
290
|
|
|
291
291
|
### Decision 5: Boot wiring (deep)
|
|
292
292
|
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
293
|
+
The bootstrap runs once during app startup, in two halves: steps 1–4
|
|
294
|
+
(`wireDataSeedingDeclarations`) before the HTTP server listens, steps 5–7
|
|
295
|
+
(`runDataSeedingApplicationLifecyclePasses`) at Step 7.7. The order matters;
|
|
296
|
+
understanding it explains every "why did this seed fire / not fire / fire
|
|
297
|
+
twice" question.
|
|
296
298
|
|
|
297
299
|
The bootstrap fires this sequence (each step's annotation explains
|
|
298
300
|
when it runs):
|
|
@@ -393,11 +395,13 @@ seed corpus and silently break downstream ops.
|
|
|
393
395
|
|
|
394
396
|
### Workflow D: Tune the engine cron tick
|
|
395
397
|
|
|
396
|
-
1.
|
|
397
|
-
|
|
398
|
-
2.
|
|
399
|
-
|
|
400
|
-
|
|
398
|
+
1. Review every seed's latency and frequency requirements, starting with
|
|
399
|
+
the most time-sensitive seed.
|
|
400
|
+
2. Choose an engine tick whose evaluation delay and coalescing are acceptable.
|
|
401
|
+
Both cron expressions use UTC. A minute seed on a five-minute engine tick
|
|
402
|
+
is due once per selected scope on that tick, not once for each minute.
|
|
403
|
+
The runtime tests the window `(enginePrevTickFire, tickAt]`; it does not
|
|
404
|
+
require an exact-time match or replay all missed occurrences after downtime.
|
|
401
405
|
3. Set `dataSeeding.scheduledRerunCronSchedule` on the
|
|
402
406
|
environment's `wildo.infra.<env>.config.ts` (the resolved
|
|
403
407
|
`AppConfiguration_Shared_Schema.dataSeeding`).
|
|
@@ -429,14 +433,15 @@ seed corpus and silently break downstream ops.
|
|
|
429
433
|
- [ ] Custom resolver registered in
|
|
430
434
|
`BackendDomainModule.dataSeedScopeResolvers` in the same
|
|
431
435
|
commit as the seed declaring it
|
|
432
|
-
- [ ] `APPLICATION_ADMIN_SECRET`
|
|
433
|
-
|
|
434
|
-
|
|
436
|
+
- [ ] `APPLICATION_ADMIN_SECRET` present in the app backend's env
|
|
437
|
+
(otherwise `503 INFRASTRUCTURE`). Framework-managed, so the
|
|
438
|
+
check is that a `config sync` has RUN and the app has
|
|
439
|
+
RESTARTED since — not that someone authored a value
|
|
435
440
|
- [ ] Operators have a tested `curl` recipe for the seed they may
|
|
436
441
|
need to re-run (Workflow B)
|
|
437
442
|
- [ ] `dataSeeding.scheduledRerunCronSchedule` override (if any)
|
|
438
|
-
|
|
439
|
-
registered corpus
|
|
443
|
+
has acceptable evaluation delay and coalescing for every seed
|
|
444
|
+
in the registered corpus
|
|
440
445
|
|
|
441
446
|
### Grep invariants
|
|
442
447
|
|
|
@@ -447,14 +452,13 @@ Run from the app root, substituting `<module>` and `<seed-key>`:
|
|
|
447
452
|
| Seed declares a `schedule?` block | `rg -n "schedule:\s*\{" backend-api/src/modules/<module>/seeds/` |
|
|
448
453
|
| Custom resolver registered when CUSTOM_RESOLVER used | `rg -n "dataSeedScopeResolvers:" backend-api/src/modules/<module>/index.ts` |
|
|
449
454
|
| Engine cron tick override declared | `rg -n "scheduledRerunCronSchedule" infrastructure/` |
|
|
450
|
-
| `APPLICATION_ADMIN_SECRET` provisioned | `rg -n "
|
|
455
|
+
| `APPLICATION_ADMIN_SECRET` provisioned | `rg -n "adminSecret" infrastructure/<env>/secrets/secrets.json` (the `application` section) — and `rg -n "^APPLICATION_ADMIN_SECRET=" backend-api/.env` to confirm it reached the runtime |
|
|
451
456
|
|
|
452
457
|
The high-signal invariants are **"`schedule?` declared in the seed
|
|
453
458
|
file"** combined with **"custom resolver registered when
|
|
454
459
|
`CUSTOM_RESOLVER` is the chosen strategy"** — a missing resolver
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
`data_seeding_run_total` counter for that seed).
|
|
460
|
+
raises a configuration error during scope iteration. Inspect the batch
|
|
461
|
+
report and logs; no scope dispatch can succeed through that missing resolver.
|
|
458
462
|
|
|
459
463
|
## Common Rationalizations
|
|
460
464
|
|
|
@@ -463,15 +467,15 @@ failed run row, no observable signal except a flat
|
|
|
463
467
|
| "I'll just declare `schedule?` on the LAZY seed; it'll re-run on the cron tick" | Factory rejects (`mode === LAZY` × `schedule` is N10). LAZY's contract is "first access creates the row, never re-applied" — periodic re-runs would either duplicate rows (no idempotency on the second access) or contradict the cache semantics (force a cache invalidation on every tick, which is a `force: true` re-run, which deletes COMPLETED rows). If you want periodic re-run, switch to ADDITIVE / UPGRADE / SYNC. |
|
|
464
468
|
| "I'll set `force: true` on every manual re-run to be safe" | `force: true` only affects LAZY seeds (it deletes prior COMPLETED rows so the next access re-runs the body). For ADDITIVE / UPGRADE / SYNC it is a no-op. Setting it indiscriminately costs nothing on those modes but signals confusion in the `runManual` audit trail (`triggeredByUserId` + payload echoed in logs). |
|
|
465
469
|
| "I'll skip `APPLICATION_ADMIN_SECRET` since the endpoints are internal" | The endpoints mount on `/internal/admin/data-seeding` but are NOT firewalled by path. Without the env var, every endpoint returns `503 INFRASTRUCTURE` (safe-default). Set the secret AND deploy behind a network-level rate limiter (LB / ingress) — there is NO in-process throttle. |
|
|
466
|
-
| "I'll override the engine tick to `'*/30 * * * * *'` (every 30 seconds) for faster propagation" |
|
|
470
|
+
| "I'll override the engine tick to `'*/30 * * * * *'` (every 30 seconds) for faster propagation" | The parser accepts second-aware expressions, but parsing does not prove that the platform will deliver that cadence. Verify the complete scheduler path before relying on sub-minute timing. Level-B triggers or LAZY access can tie materialization to the request that needs it. |
|
|
467
471
|
| "The seed's `lastRun` is RUNNING, I'll DELETE the row to retry" | The dispatcher uses `upsertByBusinessKey` on `(seedKey, scope, version)` — the next dispatcher pass (cron tick or manual re-run) PATCHES the existing RUNNING row to its terminal state. DELETE-ing the row is rarely needed; only do it when the row is `RUNNING` AND the dispatcher's recovery window has expired AND the next pass is not coming soon enough. |
|
|
468
472
|
|
|
469
473
|
## Red Flags
|
|
470
474
|
|
|
471
475
|
- A seed declares `schedule?` but its `iterationStrategy` is
|
|
472
476
|
`CUSTOM_RESOLVER` and no resolver is registered in the module's
|
|
473
|
-
`dataSeedScopeResolvers` slot (
|
|
474
|
-
|
|
477
|
+
`dataSeedScopeResolvers` slot (configuration error during iteration;
|
|
478
|
+
inspect the batch report and logs)
|
|
475
479
|
- `APPLICATION_ADMIN_SECRET` set to a low-entropy string (e.g.
|
|
476
480
|
`admin123`) — the constant-time SHA-256 compare defeats the
|
|
477
481
|
timing oracle but a brute-forced secret defeats the secret
|
|
@@ -484,10 +488,10 @@ failed run row, no observable signal except a flat
|
|
|
484
488
|
run with `onOrphan: REPORT` first on production, audit the
|
|
485
489
|
orphan set, THEN switch to `DELETE` (Decision 5 / Workflow C in
|
|
486
490
|
`seeding-authoring`)
|
|
487
|
-
-
|
|
488
|
-
|
|
489
|
-
|
|
490
|
-
|
|
491
|
+
- A seed needs one invocation per minute but the engine evaluates every
|
|
492
|
+
five minutes — firings are coalesced; use minute-level evaluation. A
|
|
493
|
+
coarse tick alone does not explain a seed never running. Check registration,
|
|
494
|
+
the UTC window, selected scopes and reported dispatch errors.
|
|
491
495
|
|
|
492
496
|
## Related Skills
|
|
493
497
|
|
|
@@ -34,7 +34,7 @@ the cause from the response without consulting logs:
|
|
|
34
34
|
|
|
35
35
|
| Response | Cause | Operator action |
|
|
36
36
|
|-------------------------|--------------------------------------------------|----------------------------------------------------------------------------------|
|
|
37
|
-
| `503 INFRASTRUCTURE` | Env var unset/empty (endpoints disabled) |
|
|
37
|
+
| `503 INFRASTRUCTURE` | Env var unset/empty (endpoints disabled) | Run `wildo config sync` (the secret is framework-minted and self-healed into `secrets.json`, then emitted into the app env), then RESTART the app process — env is read at start |
|
|
38
38
|
| `401 AUTHENTICATION` ("Missing X-Admin-Secret header") | Header absent on the request | Add `-H "X-Admin-Secret: $APPLICATION_ADMIN_SECRET"` to the curl |
|
|
39
39
|
| `401 AUTHENTICATION` ("Invalid X-Admin-Secret") | Header present but value mismatches | Verify `$APPLICATION_ADMIN_SECRET` in the operator's shell matches the deployed value |
|
|
40
40
|
|
|
@@ -264,20 +264,28 @@ GET /seeds → find lastRun for the suspect seed
|
|
|
264
264
|
|
|
265
265
|
## Decision 5 (extended): Boot wiring trace
|
|
266
266
|
|
|
267
|
-
`
|
|
268
|
-
|
|
269
|
-
|
|
267
|
+
`StartApplicationBackendService.initialize()` runs the bootstrap in TWO
|
|
268
|
+
halves. Steps 1–4 (`wireDataSeedingDeclarations`) run at Step 5.9, BEFORE the
|
|
269
|
+
HTTP server starts listening; steps 5–7 (`runDataSeedingApplicationLifecyclePasses`)
|
|
270
|
+
run at Step 7.7. There is deliberately no one-call composite of the two.
|
|
271
|
+
The order is the source of truth:
|
|
270
272
|
|
|
271
273
|
```text
|
|
272
274
|
1. registry.registerSeeds(seeds) ALWAYS
|
|
273
275
|
2. scopeResolverRegistry.registerResolvers(map) ALWAYS
|
|
274
276
|
3. wireLevelBResourceLifecycleHooks(...) ALWAYS — pre/post hooks per resource type
|
|
275
277
|
4. wireLazyAccessGuards(...) ALWAYS — pre-only hooks per (resourceType, operation)
|
|
278
|
+
── the HTTP server starts listening here ──
|
|
276
279
|
5. if isPlatformMode → return platform apps-manager skips dispatch
|
|
277
280
|
6. dispatcher.runApplicationLifecycle('onAppInit')
|
|
278
281
|
7. dispatcher.runApplicationLifecycle('onAppVersionUpgrade')
|
|
279
282
|
```
|
|
280
283
|
|
|
284
|
+
Why the split: a request served before step 3 runs without its Level-B seeds,
|
|
285
|
+
and a missed `afterCreate` is never retried. The hooks were once wired after the
|
|
286
|
+
server was already answering, behind an awaited cron-job sync, and every
|
|
287
|
+
organization created in that window had no configuration singletons.
|
|
288
|
+
|
|
281
289
|
### "Why did/didn't the seed fire" — three frequent investigations
|
|
282
290
|
|
|
283
291
|
**Investigation 1: "The seed is registered but didn't fire on
|
|
@@ -319,7 +327,7 @@ reveal it.
|
|
|
319
327
|
### Failure propagation
|
|
320
328
|
|
|
321
329
|
A fatal throw from either Step 6 or Step 7 propagates UNCHANGED
|
|
322
|
-
out of `
|
|
330
|
+
out of `runDataSeedingApplicationLifecyclePasses` and out of
|
|
323
331
|
`StartApplicationBackendService.initialize()`. There is NO
|
|
324
332
|
try/catch here — that's intentional, because:
|
|
325
333
|
|
|
@@ -15,35 +15,45 @@ seeding:scheduled-rerun`) wakes on the engine tick (default
|
|
|
15
15
|
`'* * * * *'`, override via
|
|
16
16
|
`AppConfiguration_Shared_Schema.dataSeeding.scheduledRerunCronSchedule`).
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
The batch captures `tickAt` when handling starts. Both cron expressions are
|
|
19
|
+
interpreted in UTC. It derives the previous engine boundary from a backdated
|
|
20
|
+
cursor; the backdate scales with the configured engine interval so modest
|
|
21
|
+
wake-up delays can still include the intended boundary.
|
|
19
22
|
|
|
20
23
|
```text
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
24
|
+
tickAt = handler start time
|
|
25
|
+
enginePrevTickFire = previous engine firing before the backdated cursor
|
|
26
|
+
for each registered seed with schedule defined:
|
|
27
|
+
seedNextFire = first seed firing strictly after enginePrevTickFire
|
|
28
|
+
if seedNextFire <= tickAt:
|
|
29
|
+
for each item selected by the iteration strategy:
|
|
30
|
+
dispatch the seed for that item's scope, origin SCHEDULED_RERUN
|
|
26
31
|
```
|
|
27
32
|
|
|
33
|
+
This is a UTC window `(enginePrevTickFire, tickAt]`, not an exact-time match.
|
|
34
|
+
|
|
35
|
+
| Engine cron | Seed cron | Handler starts (UTC) | Result |
|
|
36
|
+
|-------------|-----------|----------------------|--------|
|
|
37
|
+
| `*/5 * * * *` | `* * * * *` | 12:35:00 | Window (12:30, 12:35] contains minute firings; one dispatch per selected scope, not five. |
|
|
38
|
+
| `*/5 * * * *` | `34 12 * * *` | 12:35:00 | The 12:34 firing is due and evaluated on this tick. |
|
|
39
|
+
| `* * * * *` | `34 12 * * *` | 12:34:01.500 | The slightly delayed evaluation still includes 12:34. |
|
|
40
|
+
| `* * * * *` | `34 12 * * *` | 12:35:00 | The next window excludes 12:34; this daily seed is no longer due. |
|
|
41
|
+
|
|
28
42
|
Three operational consequences:
|
|
29
43
|
|
|
30
|
-
1. **The engine tick bounds
|
|
31
|
-
tick can
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
restart, paused replica) does NOT replay missed seed cron
|
|
44
|
-
evaluations. Use the manual re-run endpoint
|
|
45
|
-
([Decision 2](../SKILL.md#decision-2-re-run-a-seed-manually))
|
|
46
|
-
for explicit catch-up after a deployment outage.
|
|
44
|
+
1. **The engine tick bounds evaluation frequency.** A minute seed on a
|
|
45
|
+
five-minute engine tick can run, but its occurrences are coalesced into
|
|
46
|
+
one dispatch per selected scope at that evaluation. Use a minute tick
|
|
47
|
+
when the application needs minute-level evaluation.
|
|
48
|
+
2. **Delayed evaluation is bounded.** The backdated window accommodates
|
|
49
|
+
modest lateness; it is not a promise that every arbitrarily late wake-up
|
|
50
|
+
preserves the original tick. Processing duration and scope fan-out also
|
|
51
|
+
affect when work completes.
|
|
52
|
+
3. **There is no durable missed-occurrence replay.** The window is recomputed
|
|
53
|
+
from the current handling time, not the last successful run. After an
|
|
54
|
+
outage, occurrences outside that window are not enumerated or replayed.
|
|
55
|
+
Use an explicit manual rerun for reconciliation; it runs the seed now,
|
|
56
|
+
rather than reconstructing every missed historical firing.
|
|
47
57
|
|
|
48
58
|
## The five iteration strategies
|
|
49
59
|
|
|
@@ -56,25 +66,21 @@ shape. Five values, one alignment matrix with the seed's
|
|
|
56
66
|
|---------------------|---------------------------------------------|--------------------------------------------------|---------------------------|
|
|
57
67
|
| `GLOBAL` | 1 dispatch (no anchor) | `GLOBAL` only | No |
|
|
58
68
|
| `ALL_APPLICATIONS` | 1 dispatch per `applications` row | `APPLICATION` | No |
|
|
59
|
-
| `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `
|
|
60
|
-
| `ALL_USERS` | 1 dispatch per `users` row | `
|
|
61
|
-
| `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value |
|
|
62
|
-
|
|
63
|
-
###
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
`
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
If you want one `DataSeedRun` row per org (so the ledger drill-in
|
|
75
|
-
naturally pages per tenant), use `scope.kind === ORGANIZATION`
|
|
76
|
-
instead — same `iterationStrategy` is allowed and gives you
|
|
77
|
-
per-org provenance.
|
|
69
|
+
| `ALL_ORGANIZATIONS` | 1 dispatch per `organizations` row | `ORGANIZATION` only | No |
|
|
70
|
+
| `ALL_USERS` | 1 dispatch per `users` row | `USER` only | No |
|
|
71
|
+
| `CUSTOM_RESOLVER` | 1 dispatch per `resolver()` return value | `APPLICATION`, `ORGANIZATION`, `USER`, `CUSTOM`; required for `CUSTOM` | Yes (`customResolverKey`) |
|
|
72
|
+
|
|
73
|
+
### Match the declared scope to the iteration target
|
|
74
|
+
|
|
75
|
+
`ALL_ORGANIZATIONS` requires an `ORGANIZATION` seed;
|
|
76
|
+
`ALL_USERS` requires a `USER` seed. An `APPLICATION` seed cannot use
|
|
77
|
+
those strategies. The factory rejects that mismatch before dispatch.
|
|
78
|
+
Each selected organization or user becomes the corresponding dispatch scope.
|
|
79
|
+
|
|
80
|
+
`CUSTOM_RESOLVER` selects IDs while preserving the seed's declared scope
|
|
81
|
+
kind. For `CUSTOM`, the declared `relatedResourceType` is also carried into
|
|
82
|
+
dispatch. It is not a way to turn an application-scoped seed into an
|
|
83
|
+
organization-scoped seed, and it is forbidden for `GLOBAL` seeds.
|
|
78
84
|
|
|
79
85
|
### When to reach for `CUSTOM_RESOLVER`
|
|
80
86
|
|
|
@@ -88,14 +94,6 @@ built-in strategies can't express:
|
|
|
88
94
|
"every user activated in the last 30 days". Express the filter
|
|
89
95
|
in the resolver body; the dispatcher iterates the resolver's
|
|
90
96
|
output.
|
|
91
|
-
- **Cross-tenant orchestration** — when the seed needs to fan out
|
|
92
|
-
beyond the host app's child set (e.g. a platform-level seed
|
|
93
|
-
that needs to touch every app's data). Note: the engine cron
|
|
94
|
-
batch runs per-app, so even a custom resolver is anchored to the
|
|
95
|
-
host app's process. Cross-app orchestration is the deliberate
|
|
96
|
-
out-of-scope case (use an external `CronJob` invoking the
|
|
97
|
-
manual re-run endpoint instead — see
|
|
98
|
-
[Decision 2](../SKILL.md#decision-2-re-run-a-seed-manually)).
|
|
99
97
|
|
|
100
98
|
The resolver itself is registered on the module's
|
|
101
99
|
`BackendDomainModule.dataSeedScopeResolvers?: Record<string,
|
|
@@ -103,29 +101,26 @@ DataSeedScopeResolver>` slot, alongside `seeds` and `operations`.
|
|
|
103
101
|
The key in the record is what the seed's
|
|
104
102
|
`schedule.customResolverKey` references; the value is a function
|
|
105
103
|
that receives the dispatcher's exec context and returns
|
|
106
|
-
`Promise<
|
|
104
|
+
`Promise<readonly { readonly relatedId: string }[]>`. The seed supplies the
|
|
105
|
+
scope kind (and custom resource type), not the resolver. A missing registry
|
|
106
|
+
key raises a configuration error captured in the batch report; a registered
|
|
107
|
+
resolver returning an empty array legitimately selects no scopes.
|
|
107
108
|
|
|
108
109
|
## Picking an engine tick
|
|
109
110
|
|
|
110
|
-
The default
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
1. No registered seed in the corpus needs minute-level cadence.
|
|
115
|
-
2. The host process is constrained on either CPU (the per-tick
|
|
116
|
-
evaluation iterates every registered seed and may invoke
|
|
117
|
-
custom resolvers) or memory (each fan-out dispatch loads the
|
|
118
|
-
target row's exec context).
|
|
119
|
-
3. You have audited the slowest per-seed cron and the chosen
|
|
120
|
-
engine tick is at most as coarse as that seed's cron.
|
|
111
|
+
The default `* * * * *` evaluates every minute. Choose a coarser engine tick
|
|
112
|
+
only when the resulting delay and coalescing are acceptable for every seed.
|
|
113
|
+
Review the most time-sensitive seed, not just the slowest schedule.
|
|
121
114
|
|
|
122
|
-
|
|
115
|
+
| Engine tick | Operational choice |
|
|
116
|
+
|-------------|--------------------|
|
|
117
|
+
| `* * * * *` | Minute-level evaluation; default when any seed needs that responsiveness. |
|
|
118
|
+
| `*/5 * * * *` | Evaluate every five minutes. More frequent seed firings are coalesced. |
|
|
119
|
+
| `0 * * * *` | Hourly evaluation. Use only when hourly delay and coalescing are acceptable. |
|
|
123
120
|
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
| `'*/5 * * * *'` | Every registered seed runs at least every 5 minutes (hourly / daily). |
|
|
128
|
-
| `'0 * * * *'` | Every registered seed runs at most hourly. Reduces tick churn ~60×. |
|
|
121
|
+
Do not choose a coarse tick to represent one invocation per occurrence of a
|
|
122
|
+
finer seed cron. This batch makes a due/not-due decision per seed and tick;
|
|
123
|
+
it does not count and replay the occurrences inside the window.
|
|
129
124
|
|
|
130
125
|
## Mode × schedule rejection (LAZY)
|
|
131
126
|
|
|
@@ -155,14 +150,12 @@ batch under
|
|
|
155
150
|
strategy is anchored to the host app:
|
|
156
151
|
|
|
157
152
|
- `ALL_APPLICATIONS` yields every `applications` row visible to
|
|
158
|
-
the host
|
|
159
|
-
managed children, depending on the platform mode).
|
|
153
|
+
the host application context.
|
|
160
154
|
- `ALL_ORGANIZATIONS` / `ALL_USERS` yields every org / user
|
|
161
155
|
belonging to the host app.
|
|
162
|
-
- `CUSTOM_RESOLVER`
|
|
163
|
-
|
|
164
|
-
cross-
|
|
165
|
-
row is still attributed to the host app's process.
|
|
156
|
+
- `CUSTOM_RESOLVER` receives the host application context and must
|
|
157
|
+
enumerate scopes accessible under that context. It does not grant
|
|
158
|
+
cross-application access.
|
|
166
159
|
|
|
167
160
|
Cross-app fan-out (e.g. "fire this seed once per app in the entire
|
|
168
161
|
deployment") is NOT a supported engine-cron mode. Use an external
|
package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md
CHANGED
|
@@ -15,9 +15,12 @@ the data-seeding subsystem:
|
|
|
15
15
|
- **`DataSeedRunSchema`** + **`DataSeedRunStatus`** — the persisted
|
|
16
16
|
ledger of every seed pass (Decision 3) plus its terminal-status
|
|
17
17
|
enum.
|
|
18
|
-
- **`
|
|
19
|
-
|
|
20
|
-
Level-
|
|
18
|
+
- **`wireDataSeedingDeclarations`** + **`runDataSeedingApplicationLifecyclePasses`**
|
|
19
|
+
— the two startup halves (Decision 5): the first registers seeds and wires
|
|
20
|
+
Level-B hooks and LAZY guards before the HTTP server listens, the second runs
|
|
21
|
+
the Level-A dispatch passes later. There is no one-call composite: calling both
|
|
22
|
+
after a server is already accepting requests would reopen the window in which a
|
|
23
|
+
request runs without its seed hooks.
|
|
21
24
|
|
|
22
25
|
The cron schedule and iteration strategy are exported through the declared
|
|
23
26
|
`@wildo-ai/saas-backend-lib/data-seeding-models` entrypoint. The remaining
|
|
@@ -488,7 +491,8 @@ fire / not fire / fire twice" investigations.
|
|
|
488
491
|
|
|
489
492
|
```typescript
|
|
490
493
|
/**
|
|
491
|
-
* Inputs to {@link
|
|
494
|
+
* Inputs to the data-seeding bootstrap halves ({@link wireDataSeedingDeclarations},
|
|
495
|
+
* {@link runDataSeedingApplicationLifecyclePasses}). Kept as a typed
|
|
492
496
|
* record (instead of positional args) so callers from different startup
|
|
493
497
|
* orchestrators stay readable when the surface grows in later phases.
|
|
494
498
|
*/
|
|
@@ -551,10 +555,12 @@ export interface DataSeedApplicationBootstrapInput {
|
|
|
551
555
|
}
|
|
552
556
|
|
|
553
557
|
/**
|
|
554
|
-
*
|
|
555
|
-
* the
|
|
558
|
+
* The half of the bootstrap that must be live before ANY request can reach the services registry:
|
|
559
|
+
* register the seed corpus and the scope resolvers, then wire the Level-B resource-lifecycle hooks and
|
|
560
|
+
* the LAZY-access guards. Pure in-memory wiring — no read, no write, no remote call.
|
|
561
|
+
*
|
|
562
|
+
* ## Contract of the two halves, taken together
|
|
556
563
|
*
|
|
557
|
-
* Contract:
|
|
558
564
|
* - Registration ALWAYS runs (even in platform mode) so future Level-B
|
|
559
565
|
* and lazy-access dispatch paths can resolve seed declarations.
|
|
560
566
|
* - Dispatcher is invoked twice in order: `onAppInit` MUST precede
|
|
@@ -583,24 +589,64 @@ export interface DataSeedApplicationBootstrapInput {
|
|
|
583
589
|
* per resource type with internal route map.
|
|
584
590
|
* 5. Platform-mode skip: dispatch is suppressed for the apps-manager
|
|
585
591
|
* profile (it bootstraps tenant apps which run their own pass).
|
|
592
|
+
*
|
|
593
|
+
* ## Why it is its own step, and runs before the HTTP server listens
|
|
594
|
+
*
|
|
595
|
+
* The HTTP server starts listening inside Step 6, and this wiring used to run inside Step 7.7, after
|
|
596
|
+
* queue-worker initialization and an AWAITED cron-job sync. Every request in between reached a services
|
|
597
|
+
* registry with no seed hooks: an organization created then got none of its `afterCreate` defaults
|
|
598
|
+
* (SSO, SCIM, SIEM-export and webhook configuration singletons), silently and permanently, because a
|
|
599
|
+
* post-create hook that was not registered has nothing to retry. Measured 2026-09-14 on Your Application:
|
|
600
|
+
* the cron sync waited ~20 minutes on a platform that was not ready, the backend answered
|
|
601
|
+
* `/health/ready` 200 throughout, and every organization registered in that window had no
|
|
602
|
+
* `organizationSsoConfig` row.
|
|
603
|
+
*
|
|
604
|
+
* So the declarations are wired where the registry becomes reachable, and only the application-lifecycle
|
|
605
|
+
* passes ({@link runDataSeedingApplicationLifecyclePasses}) stay at Step 7.7.
|
|
586
606
|
*/
|
|
587
|
-
export
|
|
588
|
-
input:
|
|
589
|
-
|
|
590
|
-
|
|
591
|
-
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
|
|
597
|
-
|
|
598
|
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
|
|
607
|
+
export function wireDataSeedingDeclarations(
|
|
608
|
+
input: Pick<
|
|
609
|
+
DataSeedApplicationBootstrapInput,
|
|
610
|
+
'dataSeeds' | 'dataSeedScopeResolvers' | 'logDebug' | 'registry' | 'scopeResolverRegistry' | 'dispatcher' | 'servicesRegistry'
|
|
611
|
+
> & {
|
|
612
|
+
/**
|
|
613
|
+
* Whether this runtime owns the application's DATA LIFECYCLE, and therefore whether the
|
|
614
|
+
* framework's own seeds belong in its registry.
|
|
615
|
+
*
|
|
616
|
+
* Only the application backend does. A MINION or WORKER runs the same bootstrap with a SCOPED
|
|
617
|
+
* services registry that refuses unscoped writes, and registering a Level-B seed there makes
|
|
618
|
+
* `wireLevelBResourceLifecycleHooks` ask for exactly that access — measured 2026-09-18, when
|
|
619
|
+
* registering the engine's set unconditionally crash-looped the marketing-scrapper minion with
|
|
620
|
+
* `Minion 'marketingScrapper' is not allowed to write resource '<unscoped-registry-access>'`.
|
|
621
|
+
*
|
|
622
|
+
* The application's OWN `dataSeeds` are registered regardless, exactly as before: what an
|
|
623
|
+
* application passes is its business, and this flag governs only what the FRAMEWORK adds.
|
|
624
|
+
*/
|
|
625
|
+
readonly registersEngineOwnedSeeds: boolean;
|
|
626
|
+
},
|
|
627
|
+
): void {
|
|
628
|
+
const { dataSeeds, dataSeedScopeResolvers, logDebug, registry, scopeResolverRegistry, dispatcher, servicesRegistry, registersEngineOwnedSeeds } = input;
|
|
629
|
+
|
|
630
|
+
/*
|
|
631
|
+
* FRAMEWORK-owned seeds first, then the application's.
|
|
632
|
+
*
|
|
633
|
+
* These used to be the application's job: each one spread `enterpriseAuthConfigOrgSeedDefinitions`
|
|
634
|
+
* and its siblings into a module of its own, and an application that did not know to do so had no
|
|
635
|
+
* per-scope configuration rows at all — which is exactly what the newer dogfood application did,
|
|
636
|
+
* leaving every SSO / SCIM / SIEM settings panel answering a 404. The framework's own defaults for
|
|
637
|
+
* the framework's own resources are registered by the framework.
|
|
638
|
+
*
|
|
639
|
+
* Order matters only for the duplicate refusal below: registering the engine's set FIRST means an
|
|
640
|
+
* application that still spreads one of them fails naming the framework's key, which is the half
|
|
641
|
+
* of the collision a reader can act on.
|
|
642
|
+
*/
|
|
643
|
+
const engineOwned = registersEngineOwnedSeeds ? ENGINE_OWNED_DATA_SEEDS : [];
|
|
644
|
+
const seeds = [...engineOwned, ...(dataSeeds ?? [])];
|
|
645
|
+
logDebug('🌱 Registering data-seed definitions...', {
|
|
646
|
+
count: seeds.length,
|
|
647
|
+
engineOwned: engineOwned.length,
|
|
648
|
+
applicationOwned: (dataSeeds ?? []).length,
|
|
649
|
+
});
|
|
604
650
|
registry.registerSeeds(seeds);
|
|
605
651
|
logDebug('✅ Data-seed registry populated');
|
|
606
652
|
|
|
@@ -631,6 +677,17 @@ export async function runDataSeedingApplicationBootstrap(
|
|
|
631
677
|
// are per-tenant request hooks, the host running the Level-A pass
|
|
632
678
|
// is irrelevant to their availability at request time).
|
|
633
679
|
wireLazyAccessGuards({ registry, dispatcher, servicesRegistry, logDebug });
|
|
680
|
+
}
|
|
681
|
+
|
|
682
|
+
/**
|
|
683
|
+
* Step 7.7 — the application-lifecycle passes (`onAppInit`, then `onAppVersionUpgrade`, then the
|
|
684
|
+
* non-fatal missing-defaults repair). Requires {@link wireDataSeedingDeclarations} to have run: the
|
|
685
|
+
* dispatcher resolves seeds from the registry it populated. Skipped entirely in platform mode.
|
|
686
|
+
*/
|
|
687
|
+
export async function runDataSeedingApplicationLifecyclePasses(
|
|
688
|
+
input: Pick<DataSeedApplicationBootstrapInput, 'isPlatformMode' | 'logger' | 'logDebug' | 'dispatcher'>,
|
|
689
|
+
): Promise<void> {
|
|
690
|
+
const { isPlatformMode, logger, logDebug, dispatcher } = input;
|
|
634
691
|
|
|
635
692
|
if (isPlatformMode) {
|
|
636
693
|
logDebug('🌱 Skipping application-lifecycle data-seed dispatch in platform mode (tenant apps will run their own pass via apps-manager)');
|
|
@@ -658,5 +715,21 @@ export async function runDataSeedingApplicationBootstrap(
|
|
|
658
715
|
logger.error('❌ Data-seed application-lifecycle pass failed (fatal):', error);
|
|
659
716
|
throw error;
|
|
660
717
|
}
|
|
718
|
+
|
|
719
|
+
// Missing-defaults repair (#554) — after both lifecycle passes, and NON-fatal, which is the opposite
|
|
720
|
+
// of the passes above on purpose. Those passes create rows downstream operations need, so booting
|
|
721
|
+
// without them is worse than not booting. This pass only completes rows that are already readable,
|
|
722
|
+
// and its per-seed failures are on the ledger and retried next boot; refusing to start over it
|
|
723
|
+
// would make a defaults gap into an outage.
|
|
724
|
+
try {
|
|
725
|
+
const repairReport = await dispatcher.repairMissingDefaultsOnLifecycleSeededRows();
|
|
726
|
+
logDebug('✅ Missing-defaults repair pass complete', {
|
|
727
|
+
repaired: repairReport.runs.length,
|
|
728
|
+
alreadyRepaired: repairReport.seedsAlreadyRepaired,
|
|
729
|
+
failedSeedKeys: repairReport.failedSeedKeys,
|
|
730
|
+
});
|
|
731
|
+
} catch (error) {
|
|
732
|
+
logger.error('❌ Missing-defaults repair pass failed (non-fatal — retried on the next boot):', error);
|
|
733
|
+
}
|
|
661
734
|
}
|
|
662
735
|
```
|