@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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: local-environment-bootstrap
|
|
3
|
-
description: Drive the registered local project lifecycle with the `wildo` CLI — `wildo setup` (mint the environment generation), `wildo local init` (non-destructively initialize or repair infra + platform + application projections), `wildo local reinit` (wipe
|
|
3
|
+
description: Drive the registered local project lifecycle with the `wildo` CLI — `wildo setup` (mint the environment generation), `wildo local init` (non-destructively initialize or repair infra + platform + application projections), `wildo local reinit` (framework-developer-only wipe then initialization), `wildo local dev` (start app runtimes), `wildo local up/down/reset`, and `wildo config sync`. Use when the user says "initialize my project", "add an application to the running platform", "repair broken platform state", "my Mongo volume was reset", "set up my local stack", "reinitialize from empty data", "regenerate runtime env files", "check my config without changing anything" (`wildo config validate`), "set a service port / toggle a capability flag" (`wildo config mutate`), "diagnose my local stack" (`wildo local doctor`), "is what I am running even current", "upgrade to a newer Wildo release" (`wildo update`), "align my dependencies" (`wildo align-deps`), or "I edited wildo.infra.local.config.ts".
|
|
4
4
|
---
|
|
5
5
|
|
|
6
6
|
# Local Environment Bootstrap
|
|
@@ -43,9 +43,9 @@ everything below:
|
|
|
43
43
|
state, native platform processes, one application registration snapshot,
|
|
44
44
|
every runtime env projection, and a signed platform-to-platform config read.
|
|
45
45
|
A stale on-disk marker or an open port is not accepted as proof.
|
|
46
|
-
4. **Destructive actions are opt-in.** `--force`
|
|
47
|
-
|
|
48
|
-
|
|
46
|
+
4. **Destructive actions are opt-in.** Flags are command-specific: setup `--force`
|
|
47
|
+
requests reconfiguration while preserving existing credentials. Setup has no
|
|
48
|
+
`--rotate-secrets` option; credential rotation belongs to the commands that explicitly offer it. Wiping bind-mounted data
|
|
49
49
|
requires `wildo local reset` (explicit). Anything else is non-destructive
|
|
50
50
|
by default.
|
|
51
51
|
|
|
@@ -57,14 +57,14 @@ what regenerates it.
|
|
|
57
57
|
|
|
58
58
|
| Kind | Examples | Owner | Regenerated by | Safe to delete? |
|
|
59
59
|
|------|----------|-------|----------------|-----------------|
|
|
60
|
-
| **Authored** (in git) | `./infrastructure/<env>/wildo.infra
|
|
61
|
-
| **Authored secrets** (out of git) | `./infrastructure/<env>/secrets/secrets.json` (or your chosen secrets path) | You + the `wildo setup` wizard |
|
|
60
|
+
| **Authored** (in git) | `./infrastructure/local/wildo.infra.local.config.ts` or `./infrastructure/<env>/wildo.infra.remote.config.ts`, `./wildo.saas.config.ts` | You (the app developer) | Never — hand-edited | No — version-controlled truth |
|
|
61
|
+
| **Authored secrets** (out of git) | `./infrastructure/<env>/secrets/secrets.json` (or your chosen secrets path) | You + the `wildo setup` wizard | Setup and ordinary non-CI sync can provision missing material or regenerate incomplete credential groups; complete existing groups are preserved without explicit rotation | No by default — destructive rotation is opt-in |
|
|
62
62
|
| **Generated runtime artifacts** | `./.wildo-saas/infrastructure/environments/<env>/generated/config/config.json`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml`, `./.wildo-saas/infrastructure/environments/<env>/docker-compose/.env.wildo-platform` | The `wildo` CLI | `wildo local init` / `wildo local up` (self-heal missing files) or scoped `wildo config sync` | Yes — they regenerate from the authored sources |
|
|
63
63
|
| **Local state + data** | `./.wildo-saas/state/environments.json`, `./.wildo-saas/local_data/<service>/`, `./.wildo-saas/runtime-signals/` | The `wildo` CLI + dev companion | `wildo local init` recreates runtime state; data accumulates across non-destructive restarts | State: yes; **data: only through `wildo local reset` or `wildo local reinit`** after processes and containers stop |
|
|
64
64
|
|
|
65
65
|
**Rule of thumb:** If the file lives under `./.wildo-saas/` it is generated
|
|
66
66
|
or runtime data — the CLI rebuilds it. Everything outside `./.wildo-saas/`
|
|
67
|
-
that the CLI touches (`wildo.infra
|
|
67
|
+
that the CLI touches (`wildo.infra.local.config.ts` / `wildo.infra.remote.config.ts`, `secrets.json`) is
|
|
68
68
|
**authored truth** and must never be deleted as a "fix attempt".
|
|
69
69
|
|
|
70
70
|
The dividing line matters because the most common recovery action — wipe
|
|
@@ -99,8 +99,10 @@ deployed environment shares them).
|
|
|
99
99
|
- The user wants to rotate local credentials (rare; explicit opt-in)
|
|
100
100
|
- Platform/application state is absent, partial, or inconsistent and must be
|
|
101
101
|
repaired without deleting backing data (`wildo local init`)
|
|
102
|
+
- Another application must register against an already-running shared platform
|
|
103
|
+
(`wildo local init --register-only`)
|
|
102
104
|
- The user wants a full local wipe and verified reinitialization
|
|
103
|
-
(`wildo local reinit`, with explicit confirmation or `--force`)
|
|
105
|
+
(framework-developer-only `wildo local reinit`, with explicit confirmation or `--force`)
|
|
104
106
|
|
|
105
107
|
## When NOT to Use
|
|
106
108
|
|
|
@@ -119,23 +121,51 @@ deployed environment shares them).
|
|
|
119
121
|
|
|
120
122
|
### Step 1: Classify the situation
|
|
121
123
|
|
|
122
|
-
Pick the right path before running any command.
|
|
123
|
-
|
|
124
|
+
Pick the right path before running any command. Read the row that matches
|
|
125
|
+
the user's situation, including whether another application owns the running platform.
|
|
124
126
|
|
|
125
127
|
| Situation | Right command |
|
|
126
128
|
|-----------|---------------|
|
|
129
|
+
| This application's `wildo.infra.<env>.config.ts` declares an `infrastructureHost` | Start the platform FROM THE HOST (`cd <host> && wildo local dev`), then `wildo local init` and `wildo local dev` here — both register and attach only |
|
|
130
|
+
| "Add this application while another application uses the running platform" | `wildo local init --register-only` (application registration and runtime projections only; existing healthy platform required) |
|
|
127
131
|
| "Initialize this project" / "repair broken Mongo-mounted platform state" | `wildo local init` (canonical non-destructive convergence + executable verification) |
|
|
128
132
|
| "Start my local stack" / "spin up only the dev infra" | `wildo local up` (infra only; self-heals missing artifacts) |
|
|
129
133
|
| "Stop the stack but keep my local data" | `wildo local down` |
|
|
130
|
-
| "Wipe everything and return to a verified initialized project" | `wildo local reinit
|
|
134
|
+
| "Wipe everything and return to a verified initialized project" | Framework developers: `wildo local reinit`. Application creators: explicitly authorized `wildo local reset`, then separate `wildo local init` |
|
|
131
135
|
| "Stop everything and leave it empty" | `wildo local reset` |
|
|
132
136
|
| "I edited `wildo.infra.<env>.config.ts` and need to re-render compose" | `wildo config sync --domain manifest` then `wildo local up` (or just `wildo local up` — it will re-render if the file is missing) |
|
|
133
|
-
| "I
|
|
137
|
+
| "I edited an existing local environment’s backing service or public address" | `wildo config sync` reconciles supported authored local state before rendering; use `wildo setup` for initial state/secrets or a reported unsupported setup path |
|
|
134
138
|
|
|
135
139
|
If the user is describing a symptom rather than an action ("the dev
|
|
136
140
|
companion can't reach mongodb", "the stack won't start"), read
|
|
137
141
|
`references/local-environment-troubleshooting.md` first to triage.
|
|
138
142
|
|
|
143
|
+
A live `wildo local dev` owner blocks full initialization because convergence
|
|
144
|
+
stops tracked processes and rewrites the shared platform generation. For a
|
|
145
|
+
second application, use `--register-only`; do not stop the first application
|
|
146
|
+
or retry with a wipe to get past this guard. Full convergence belongs to a
|
|
147
|
+
separate, intentional repair of the platform.
|
|
148
|
+
|
|
149
|
+
**An application HOSTED on another's infrastructure** (its environment descriptor is
|
|
150
|
+
`defineHostedInfraEnvConfig` with an `infrastructureHost`) owns no shared substrate, so the
|
|
151
|
+
commands behave differently and always name the host when they refuse:
|
|
152
|
+
|
|
153
|
+
- `wildo local init` registers the application against the host's platform and materializes
|
|
154
|
+
its own runtime env files — never stops, recreates or initializes anything shared.
|
|
155
|
+
- `wildo local dev` attaches: it verifies the host's containers are running and refuses to
|
|
156
|
+
start them. Start the host first.
|
|
157
|
+
- `wildo local up`, `down`, `reset` and `reinit` refuse: they act on the host's containers and
|
|
158
|
+
data. Run them from the host. `wildo dev stop-all` stops only this application's processes.
|
|
159
|
+
- `wildo config sync` writes only this application's targets; the shared compose project,
|
|
160
|
+
`.env.wildo-platform`, platform-service env files and manifests are the host's.
|
|
161
|
+
- Shared credentials come from the host's `infrastructure/<env>/secrets/secrets.json`; this
|
|
162
|
+
application's `secrets.json` keeps only `admin`, `approver`, `application` and `providerEnv`.
|
|
163
|
+
`--rotate-secrets` here rotates only those; rotate shared credentials from the host.
|
|
164
|
+
|
|
165
|
+
Do not "fix" a hosted application's refusal by removing `infrastructureHost` or copying the
|
|
166
|
+
host's backing services into it: that recreates the host's containers over this application's
|
|
167
|
+
data directory under the same container names.
|
|
168
|
+
|
|
139
169
|
### Step 2: Confirm the artifact taxonomy before any destructive action
|
|
140
170
|
|
|
141
171
|
Before deleting anything, identify which kind of artifact it is using
|
|
@@ -155,6 +185,12 @@ the taxonomy table above. Concretely:
|
|
|
155
185
|
|
|
156
186
|
`wildo` flags follow a consistent posture:
|
|
157
187
|
|
|
188
|
+
- `--register-only` (on `wildo local init`) — register the targeted application
|
|
189
|
+
and materialize its runtime env projections against the existing platform.
|
|
190
|
+
Requires an active LOCAL environment, its setup-generated config and secrets,
|
|
191
|
+
and the configured platform endpoints to be healthy and reachable. It does
|
|
192
|
+
not start or repair shared services. Add `--app <application-slug>` when the
|
|
193
|
+
workspace exposes several targets.
|
|
158
194
|
- `-y` / `--yes` — skip Y/n prompts (safe: just confirms what would
|
|
159
195
|
otherwise be confirmed)
|
|
160
196
|
- `--force` — skip safety prompts on operations that overwrite existing
|
|
@@ -170,9 +206,33 @@ the taxonomy table above. Concretely:
|
|
|
170
206
|
Read `references/wildo-cli-bootstrap-commands.md` for the full command
|
|
171
207
|
reference and flag matrix.
|
|
172
208
|
|
|
209
|
+
### Prepare the approving administrator
|
|
210
|
+
|
|
211
|
+
Application-wide grant-controlled reads need approval from a different application super-administrator; requests always start pending. This is not a blanket grant requirement on every application-scoped operation. Tenant grants instead follow the customer's approval posture and usable-owner branch.
|
|
212
|
+
|
|
213
|
+
A fresh `wildo init` with no existing local secrets accepts `WILDO_INIT_APPROVER_EMAIL`, `WILDO_INIT_APPROVER_FIRSTNAME`, `WILDO_INIT_APPROVER_LASTNAME` and `WILDO_INIT_APPROVER_PASSWORD` together. Without explicit inputs it derives a separate `+approver` identity sharing the first administrator's development password. This enables one developer to exercise both identities; it is not evidence of two-person approval.
|
|
214
|
+
|
|
215
|
+
Existing secrets are preserved. Fresh `wildo setup` resolves the approving administrator by the same local explicit-or-derived policy as fresh local init; non-local setup requires explicit inputs. Setup reconfiguration preserves existing administrator and approver identities and passwords, and fills a missing approver through that policy. Completed setup remains a no-op unless reconfiguration is requested. Generic additive secret provisioning does not invent an absent identity. To prepare an existing environment, author `approver.email`, `approver.firstName`, `approver.lastName` and `approver.password` in its selected secrets store, preserving every unrelated value. For a targeted identity-only repair, edit that block directly; setup reconfiguration also regenerates infrastructure configuration and may deploy Kubernetes, so it is broader than adding an identity. Do not rotate secrets. For an already-running local platform, use `wildo local init --register-only` afterwards to forward the identity into application seeding. Check the seeding outcome and actual approving account; repeated seeding preserves an existing approver's password. Non-local environments require an explicitly supplied identity and use their own provisioning workflow.
|
|
216
|
+
|
|
217
|
+
### Distinguish registration, schema preparation and first records
|
|
218
|
+
|
|
219
|
+
Registration prepares the selected application's platform records, requested service access and key material. Runtime files are projections of that prepared target. This does not deploy its workloads or establish that an application is serving traffic.
|
|
220
|
+
|
|
221
|
+
For a PostgreSQL application with schema migrations, the CLI registers with application seeding deferred, applies the application's migrations, then registers again with seeding required. The second registration also applies role grants to the tables that now exist; replacing it with a seed-only step would omit that provisioning work. Follow the CLI workflow rather than invoking its internal helpers separately.
|
|
222
|
+
|
|
223
|
+
Read the returned `appDatabaseSeeding` outcome at the phase that produced it:
|
|
224
|
+
|
|
225
|
+
| Outcome | What it proves | Next interpretation |
|
|
226
|
+
| --- | --- | --- |
|
|
227
|
+
| `DEFERRED` | Application bootstrap rows were deliberately skipped | Expected before schema preparation, not completion after it |
|
|
228
|
+
| `SEEDED` | Bootstrap rows exist in the application's own database | Still verify authenticated runtime configuration and the actual workload separately |
|
|
229
|
+
| `NO_PERSISTENCE_TARGET` | No application persistence target was resolved | Diagnose the selected database target; migration or retry alone cannot supply one |
|
|
230
|
+
|
|
231
|
+
This is a seeding outcome, not a per-service readiness report or an infrastructure transaction receipt. Registration uses upserts to support repeat attempts, but provisioning stages can have independent outcomes. Inspect required services and the selected initialization path's authenticated config-read completion boundary. Treat explicit override or credential rotation as separate operator actions, not routine repair.
|
|
232
|
+
|
|
173
233
|
### Step 4: Verify the project generation
|
|
174
234
|
|
|
175
|
-
For project initialization or repair, run `wildo local init` and require its
|
|
235
|
+
For full project initialization or repair, run `wildo local init` and require its
|
|
176
236
|
final coherent-generation result. Before returning zero it waits for backing
|
|
177
237
|
services, runs idempotent apps-manager INIT, validates canonical app/config/
|
|
178
238
|
secrets state, readiness-gates every native platform service, registers the
|
|
@@ -180,6 +240,12 @@ application once, emits every backend/companion/frontend/worker/minion env
|
|
|
180
240
|
projection from that snapshot, and executes a signed platform-to-platform
|
|
181
241
|
managed-config read.
|
|
182
242
|
|
|
243
|
+
For registration into an existing platform, keep `--register-only` on the
|
|
244
|
+
verification command. Require the same signed managed-config postcondition
|
|
245
|
+
and reported backend/companion/frontend/worker/minion target projections.
|
|
246
|
+
This verifies the selected application's registration and runtime material;
|
|
247
|
+
it does not claim to have repaired or reinitialized the shared platform.
|
|
248
|
+
|
|
183
249
|
Use `docker ps` as supporting infrastructure evidence, not as initialization
|
|
184
250
|
proof:
|
|
185
251
|
|
|
@@ -189,27 +255,43 @@ docker ps --filter "name=wildo" --format "table {{.Names}}\t{{.Status}}"
|
|
|
189
255
|
|
|
190
256
|
Every service the authored config declared with `BackingServiceSource.SELF`
|
|
191
257
|
should appear (`wildo-mongodb`, `wildo-valkey`, `wildo-rabbitmq`,
|
|
192
|
-
`wildo-minio`, `wildo-
|
|
258
|
+
`wildo-minio`, `wildo-clamav`, …) with `Status` either
|
|
193
259
|
`healthy` or `health: starting` (clamav has a long signature-DB warm-up
|
|
194
260
|
period — `start_period: 120s`).
|
|
195
261
|
|
|
196
|
-
If a declared service is **not** listed, the
|
|
197
|
-
with `backingServices` from the authored config — re-run `wildo setup`
|
|
198
|
-
(see Step 1, last row). If a service is listed but unhealthy, read
|
|
262
|
+
If a declared self-hosted service is **not** listed, compare the authored declaration, selected environment state and generated workload. For supported local state, run `wildo config sync` and inspect its reconciliation result before startup; use setup only when state/secrets are missing or the reported unsupported path requires it. If a service is listed but unhealthy, read
|
|
199
263
|
`references/local-environment-troubleshooting.md`.
|
|
200
264
|
|
|
201
265
|
### Step 5: Handoff
|
|
202
266
|
|
|
203
|
-
- For day-to-day app work, run `wildo local dev` after
|
|
267
|
+
- For day-to-day app work, run `wildo local dev` after the selected initialization
|
|
268
|
+
path (`wildo local init`, or `wildo local init --register-only` for a second app).
|
|
204
269
|
Initialization and runtime supervision are distinct: `local init` leaves
|
|
205
270
|
backing services and the platform control plane ready; `local dev` starts
|
|
206
271
|
application runtimes and reconciles initialization idempotently.
|
|
207
272
|
- If the user is iterating on `wildo.infra.<env>.config.ts`, they will
|
|
208
|
-
re-enter this skill at Step 1 row
|
|
273
|
+
re-enter this skill at the matching Step 1 configuration-change row when they change the
|
|
209
274
|
file. **Editing the file alone does not regenerate compose** —
|
|
210
275
|
authored truth is decoupled from rendered artifacts on purpose, so
|
|
211
276
|
the AI must drive the regeneration.
|
|
212
277
|
|
|
278
|
+
## Reading and stopping a running stack
|
|
279
|
+
|
|
280
|
+
Three commands beyond the lifecycle verbs, useful in the loop rather than at setup:
|
|
281
|
+
|
|
282
|
+
| command | what it is for |
|
|
283
|
+
|---|---|
|
|
284
|
+
| `wildo local logs` | tail the infrastructure services |
|
|
285
|
+
| `wildo local dev-status` | a VERSIONED SNAPSHOT DOCUMENT — emitted for a tool to read, not a person. Prefer it over `local status` when you are the one consuming the answer |
|
|
286
|
+
| `wildo dev force-stop` | reap orphaned watchers and LEAVE INFRASTRUCTURE ALONE — the right stop when watchers are stuck and the backing services are healthy |
|
|
287
|
+
|
|
288
|
+
`wildo local dev-status` is the one to reach for as an agent: `local status` is written for a person,
|
|
289
|
+
and this emits a structured document with a version on it, so parsing it is not screen-scraping.
|
|
290
|
+
|
|
291
|
+
`wildo dev force-stop` is narrower than it sounds and that is the point — it does not take the stack
|
|
292
|
+
down, so it is safe when the diagnosis is "watchers are wedged" rather than "the environment is
|
|
293
|
+
broken".
|
|
294
|
+
|
|
213
295
|
## Worked Example
|
|
214
296
|
|
|
215
297
|
The canonical lifecycle is **setup once → initialize repeatedly**, with
|
|
@@ -219,19 +301,32 @@ come back here for the per-command rationale.
|
|
|
219
301
|
|
|
220
302
|
What earns each line:
|
|
221
303
|
|
|
222
|
-
- `wildo -y setup`
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
304
|
+
- `wildo -y setup` initializes missing environment state and secrets, or
|
|
305
|
+
follows an explicit setup-required diagnostic. It walks the setup prompts and preserves existing
|
|
306
|
+
credentials. Setup has neither a credential-rotation prompt nor a `--rotate-secrets` option.
|
|
307
|
+
An unreadable or invalid existing secrets file stops setup rather than authorizing replacement.
|
|
308
|
+
- For an existing supported LOCAL environment, non-CI `wildo config sync`
|
|
309
|
+
reconciles the authored descriptor into generated config and environment state
|
|
310
|
+
before rendering. Local runtime bootstrap also refreshes those authored inputs.
|
|
311
|
+
Setup is therefore not the only way to refresh `backingServices`.
|
|
312
|
+
- That reconciliation skips non-local environments, missing registry state and
|
|
313
|
+
missing authored descriptors. CI reconstructs its configuration through its own
|
|
314
|
+
path. Unsupported authored reconstruction (currently Atlas metadata) explicitly
|
|
315
|
+
retains the generated snapshot; an invalid or mismatched authored file is an
|
|
316
|
+
error and stops sync rather than silently reusing old configuration.
|
|
317
|
+
- Refresh assigns the authored `backingServices` object when present. If the whole
|
|
318
|
+
object is absent, the existing value is retained; omission is not a general
|
|
319
|
+
delete operation. Review the resolved state and rendered workloads after a change.
|
|
320
|
+
Editing generated Compose files cannot update the authored source.
|
|
230
321
|
- `wildo local init` owns the complete convergence boundary. It regenerates
|
|
231
322
|
missing artifacts, starts and gates infrastructure, reconciles platform
|
|
232
323
|
credentials/database state, registers the application once, emits every
|
|
233
324
|
runtime target, and executes the signed config-read postcondition.
|
|
234
|
-
- `wildo local
|
|
325
|
+
- `wildo local init --register-only` adds the selected application to an
|
|
326
|
+
existing healthy platform. It reconciles that application's registration,
|
|
327
|
+
credentials and runtime env targets, then verifies the signed config read;
|
|
328
|
+
it bypasses shared process cleanup, backing-service convergence and platform INIT.
|
|
329
|
+
- In framework-developer context only, `wildo local reinit` performs the backing-data wipe first and then delegates
|
|
235
330
|
to that same initialization journey. It is the clean-room recovery command;
|
|
236
331
|
there is no second bootstrap implementation to drift.
|
|
237
332
|
|
|
@@ -239,11 +334,10 @@ What this loop does **not** do:
|
|
|
239
334
|
|
|
240
335
|
- Does **not** rotate secrets. The `secrets.json` written in a previous
|
|
241
336
|
`wildo setup` is reused. To rotate, run `wildo config sync
|
|
242
|
-
--rotate-secrets` (explicit opt-in)
|
|
243
|
-
during `wildo setup`.
|
|
337
|
+
--rotate-secrets` (explicit opt-in). Setup preserves existing credentials.
|
|
244
338
|
- `wildo local init` does **not** wipe backing-service data or rotate authored
|
|
245
339
|
secrets. It can repair platform-owned records and generated projections.
|
|
246
|
-
- `wildo local reinit` **does** wipe `./.wildo-saas/local_data/<service>/`, but
|
|
340
|
+
- Framework-developer-only `wildo local reinit` **does** wipe `./.wildo-saas/local_data/<service>/`, but
|
|
247
341
|
still preserves authored `secrets.json` unless secret rotation was separately
|
|
248
342
|
and explicitly requested.
|
|
249
343
|
|
|
@@ -252,9 +346,14 @@ What this loop does **not** do:
|
|
|
252
346
|
- `references/initialization-recovery-recipe.md` — setup, non-destructive
|
|
253
347
|
initialization/repair, destructive reinitialization, runtime start, and reset
|
|
254
348
|
- `references/wildo-cli-bootstrap-commands.md` — full command reference
|
|
255
|
-
for `wildo setup`, `wildo local init/reinit/up/down/reset`,
|
|
256
|
-
|
|
257
|
-
|
|
349
|
+
for `wildo setup`, `wildo local dev/init/reinit/up/down/reset/doctor/status/logs`,
|
|
350
|
+
`wildo dev force-stop`, and `wildo config sync/validate/mutate/reapply-declaration`,
|
|
351
|
+
including the flag matrix, the `--force` vs `--rotate-secrets`
|
|
352
|
+
distinction, and the "I changed X → run Y" routing table
|
|
353
|
+
- `references/framework-upgrade-and-dependency-alignment.md` — `wildo update`
|
|
354
|
+
(move the CLI and this application to a release, and what it owes afterwards),
|
|
355
|
+
then `wildo align-deps`: why the second install is not optional, and the
|
|
356
|
+
undeclared-peer trap that no repeated install can fix
|
|
258
357
|
- `references/local-environment-troubleshooting.md` — symptom-driven
|
|
259
358
|
triage for the most common failure modes (missing manifest, missing
|
|
260
359
|
config.json, arm64 image incompatibilities, docker-credential-helper
|
|
@@ -266,6 +365,11 @@ What this loop does **not** do:
|
|
|
266
365
|
|
|
267
366
|
## Verification
|
|
268
367
|
|
|
368
|
+
For `--register-only`, verify the selected app's active environment, existing config/secrets,
|
|
369
|
+
reported runtime targets and signed config-read result. The compose/service convergence
|
|
370
|
+
checks below apply to full initialization; do not run full init merely to satisfy them
|
|
371
|
+
while another app owns a healthy shared platform.
|
|
372
|
+
|
|
269
373
|
- [ ] `./.wildo-saas/state/environments.json` exists and `currentEnvironment`
|
|
270
374
|
points to the env you bootstrapped
|
|
271
375
|
- [ ] `./.wildo-saas/state/environments.json` `environments.<env>.backingServices`
|
|
@@ -281,7 +385,8 @@ What this loop does **not** do:
|
|
|
281
385
|
- [ ] `docker ps --filter "name=wildo"` shows every declared service
|
|
282
386
|
`Up` and `healthy` (or `health: starting` for clamav during the
|
|
283
387
|
first 2 minutes)
|
|
284
|
-
- [ ]
|
|
388
|
+
- [ ] The selected init command (including `--register-only` for a live shared
|
|
389
|
+
platform) exits zero and reports that the platform JWT/config
|
|
285
390
|
postcondition was verified
|
|
286
391
|
- [ ] `./.wildo-saas/logs/local/platform-apps-manager-init.log` contains the
|
|
287
392
|
INIT generation diagnostic when reconciliation fails
|
|
@@ -307,23 +412,25 @@ Run from the app root, substituting `<env>` (typically `local`):
|
|
|
307
412
|
| **No secret values** in the authored infra config (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.<env>.config.ts` |
|
|
308
413
|
| `secrets.json` has not been re-written by an unintended sync | `git status --porcelain infrastructure/<env>/secrets/secrets.json` (should be empty unless you explicitly rotated) |
|
|
309
414
|
|
|
310
|
-
|
|
311
|
-
`
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
415
|
+
Compare the authored hosting choices, the selected environment's
|
|
416
|
+
`backingServices` state and the generated workloads together. Each enabled
|
|
417
|
+
self-hosted service should have its expected workload and resolved ports;
|
|
418
|
+
managed services should not gain a local container. A mismatch calls for
|
|
419
|
+
checking the sync reconciliation result and selected environment, rather
|
|
420
|
+
than assuming setup failed. Missing initial state or secrets still requires
|
|
421
|
+
setup; supported local edits can be refreshed by config sync.
|
|
316
422
|
|
|
317
423
|
## Common Rationalizations
|
|
318
424
|
|
|
319
425
|
| Rationalization | Reality |
|
|
320
426
|
|-----------------|---------|
|
|
321
|
-
| "
|
|
427
|
+
| "Full init refuses while another app is running; I should stop it" | For second-app onboarding, use `wildo local init --register-only` with existing config/secrets and a healthy platform. The live-owner refusal protects shared services; it does not require an outage for application registration. |
|
|
428
|
+
| "I'll just hand-edit `docker-compose.wildo-platform.yml` to add the missing service" | The file is regenerated from `wildo.infra.<env>.config.ts` on every `wildo config sync` and on every self-heal pass of `wildo local up`. Add the service to the **authored** config and run `wildo config sync` for supported local state, then the intended startup command. Inspect any skipped/unsupported result; initial or missing setup state still requires `wildo setup`. Hand edits to generated files are silently overwritten — and the developer who comes after you will not know why the change reverted. |
|
|
322
429
|
| "`wildo local up` says config.json is missing — let me create it manually" | Creating `config.json` by hand drifts it from the authored truth and from the schema. The CLI's runtime-bootstrap pre-flight regenerates `config.json` from `wildo.infra.<env>.config.ts` automatically when it is missing — re-running `wildo local up` rebuilds it. If the pre-flight fails, the right fix is to make the authored config valid, not to fabricate the generated artifact. |
|
|
323
|
-
| "`--force` will fix it; it always works" | `--force` is
|
|
430
|
+
| "`--force` will fix it; it always works" | `--force` is command-specific: on setup it requests reconfiguration, not credential rotation; other commands may use it to skip confirmations. It does NOT substitute for an explicit destructive-operation flag. Using `--force` to "make it work" without understanding what it will overwrite leads to silent rotation of generated artifacts, not silent rotation of secrets — but it also conditions you to ignore the prompts you should be reading. Read the prompt; pick the explicit flag. |
|
|
324
431
|
| "I'll delete `secrets.json` and let `wildo setup` recreate it" | Deleting `secrets.json` is the most destructive action available — it rotates every credential the file holds, breaking any deployed environment that shares them and forcing re-issuance of OIDC client secrets, S3 access keys, JWT signing material, etc. Use `wildo config sync --rotate-secrets` only when rotation is the *intent*, not as a recovery mechanism. For recovery, restore from the secrets backup or from a teammate's checkout. |
|
|
325
432
|
| "I'll `rm -rf ./.wildo-saas/local_data` to reset mongodb" | Deleting bind-mounted data while the container is running can corrupt the mount and leave mongodb wedged. Use `wildo local reset` — it runs `docker compose down` first, then `rm -rf`s `local_data/<service>/`. The composed sequence is the contract; the raw `rm -rf` is not. |
|
|
326
|
-
| "All containers are healthy, so initialization is complete" | Container health proves only the backing-service plane. It does not prove platform credentials, Mongo records, app registration, generated env projections, or JWT verification-key coherence. Run `wildo local init
|
|
433
|
+
| "All containers are healthy, so initialization is complete" | Container health proves only the backing-service plane. It does not prove platform credentials, Mongo records, app registration, generated env projections, or JWT verification-key coherence. Run the selected initialization path: `wildo local init --register-only` for application registration into a healthy live platform, or full `wildo local init` for platform convergence without a live owner. Require its signed config-read completion boundary. |
|
|
327
434
|
| "The clamav image hangs forever on Apple Silicon, so let me skip it" | Cisco only publishes `clamav/clamav` for `linux/amd64` (no arm64 manifest), so `docker compose pull` would fail on Apple Silicon. The compose template already pins `platform: linux/amd64` for clamav so it runs under Rosetta. If clamav still hangs, it is the Docker Desktop credential helper (`docker-credential-desktop get`), not clamav itself — read the troubleshooting reference. |
|
|
328
435
|
|
|
329
436
|
## Red Flags
|
|
@@ -342,8 +449,8 @@ didn't show up in compose").
|
|
|
342
449
|
- A backing service in `wildo.infra.<env>.config.ts` that does not
|
|
343
450
|
appear under `services:` in the compose file (catch with the
|
|
344
451
|
**Compose file declares every authored backing service** Verification
|
|
345
|
-
step —
|
|
346
|
-
|
|
452
|
+
step — inspect the selected environment, authored hosting choice and sync
|
|
453
|
+
reconciliation result; a missing workload alone does not identify a setup failure)
|
|
347
454
|
- `wildo local up` exits 0 but `docker ps --filter "name=wildo"` is
|
|
348
455
|
empty (catch with the **`docker ps`** Verification step — typically
|
|
349
456
|
means `docker compose` itself failed silently while the CLI's
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
# Moving to a new framework release — `wildo update`
|
|
2
|
+
|
|
3
|
+
Run it inside this application:
|
|
4
|
+
|
|
5
|
+
```bash
|
|
6
|
+
wildo update --check # CLI, application and target release — changes nothing
|
|
7
|
+
wildo update # move to the latest release
|
|
8
|
+
wildo update --to <version> # move to an exact release, up or down (from 1.1.5 on)
|
|
9
|
+
wildo update --tag <tag> # follow another published channel (e.g. next)
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
It moves the two homes of a release, in this order:
|
|
13
|
+
|
|
14
|
+
1. **The CLI.** The scaffold templates, the compose and k8s templates and the platform image tag
|
|
15
|
+
travel with it. The new one is installed beside the current one, verified, and only then made
|
|
16
|
+
the one `wildo` runs; the previous one is removed on the next update.
|
|
17
|
+
2. **This application**, run by the NEW CLI: every `@wildo-ai/*` pin in `pnpm.overrides`, the
|
|
18
|
+
companion and workbench drops (the workbench drop is created if this application predates it), `pnpm install` → dependency alignment → `pnpm install`, the delivered templates,
|
|
19
|
+
docs, skills and rules, and the deploy manifests (`config sync --domain manifest`).
|
|
20
|
+
|
|
21
|
+
It restarts nothing. Afterwards `wildo local up` puts the platform on the release's image, and
|
|
22
|
+
restarting `wildo local dev` runs the application and its companion on the new packages.
|
|
23
|
+
|
|
24
|
+
## When the release asks for something this application does not declare
|
|
25
|
+
|
|
26
|
+
A release can make a declaration REQUIRED that older applications do not have. `wildo update` then
|
|
27
|
+
lists each field (`organizationTypes: Invalid input: expected record, received undefined`) and skips
|
|
28
|
+
the manifest step. The update itself has succeeded; the application owes a declaration.
|
|
29
|
+
|
|
30
|
+
Add it to `wildo.saas.config.ts`. The current scaffold's version of that file is delivered at
|
|
31
|
+
`.wildo-saas/templates/skeleton/wildo.saas.config.ts.init.hbs` — use it as the reference for the
|
|
32
|
+
shape, and choose the VALUES for this application: they are usually product decisions (a tenancy
|
|
33
|
+
model, which user types administer), which is why nothing writes them for you. Then run
|
|
34
|
+
`wildo config sync`.
|
|
35
|
+
|
|
36
|
+
## What it will not touch
|
|
37
|
+
|
|
38
|
+
- **A framework linked from a checkout** (`file:` pins) — that application follows the checkout.
|
|
39
|
+
- **A CLI it did not install** — if `wildo` came from `npm install -g`, upgrade it the same way; the
|
|
40
|
+
update will not write beside, or clean, a directory it does not own.
|
|
41
|
+
- **A release older than 1.1.5** — the first one that has `wildo update`. Installing an older one
|
|
42
|
+
this way would leave a CLI that cannot update itself; use the installer's `--cli-version` instead.
|
|
43
|
+
|
|
44
|
+
## What runs underneath: `wildo align-deps`
|
|
45
|
+
|
|
46
|
+
When this application was scaffolded, the third-party versions it pins and the peer dependencies each
|
|
47
|
+
of its packages declares were computed from the framework **at that moment**. Nothing recomputes them
|
|
48
|
+
afterwards unless something asks — `wildo update` asks on every release. `wildo align-deps` is the
|
|
49
|
+
command that re-derives them, and you can run it on its own; it needs no framework checkout.
|
|
50
|
+
|
|
51
|
+
## The order by hand, and why the second install is not optional
|
|
52
|
+
|
|
53
|
+
`wildo update` does this for you. By hand it is:
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
# 1. bump the @wildo-ai/* entries in this application's pnpm.overrides
|
|
57
|
+
pnpm install # 2. the new pin set can only be READ once it is on disk
|
|
58
|
+
wildo align-deps --write # 3. re-derive pins and peer declarations
|
|
59
|
+
pnpm install # 4. the peer half takes effect only now
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Step 2 comes before step 3 because the command derives everything from the `@wildo-ai` packages
|
|
63
|
+
resolved in this application's own tree. It cannot report on a release that is not installed yet.
|
|
64
|
+
|
|
65
|
+
Step 4 is required because `align-deps` **writes manifests only**. It does not install, so the
|
|
66
|
+
lockfile is unchanged until you install again.
|
|
67
|
+
|
|
68
|
+
## Run it once after the very first install too
|
|
69
|
+
|
|
70
|
+
A freshly scaffolded application legitimately needs one alignment run. Scaffolding writes pins from
|
|
71
|
+
the framework **checkout** while pinning the framework itself to the **published release**, and those
|
|
72
|
+
two disagree whenever the checkout is ahead of the last release — which, between releases, is always.
|
|
73
|
+
This is expected, not a defect.
|
|
74
|
+
|
|
75
|
+
## Default is read-only
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
wildo align-deps # report; exits NON-ZERO on drift
|
|
79
|
+
wildo align-deps --write # apply
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## The trap: a peer nobody declares can never be re-resolved
|
|
83
|
+
|
|
84
|
+
This is the failure worth understanding, because every obvious remedy does nothing.
|
|
85
|
+
|
|
86
|
+
An override rewrites a version some manifest **wrote down**. It never creates one. So a peer
|
|
87
|
+
dependency that no manifest declares is resolved automatically once, that resolution is recorded, and
|
|
88
|
+
it is then never re-derived downward. Running the same install again — repeatedly, or with `--force`
|
|
89
|
+
— changes nothing.
|
|
90
|
+
|
|
91
|
+
The symptom arrives much later: a version range narrows, and a resolution frozen months earlier
|
|
92
|
+
starts reading as a live version conflict. At that point **the code looks like the culprit and is
|
|
93
|
+
not.** The fix is to move the SPECIFIER, which is what `align-deps` does by declaring the peer.
|
|
94
|
+
|
|
95
|
+
A related finding it reports and you should not dismiss: **a peer declared at a concrete version
|
|
96
|
+
rather than as `*`.** The framework's pin then cannot reach it, so a later version bump silently will
|
|
97
|
+
not land. Declare framework-managed peers as `"*"` and let the override decide the version.
|
|
98
|
+
|
|
99
|
+
## What it will not do, deliberately
|
|
100
|
+
|
|
101
|
+
- **It never changes a framework version.** Which release to adopt is your decision, stated as
|
|
102
|
+
`wildo update --to`; everything else follows mechanically from it.
|
|
103
|
+
- **It never removes a name.** A managed name the closure does not require may still be this
|
|
104
|
+
application's own dependency. An early version that pruned "surplus" entries stripped real
|
|
105
|
+
dependencies out of two packages.
|
|
106
|
+
- It does not install (above).
|
|
107
|
+
|
|
108
|
+
## Exclusions are yours
|
|
109
|
+
|
|
110
|
+
The exclusions file is seeded into the application when it is scaffolded, and it is the right owner:
|
|
111
|
+
this application knows which names its own toolchain controls, and it is the party that breaks when
|
|
112
|
+
the judgement is wrong. Add a name there — with the measurement that justifies it — rather than
|
|
113
|
+
fighting the report.
|
|
114
|
+
|
|
115
|
+
## New workspace packages are born aligned
|
|
116
|
+
|
|
117
|
+
A composition scenario that creates a new package inside this application (a website, a
|
|
118
|
+
documentation site, a background worker) reads a delivered copy of the peer closure, so it starts
|
|
119
|
+
with the peers it needs declared rather than with none. You do not have to hand-declare them.
|
|
@@ -10,14 +10,17 @@ Mongo deletion commands.
|
|
|
10
10
|
wildo setup --non-interactive # CI/headless; requires admin seed env vars
|
|
11
11
|
# or: wildo setup # interactive developer setup
|
|
12
12
|
|
|
13
|
-
#
|
|
13
|
+
# First initialization or shared-platform repair without a live owner.
|
|
14
14
|
wildo local init
|
|
15
15
|
|
|
16
|
-
#
|
|
16
|
+
# For a healthy existing platform, register only the selected application instead:
|
|
17
|
+
wildo local init --register-only
|
|
18
|
+
|
|
19
|
+
# In a local Compose environment, start application runtimes after initialization.
|
|
17
20
|
wildo local dev
|
|
18
21
|
```
|
|
19
22
|
|
|
20
|
-
When local backing data itself must be discarded, use the composed command:
|
|
23
|
+
When local backing data itself must be discarded, framework developers can use the composed command. It requires a targeted application root, resolved framework path and framework-developer mode; `--force` does not bypass those checks. Application creators can explicitly run `local reset`, then `local init` separately:
|
|
21
24
|
|
|
22
25
|
```bash
|
|
23
26
|
# Stops graph-supervised/tracked processes, performs the same wipe as reset,
|
|
@@ -39,7 +42,7 @@ wildo local reset --force
|
|
|
39
42
|
|---|---|
|
|
40
43
|
| Authored environment state and secrets | `wildo setup` |
|
|
41
44
|
| Generated config/compose/env artifacts | runtime bootstrap inside `wildo local init` (or scoped `wildo config sync`) |
|
|
42
|
-
| Backing services and initializer readiness | `wildo local init`
|
|
45
|
+
| Backing services and initializer readiness | `wildo local init` for both audiences; `wildo local reinit` for framework developers only |
|
|
43
46
|
| Platform credentials, canonical Mongo records, native service readiness | apps-manager INIT + platform lifecycle inside `wildo local init` |
|
|
44
47
|
| Application registration and all runtime projections | application bootstrap inside `wildo local init` |
|
|
45
48
|
| Executable completion proof | signed platform-to-platform managed-config read inside `wildo local init` |
|