@wildo-ai/framework-knowledge 1.1.4 → 1.1.6
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/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- 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 +547 -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/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -4
- 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 +135 -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 +208 -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 +218 -9
- 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 +374 -11
- 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 +6 -4
- 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 +22 -20
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -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 +188 -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 +74 -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 +80 -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 +18 -8
- 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 +81 -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 +31 -11
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
- 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 +68 -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 +84 -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 +69 -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 +2 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +1 -2
- 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 +78 -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 +93 -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 +104 -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 +184 -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/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/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 +172 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- 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 +158 -5
- 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 +173 -5
- 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 +6 -5
- 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 +9 -8
- 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 +23 -4
- 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 +6 -4
- 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 +22 -13
- 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 +193 -28
- 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 +173 -34
- 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 +3 -2
- 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 +7 -3
- 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 +183 -6
- 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 +192 -6
- 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 +3 -2
- 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 +4 -3
- 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 +173 -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 +264 -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.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/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 +3 -2
- 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 +7 -3
- 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 +3 -2
- 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 -4
- 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 +33 -5
- 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 +28 -4
- 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 +3 -3
- 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 +5 -3
- 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 +6 -4
- 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 +19 -5
- 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 +156 -5
- 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 -5
- 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 +7 -6
- 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 +28 -19
- 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 +40 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -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 +1234 -80
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
- 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 +743 -64
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -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 +67 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -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 +964 -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 +191 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- 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 +349 -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 +24 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -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 +211 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -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 +40 -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 +37 -14
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -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 +245 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -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 -13
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
- 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 +57 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
- 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 +24 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
- 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/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- 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 +649 -10
- 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 +174 -0
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- 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 +28 -22
- 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-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -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.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- 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 +46 -16
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -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 +16 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +318 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +217 -0
- package/dist/knowledge/references/market.alternative.config.md +2 -2
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +4 -4
- package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
- package/dist/knowledge/references/market.gain.config.md +2 -2
- package/dist/knowledge/references/market.icp.config.md +3 -3
- package/dist/knowledge/references/market.job.config.md +2 -2
- package/dist/knowledge/references/market.message-template.config.md +3 -3
- package/dist/knowledge/references/market.objection.config.md +2 -2
- package/dist/knowledge/references/market.pain.config.md +2 -2
- package/dist/knowledge/references/market.persona.config.md +3 -3
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +2 -2
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
- package/dist/knowledge/references/market.trigger.config.md +2 -2
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +375 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +15 -36
- 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.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -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.functional-requirement.config.md +8 -0
- 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.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- 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 +87 -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.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -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 +19 -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.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -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.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- 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.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -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-data.admin-endpoints.md +56 -2
- 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 +43 -13
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +131 -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.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -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-field-address.lookup-slot.md +74 -0
- 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.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -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 +97 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
- 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.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- 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 +884 -135
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- 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.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -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 +59 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -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 +196 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -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 +244 -32
- 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-submission-challenge.md +54 -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 +16 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -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.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
- 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 +108 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
- package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- 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.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
- 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/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +238 -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 +53 -5
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
- 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 +95 -18
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
- 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 +50 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +4 -2
- package/dist/knowledge/references/zod.factories.duration.md +6 -4
- package/dist/knowledge/references/zod.factories.money.md +5 -3
- 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 +2602 -214
- package/dist/knowledge/registries/playbooks.json +468 -92
- package/dist/knowledge/registries/source-tags.json +6171 -1996
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +137 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +67 -29
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -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 +11 -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 +95 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
- 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 +214 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -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 +162 -8
- 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 +518 -132
- 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 +162 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- 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-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +44 -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 +200 -19
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- 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 +13 -9
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -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 +157 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -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 +139 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -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 +66 -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 +397 -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 +143 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -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 +192 -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 +259 -0
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -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 +100 -91
- 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 +123 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -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 +60 -27
- 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-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
- 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-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -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 +3988 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -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 +14 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
- 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 +198 -36
- 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/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -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/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
- package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
- package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -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 +3 -2
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -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 +144 -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/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -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-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -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-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
- 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-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -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 +141 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -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 +13 -5
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -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 +29 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -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 +953 -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 +125 -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 +595 -45
- 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 +259 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -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 +1242 -31
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -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 +44 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -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-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -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/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -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 +50 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
- 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 +78 -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 +300 -23
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -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/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
- package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -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 +188 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -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 +3 -1
- 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 +44 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- 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 +4 -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 +72 -13
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
- package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -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 +12659 -4142
- 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/skills/journey-approve/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: infra-environment-config
|
|
3
|
-
description: Edit infrastructure environment configuration for local and deployed targets — the typed `defineInfraEnvConfig({...})` files declaring `environment`, `runtime`, `publicDomain` (
|
|
3
|
+
description: Edit infrastructure environment configuration for local and deployed targets — the typed `defineInfraEnvConfig({...})` files declaring `environment`, `runtime`, `publicDomain` (required external hostname), `serviceAuth`, `backingServices` (the `BackingServiceKind` map, each with `BackingServiceSource.SELF | MANAGED` plus an orthogonal `provider: '<brand>'`, e.g. `provider: 'atlas'` for MongoDB Atlas), `logging`, `devCompanion`, `kubernetes` (namespace, optional ingressClass and per-service replica settings), and (for remote) `remoteProvider` + `deployment`. Use when the user says "wire up a new external service endpoint", "rotate the staging mongodb to Atlas", "fix the local docker-compose port collision", "add a new environment", "the dev stack can't reach Redis", "where do audit logs get stored", "config sync warns my env has no audit store", or any change that adjusts environment-specific infrastructure wiring.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Infra Environment Config
|
|
@@ -100,8 +101,8 @@ as appropriate.
|
|
|
100
101
|
Every infra file is a single `defineInfraEnvConfig({...})` default
|
|
101
102
|
export. The typed shape carries:
|
|
102
103
|
|
|
103
|
-
- `environment` —
|
|
104
|
-
|
|
104
|
+
- `environment` — validated environment ID: a common `WildoEnvironment`
|
|
105
|
+
member or a custom remote slug (drives local versus remote behavior)
|
|
105
106
|
- `runtime` — typed `WildoDeploymentRuntime.DOCKER_COMPOSE |
|
|
106
107
|
KUBERNETES | …` (drives deploy strategy)
|
|
107
108
|
- `serviceAuth` — JWT access/refresh token lifetimes (algorithm selection is intentionally not authored here)
|
|
@@ -111,8 +112,9 @@ export. The typed shape carries:
|
|
|
111
112
|
kind list and per-kind entry shape** — it is extracted from the
|
|
112
113
|
schema, so unlike a prose list it cannot drift as kinds are added.
|
|
113
114
|
Each entry carries `source: BackingServiceSource.SELF | MANAGED`
|
|
114
|
-
plus an optional `provider: '<brand>'` (e.g. `'atlas'`, `'
|
|
115
|
-
|
|
115
|
+
plus an optional `provider: '<brand>'` (e.g. `'atlas'`, `'minio'`)
|
|
116
|
+
and per-source connection params — but only the combinations listed in
|
|
117
|
+
"What each kind can be declared as today" below are accepted. The legacy
|
|
116
118
|
`BackingServiceSource.ATLAS` value no longer exists — it was
|
|
117
119
|
replaced by the two-axis `(source, provider?)` shape, so Atlas is
|
|
118
120
|
now `source: MANAGED, provider: 'atlas'`
|
|
@@ -132,20 +134,85 @@ export. The typed shape carries:
|
|
|
132
134
|
seam is `publicDomain`. Both `domain` and `kubernetes.baseDomain`
|
|
133
135
|
are strict-rejected by the schema (pinned by
|
|
134
136
|
`define-infra-env-config.unimplemented.test.ts`).
|
|
137
|
+
- `serviceHosts` (optional) — maps a `services.<key>` from
|
|
138
|
+
`wildo.saas.config.ts` to the subdomain chain under `publicDomain` where
|
|
139
|
+
that service is reachable in this environment; `''` mounts it at the apex.
|
|
140
|
+
A service you do not map uses its own key, lowercased, as its subdomain —
|
|
141
|
+
so `backendApi` becomes `backendapi.<publicDomain>`, and a key that is not
|
|
142
|
+
a valid DNS label (an `_`, for instance) needs an explicit entry. The
|
|
143
|
+
ingress routes and the address the application is told it has are both
|
|
144
|
+
resolved from this map by service key, so they agree as long as both are
|
|
145
|
+
built from the same keys. **Two services that resolve to the same host are
|
|
146
|
+
refused, naming both, when a remote environment's ingress routes are
|
|
147
|
+
built** — only one service may take the apex, and an unmapped key can
|
|
148
|
+
collide with a subdomain you authored for another service. A local
|
|
149
|
+
environment builds no ingress and a CDN-served frontend gets no ingress
|
|
150
|
+
route, so neither is checked for a collision.
|
|
135
151
|
- `devCompanion` (local-only) — host + port binding
|
|
136
152
|
- `remoteProvider` + `deployment` (remote-only) — registry
|
|
137
|
-
endpoint, region, branch wiring
|
|
153
|
+
endpoint, region, branch wiring. `remoteProvider.registryEndpoint` is THE
|
|
154
|
+
image registry: the deploy manifests (Compose and Kubernetes) pull every
|
|
155
|
+
image from it and the generated deploy workflow pushes there, logging in
|
|
156
|
+
with the `REGISTRY_USERNAME` / `REGISTRY_TOKEN` repository secrets (falling
|
|
157
|
+
back to the GitHub token for GHCR). There is no `deployment.registry`: a
|
|
158
|
+
second registry field could only repeat the endpoint or send images
|
|
159
|
+
somewhere the cluster never pulls from, so the schema refuses one.
|
|
138
160
|
- `cdn` (remote-only) — OPT-IN per-service map (`cdn?[serviceKey]`)
|
|
139
161
|
that serves a frontend from object storage + a CDN instead of its
|
|
140
162
|
nginx pod. Skips the frontend's Deployment/Service + ingress route
|
|
141
163
|
and pairs with `wildo frontend publish`. The schema rejects `cdn`
|
|
142
164
|
in local. Full workflow (vendor options, Cloudflare + operator
|
|
143
165
|
setup): `frontend-cdn-publish`.
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
166
|
+
- `platformStorage` (remote-only) — `{ bucket }`, the bucket the PLATFORM
|
|
167
|
+
services (apps-manager, module registry) keep their own objects in. It is
|
|
168
|
+
not your application's bucket: that one is `backingServices.s3.bucket`,
|
|
169
|
+
and it travels with your application's registration. Author it when the
|
|
170
|
+
remote object store needs a globally unique name; omitted, the platform
|
|
171
|
+
uses its fixed default bucket. The schema rejects `platformStorage` in
|
|
172
|
+
local, where one platform serves every application beside it and its
|
|
173
|
+
bucket is fixed.
|
|
174
|
+
- `providerSelection` (optional) — chooses a different PRIMARY provider for a
|
|
175
|
+
capability in THIS environment only, in the same `{ primary, whenUnavailable }`
|
|
176
|
+
shape as the application-wide selection in `wildo.saas.config.ts`. The common
|
|
177
|
+
use is a non-sending email provider locally while every remote environment
|
|
178
|
+
keeps the real one:
|
|
179
|
+
`providerSelection: { EMAIL_TRANSACTIONAL: { primary: 'email-preview' } }`.
|
|
180
|
+
It only REORDERS the providers the application already declares with that
|
|
181
|
+
capability enabled — it cannot introduce a provider, and a ref that is not
|
|
182
|
+
declared, or whose capability is disabled, is skipped rather than admitted.
|
|
183
|
+
It has no effect on a fan-out capability (every destination is already
|
|
184
|
+
active), and `whenUnavailable` is ordering, not retry: nothing calls a second
|
|
185
|
+
provider after the first fails, and nothing tests the chosen provider's
|
|
186
|
+
credentials. The authored block is validated at `wildo config sync`; a
|
|
187
|
+
hand-edited environment variable that does not parse is ignored rather than
|
|
188
|
+
refused: nothing stops that environment starting, and it uses the
|
|
189
|
+
application-wide selection instead.
|
|
190
|
+
- `providerConfigurations` (optional) — provider configuration values a vendor
|
|
191
|
+
issued against THIS deployment, in the same
|
|
192
|
+
`providerRef → protocolKind → key` shape as `providerConfigurations` in
|
|
193
|
+
`wildo.saas.config.ts`: an OAuth client ID registered with this environment's
|
|
194
|
+
redirect URI, a frontend SDK DSN or site key, a file-picker app ID. They are
|
|
195
|
+
laid over the application's block KEY BY KEY, this environment winning, so
|
|
196
|
+
author only what differs — application policy such as a coding-agent
|
|
197
|
+
execution profile stays in the SaaS config and is inherited. Example:
|
|
198
|
+
`providerConfigurations: { google: { [ExternalProvider_ExchangeProtocol_Kind.SSO_OAUTH2]: { GOOGLE_OAUTH2_CLIENT_ID: '…' } } }`.
|
|
199
|
+
The merged value reaches both places a provider configuration is read: the
|
|
200
|
+
configuration `wildo config sync` registers with this environment's platform
|
|
201
|
+
(backend readers such as "Sign in with Google") and the provider artifacts a
|
|
202
|
+
build bakes in (a frontend provider's `publicConfig`). An environment that
|
|
203
|
+
authors no value for a vendor identity has none — it never borrows another
|
|
204
|
+
environment's, and a sign-in without a client ID says so. Never a secret: a
|
|
205
|
+
key named like one of the provider's declared secrets (for example
|
|
206
|
+
`GOOGLE_OAUTH2_CLIENT_SECRET`) is refused; those stay in the environment's
|
|
207
|
+
secrets store.
|
|
208
|
+
|
|
209
|
+
Use `WildoEnvironment.*` for the common named environments. Custom remote
|
|
210
|
+
identifiers such as `review-team` are supported: `WildoEnvironmentIdSchema`
|
|
211
|
+
accepts lowercase alphanumeric segments separated by single hyphens. A custom
|
|
212
|
+
environment uses `infrastructure/review-team/wildo.infra.remote.config.ts`;
|
|
213
|
+
only `local` uses `wildo.infra.local.config.ts`. Runtime and backing-service
|
|
214
|
+
source remain closed vocabularies: use `WildoDeploymentRuntime.*` and
|
|
215
|
+
`BackingServiceSource.*` for those fields.
|
|
149
216
|
|
|
150
217
|
### Step 3: Never commit secret values
|
|
151
218
|
|
|
@@ -159,6 +226,8 @@ Read `references/infra-config-files.md` for the secrets-channel
|
|
|
159
226
|
conventions and `references/framework-environment-deployment-api.md`
|
|
160
227
|
for the typed schema reference.
|
|
161
228
|
|
|
229
|
+
For application-wide grant-controlled reads, provision a second application super-administrator in the environment's secrets: the `approver` object contains `email`, `firstName`, `lastName` and `password`. These are identity credentials, not fields in `defineInfraEnvConfig`. Approval requires an identity distinct from the requester. Non-local environments must supply that identity explicitly. Fresh local `wildo init` and `wildo setup` can derive a separate development identity sharing the first administrator's password. Setup preserves existing administrator and approver credentials, including separately chosen passwords. Completed setup is a no-op unless reconfiguration is requested; generic additive secret provisioning does not invent an absent identity. Follow `local-environment-bootstrap` for the non-rotating existing-local registration path. Merely changing the secrets file does not establish that the account was seeded.
|
|
230
|
+
|
|
162
231
|
### Step 4: Restart the dev stack (local) or trigger redeploy (remote)
|
|
163
232
|
|
|
164
233
|
Local edits require restarting `docker-compose` (the dev companion
|
|
@@ -208,18 +277,20 @@ export default defineInfraEnvConfig({
|
|
|
208
277
|
|
|
209
278
|
/**
|
|
210
279
|
* The PLATFORM's own store (apps-manager + module-registry: users, organizations, applications,
|
|
211
|
-
* sessions, API keys). Declared rather than inferred
|
|
212
|
-
* `postgresql
|
|
280
|
+
* sessions, API keys). Declared rather than inferred: it is the selection, and
|
|
281
|
+
* `backingServices.postgresql` below is the substrate.
|
|
213
282
|
*
|
|
214
|
-
*
|
|
215
|
-
*
|
|
216
|
-
* `MONGO_CONNECT_URL` became engine-conditional
|
|
217
|
-
* `env-vars-builder` refuses this block without it any more.
|
|
283
|
+
* The platform has not REQUIRED a MongoDB since 2026-08-28: the six `persistenceAdapter: MONGODB`
|
|
284
|
+
* bootstrap pins retired, crontabs-batches-manager was ported, and apps-manager's
|
|
285
|
+
* `MONGO_CONNECT_URL` became engine-conditional.
|
|
218
286
|
*
|
|
219
|
-
*
|
|
220
|
-
*
|
|
221
|
-
*
|
|
222
|
-
*
|
|
287
|
+
* `backingServices.mongodb` was REMOVED 2026-09-24, by decision: this environment hosts no Mongo-backed application (Wonder
|
|
288
|
+
* Todos, Wonder CRM and every scratch application declare `applicationDatabase: POSTGRESQL`; RAG
|
|
289
|
+
* lives in pgvector). The block used to be kept "for any Mongo-backed application hosted here",
|
|
290
|
+
* and that hosting cost the whole platform on the day its mongod's WiredTiger journal corrupted:
|
|
291
|
+
* apps-manager, module-registry and the companion all died on `ECONNRESET` while every platform
|
|
292
|
+
* row sat in PostgreSQL. A future Mongo-backed application re-declares `backingServices.mongodb`
|
|
293
|
+
* (which also brings mongot back).
|
|
223
294
|
*/
|
|
224
295
|
database: { engine: DatabaseEngine.POSTGRESQL, source: BackingServiceSource.SELF },
|
|
225
296
|
|
|
@@ -237,12 +308,6 @@ export default defineInfraEnvConfig({
|
|
|
237
308
|
applicationDatabase: { engine: DatabaseEngine.POSTGRESQL },
|
|
238
309
|
|
|
239
310
|
backingServices: {
|
|
240
|
-
mongodb: {
|
|
241
|
-
source: BackingServiceSource.SELF,
|
|
242
|
-
database: 'your-app-db',
|
|
243
|
-
host: 'localhost',
|
|
244
|
-
port: 27017,
|
|
245
|
-
},
|
|
246
311
|
redis: {
|
|
247
312
|
source: BackingServiceSource.SELF,
|
|
248
313
|
host: 'localhost',
|
|
@@ -256,25 +321,13 @@ export default defineInfraEnvConfig({
|
|
|
256
321
|
vhost: 'your-app',
|
|
257
322
|
},
|
|
258
323
|
/**
|
|
259
|
-
* Self-hosted PostgreSQL
|
|
324
|
+
* Self-hosted PostgreSQL: the only data store this environment runs, for the platform and for
|
|
325
|
+
* every hosted application alike.
|
|
260
326
|
*
|
|
261
327
|
* This names the APPLICATION's own database, and is distinct from the PLATFORM's engine
|
|
262
328
|
* declared by `database` above. The two are separate axes: `database.engine` decides where the
|
|
263
329
|
* platform's own tables live, while an application's resources move only when that
|
|
264
330
|
* application's backend selects `DATABASE_DEFAULT_ADAPTER`.
|
|
265
|
-
*
|
|
266
|
-
* ⚠️ CORRECTED 2026-08-19. This comment used to warn that flipping `database.engine` to
|
|
267
|
-
* PostgreSQL "would delete MongoDB from the rendered compose file and take the whole platform
|
|
268
|
-
* down with it", and instructed authors to declare PostgreSQL only here. That exclusivity was
|
|
269
|
-
* real when written — `needsLocalMongoDB` was `engine === MONGODB && source === SELF` — and it
|
|
270
|
-
* is now gone: `database.engine` IS PostgreSQL on line 36, and `defineInfraEnvConfig`'s
|
|
271
|
-
* superRefine used to REQUIRE `backingServices.mongodb: SELF` whenever the engine is PostgreSQL.
|
|
272
|
-
* It no longer does (2026-08-28): the six bootstrap resources that were pinned to MongoDB
|
|
273
|
-
* (`wildoApplication`, `wildoApplicationConfig`, `wildoApplicationSecrets`,
|
|
274
|
-
* `platformApplications`, `platformApplicationsConfig`, `platformApplicationsSecrets`) had their
|
|
275
|
-
* pins retired on 2026-08-22 and now follow the platform's configured engine like every other
|
|
276
|
-
* platform resource. Both stores are still declared above and both are still rendered — by
|
|
277
|
-
* choice now, not by obligation.
|
|
278
331
|
*/
|
|
279
332
|
postgresql: {
|
|
280
333
|
source: BackingServiceSource.SELF,
|
|
@@ -288,12 +341,10 @@ export default defineInfraEnvConfig({
|
|
|
288
341
|
endpoint: 'http://localhost:9000',
|
|
289
342
|
bucket: 'your-app-local',
|
|
290
343
|
},
|
|
291
|
-
// Optional `port` override:
|
|
292
|
-
// different host port than its framework default
|
|
293
|
-
//
|
|
294
|
-
//
|
|
295
|
-
// listens on its internal port. Here Gotenberg is published on 3200.
|
|
296
|
-
gotenberg: { source: BackingServiceSource.SELF, port: 3200 },
|
|
344
|
+
// Optional `port` override: a self-hosted service may publish on a
|
|
345
|
+
// different host port than its framework default when the default is
|
|
346
|
+
// already taken on the host — only the host-side mapping changes, the
|
|
347
|
+
// container still listens on its internal port. No service here needs one.
|
|
297
348
|
clamav: { source: BackingServiceSource.SELF },
|
|
298
349
|
// Audit Phase 2 — self-hosted immudb (tamper-evident audit-log store). Boots
|
|
299
350
|
// the local immudb container so `wildo local up` dogfoods the compose ⇄ k8s
|
|
@@ -368,11 +419,14 @@ export default defineInfraEnvConfig({
|
|
|
368
419
|
app: {
|
|
369
420
|
extraDirectives: {
|
|
370
421
|
'connect-src': ['http://localhost:4241'],
|
|
371
|
-
// PDF.js parses documents on a Web Worker
|
|
372
|
-
//
|
|
373
|
-
//
|
|
374
|
-
//
|
|
375
|
-
//
|
|
422
|
+
// PDF.js parses documents on a Web Worker created through Vite's `?worker`
|
|
423
|
+
// import, which emits the worker as a same-origin FILE (never a CDN). Vite
|
|
424
|
+
// builds a `blob:`/`data:` worker only for `?worker&inline`, which the viewer
|
|
425
|
+
// does not use — so `'self'` is the source that matters, and the SaaS app
|
|
426
|
+
// baseline's `script-src 'self'` would already cover it through the CSP
|
|
427
|
+
// `worker-src` fallback if this directive were absent. `blob:` is therefore
|
|
428
|
+
// NOT required; it is harmless here (it admits only blob URLs page script
|
|
429
|
+
// itself created) but is a candidate for narrowing to `'self'`.
|
|
376
430
|
'worker-src': ["'self'", 'blob:'],
|
|
377
431
|
},
|
|
378
432
|
},
|
|
@@ -408,6 +462,27 @@ export default defineInfraEnvConfig({
|
|
|
408
462
|
},
|
|
409
463
|
},
|
|
410
464
|
|
|
465
|
+
/**
|
|
466
|
+
* Provider configuration issued against THIS environment, laid over `wildo.saas.config.ts > providerConfigurations`.
|
|
467
|
+
*
|
|
468
|
+
* "Sign in with Google" (#1136): the OAuth client belongs to the local development Google project
|
|
469
|
+
* (`wildo-local-dev`), whose only authorized redirect URI is
|
|
470
|
+
* `http://localhost:4241/api/v1/auth/oauth2/callback/google` — which is exactly why it is authored here and not in the
|
|
471
|
+
* SaaS config, where staging and production would have sent users to it too. An environment that registers its own
|
|
472
|
+
* client authors its own ID in its own infra config; one that authors none has no Google sign-in, and the OAuth2
|
|
473
|
+
* connection resolver says so (`Missing clientId`) rather than borrowing this one.
|
|
474
|
+
*
|
|
475
|
+
* The client ID is public (it travels in the authorization URL). Its SECRET is not: it lives in
|
|
476
|
+
* `infrastructure/local/secrets/secrets.json → providerEnv.GOOGLE_OAUTH2_CLIENT_SECRET`.
|
|
477
|
+
*/
|
|
478
|
+
providerConfigurations: {
|
|
479
|
+
google: {
|
|
480
|
+
[ExternalProvider_ExchangeProtocol_Kind.SSO_OAUTH2]: {
|
|
481
|
+
GOOGLE_OAUTH2_CLIENT_ID: '3143453718-fgjkei3reao9r5ke2k495ls2ad6lp3aq.apps.googleusercontent.com',
|
|
482
|
+
},
|
|
483
|
+
},
|
|
484
|
+
},
|
|
485
|
+
|
|
411
486
|
/**
|
|
412
487
|
* Local operator evidence posture. `wildo config sync --domain env-files`
|
|
413
488
|
* and `wildo dev start` project this block into the ephemeral app-root
|
|
@@ -418,6 +493,61 @@ export default defineInfraEnvConfig({
|
|
|
418
493
|
silent: false,
|
|
419
494
|
},
|
|
420
495
|
|
|
496
|
+
/**
|
|
497
|
+
* WHERE each declared system of record is, in THIS environment (#1055).
|
|
498
|
+
*
|
|
499
|
+
* `odoo` is declared ABSENT, and that is the true statement: this machine has no Odoo. Every read
|
|
500
|
+
* of `billableServices` answers **409 `SYSTEM_OF_RECORD_UNAVAILABLE_IN_ENVIRONMENT`** — a code a
|
|
501
|
+
* client can branch on — rather than a transport error against an address nobody is listening on.
|
|
502
|
+
*
|
|
503
|
+
* ## It carried the E2E double's address for one day, and why it does not any more
|
|
504
|
+
*
|
|
505
|
+
* `a4c48797d` (2026-09-21) pointed this at `127.0.0.1:18069`, the read-through lane's own double.
|
|
506
|
+
* That was the ONLY way the lane could run past its preflight: a lane driving an ALREADY-RUNNING
|
|
507
|
+
* application cannot set deployment configuration, so the address had to be committed. It worked —
|
|
508
|
+
* #590 ran end to end for the first time, and #1058's partition confinement was proven on a real
|
|
509
|
+
* stack (`e7f2ab6ff`).
|
|
510
|
+
*
|
|
511
|
+
* It is reverted because of what it cost everyone else. The dependency splits in two and only one
|
|
512
|
+
* half is on demand:
|
|
513
|
+
*
|
|
514
|
+
* - `billableServices` is READ-THROUGH, so it needs Odoo only while a read happens — and the lane
|
|
515
|
+
* spawns its own double and reaps it. Self-sufficient.
|
|
516
|
+
* - `externalCustomers` is a PIPELINE with `scheduleCron: '0 * * * *'`, so it dialled this address
|
|
517
|
+
* every hour whether or not anyone was testing. Measured at `11:00:00.779Z` on 2026-09-22:
|
|
518
|
+
* `pipeline 'externalCustomers' failed: HTTP-API network failure … fetch failed`, and it would
|
|
519
|
+
* have repeated identically forever, on every developer's machine.
|
|
520
|
+
*
|
|
521
|
+
* An hourly failure for a condition nobody intends to fix is a warning people learn to skip, and
|
|
522
|
+
* they take that habit to the warnings that matter. Decided in #1476; the engine-side
|
|
523
|
+
* miscalibration (warn hourly rather than back off) is #1475.
|
|
524
|
+
*
|
|
525
|
+
* ## What this does NOT change
|
|
526
|
+
*
|
|
527
|
+
* `partition: true` stays on the INSTANCE in `wildo.saas.config.ts`, and that is the D2 split
|
|
528
|
+
* working rather than a leftover: how a deployment's data is shaped is a property of the
|
|
529
|
+
* declaration (WHAT), and whether this machine can reach it is a property of the environment
|
|
530
|
+
* (WHERE). A machine with no Odoo still knows its Odoo is partitioned by company.
|
|
531
|
+
*
|
|
532
|
+
* An absent declaration is still refused at boot. "No access here" and "somebody forgot to author
|
|
533
|
+
* the address" need opposite behaviours and silence cannot be either — so a machine that genuinely
|
|
534
|
+
* has no Odoo writes `{ enabled: false }`, rather than deleting the key.
|
|
535
|
+
*
|
|
536
|
+
* ## To run the read-through lane, or to use a REAL Odoo
|
|
537
|
+
*
|
|
538
|
+
* For the LANE: put the double's address back — `baseUrl: 'http://127.0.0.1:18069'`,
|
|
539
|
+
* `database: 'wildo_e2e'`, `login: 'e2e@wildo.test'` (`ODOO_SIMULATOR_CREDENTIALS` from
|
|
540
|
+
* `@wildo-ai/engine-behavior-e2e`) — then `wildo config sync --local --domain env-files` and
|
|
541
|
+
* restart. Expect the hourly pipeline failure above for as long as it is there.
|
|
542
|
+
*
|
|
543
|
+
* For a REAL Odoo: the same three values pointed at that instance, with its key in `secrets.json`
|
|
544
|
+
* under `systemsOfRecordEnv.WILDO_SOR_ODOO__API_KEY`. The derived environment variable names
|
|
545
|
+
* (`WILDO_SOR_ODOO__BASE_URL` and siblings) are never authored — they come from the instance name.
|
|
546
|
+
*/
|
|
547
|
+
systemsOfRecord: {
|
|
548
|
+
odoo: { enabled: false },
|
|
549
|
+
},
|
|
550
|
+
|
|
421
551
|
devCompanion: {
|
|
422
552
|
// Loopback ONLY (meta-workflows P-29): the companion API hosts
|
|
423
553
|
// endpoints that spend money and execute code (coding-agent dispatch),
|
|
@@ -434,9 +564,17 @@ What earns its place:
|
|
|
434
564
|
|
|
435
565
|
- `defineInfraEnvConfig({ ... })` — the **typed factory entry**
|
|
436
566
|
imported from `@wildo-ai/platform-config-lib`. The factory does
|
|
437
|
-
the cross-field validation
|
|
438
|
-
|
|
439
|
-
|
|
567
|
+
the cross-field validation. `devCompanion` is optional locally;
|
|
568
|
+
when supplied it configures the companion binding. Remote requirements
|
|
569
|
+
are separate from that optional local configuration. Kubernetes also
|
|
570
|
+
accepts `kubernetes.services: { [serviceKey]: { replicas } }` for workload sizing.
|
|
571
|
+
For application backends and frontends, use the authored `services` key from
|
|
572
|
+
`wildo.saas.config.ts` (for example `backendApi`, `app`, `website`), not the
|
|
573
|
+
generated image name. Synchronization preserves these overrides into deployment
|
|
574
|
+
generation; an omitted count defaults to one. Overrides without an emitted
|
|
575
|
+
application Deployment produce a warning, including CDN-served and unserved
|
|
576
|
+
frontends. Workers keep their own declaration’s replica count; platform service
|
|
577
|
+
keys are handled by the platform renderer.
|
|
440
578
|
- `environment: WildoEnvironment.LOCAL` — typed enum, not the
|
|
441
579
|
string `'local'`. The value drives runtime detection at app
|
|
442
580
|
bootstrap (`isLocal()` / `isProduction()` helpers read this).
|
|
@@ -457,6 +595,12 @@ What earns its place:
|
|
|
457
595
|
schema defaults** (creates author-noise, masks future default
|
|
458
596
|
shifts). Author `serviceAuth` only when you genuinely deviate
|
|
459
597
|
(e.g. a stricter posture: `accessTokenExpirationMinutes: 5`).
|
|
598
|
+
For an existing registration, removing this block preserves the stored
|
|
599
|
+
policy; it does not reset it to defaults. An explicitly present partial
|
|
600
|
+
block defaults its omitted member, and `{}` explicitly requests both
|
|
601
|
+
schema defaults. Follow `config-saas-backend`'s
|
|
602
|
+
`references/managed-startup-configuration.md` for persistence and restart
|
|
603
|
+
verification; a file edit or restart alone does not publish the policy.
|
|
460
604
|
- `backingServices` — the **typed map** of backing services this env
|
|
461
605
|
depends on, keyed by `BackingServiceKind` (authoritative list:
|
|
462
606
|
`references/framework-backing-services-api.md`). Declare a kind only
|
|
@@ -464,14 +608,12 @@ What earns its place:
|
|
|
464
608
|
app's enabled engine capabilities depend on (see "Capability-driven
|
|
465
609
|
backing services" below). Each entry carries `source: BackingServiceSource.SELF`
|
|
466
610
|
(locally hosted by docker-compose) plus per-source connection
|
|
467
|
-
params (host, port, vhost, bucket, endpoint).
|
|
468
|
-
to `source: BackingServiceSource.MANAGED`
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
`
|
|
472
|
-
|
|
473
|
-
enum value was removed on 2026-05-07 — Atlas is a brand under the
|
|
474
|
-
managed source, not its own source axis.
|
|
611
|
+
params (host, port, vhost, bucket, endpoint). A remote config may
|
|
612
|
+
swap to `source: BackingServiceSource.MANAGED` only where the platform
|
|
613
|
+
serves it — today that is MongoDB Atlas alone (`provider: 'atlas'`);
|
|
614
|
+
see "What each kind can be declared as today". The pre-Slice-4.B.0
|
|
615
|
+
`BackingServiceSource.ATLAS` enum value was removed on 2026-05-07 —
|
|
616
|
+
Atlas is a brand under the managed source, not its own source axis.
|
|
475
617
|
- `logging: { level: 'debug', formattedConsoleErrors: true }` —
|
|
476
618
|
per-environment log posture. Wired end-to-end by Slice 3.5:
|
|
477
619
|
persisted into `PlatformEnvConfigJson.logging`, projected by
|
|
@@ -502,10 +644,85 @@ The sibling staging config
|
|
|
502
644
|
the same shape with `WildoEnvironment.STAGING` +
|
|
503
645
|
`WildoLocationType.REMOTE` + `remoteProvider` (registry endpoint,
|
|
504
646
|
region) + `deployment` (branch, runtime). Backing-service `source`
|
|
505
|
-
swaps to `MANAGED`
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
647
|
+
swaps to `MANAGED` only where the platform serves it (MongoDB Atlas,
|
|
648
|
+
`provider: 'atlas'`).
|
|
649
|
+
|
|
650
|
+
## What each kind can be declared as today
|
|
651
|
+
|
|
652
|
+
A declaration is accepted only when the platform can SERVE it: it must
|
|
653
|
+
resolve to an infrastructure provider, and that provider must have a
|
|
654
|
+
provider module able to deliver the application's connection. Anything
|
|
655
|
+
else is refused — by `wildo config validate`, `wildo config sync` and
|
|
656
|
+
`wildo lock check` alike — with a message naming the environment, the
|
|
657
|
+
kind, what you declared, and what that kind CAN be declared as.
|
|
658
|
+
|
|
659
|
+
| Kind | Accepted declarations |
|
|
660
|
+
|---|---|
|
|
661
|
+
| `mongodb` | `{ source: SELF }` · `{ source: MANAGED, provider: 'atlas' }` |
|
|
662
|
+
| `postgresql` | `{ source: SELF }` |
|
|
663
|
+
| `redis` | `{ source: SELF }` |
|
|
664
|
+
| `rabbitmq` | `{ source: SELF }` |
|
|
665
|
+
| `s3` | `{ source: SELF }` (MinIO; `provider: 'minio'` is accepted and redundant) |
|
|
666
|
+
| `clamav` | `{ source: SELF }` |
|
|
667
|
+
| `immudb` | `{ source: SELF }` |
|
|
668
|
+
|
|
669
|
+
What this refuses, and why it is not a formality:
|
|
670
|
+
|
|
671
|
+
- **A managed cache, broker, scanner or audit store** — `redis: { source:
|
|
672
|
+
MANAGED }` and the like — names no provider at all.
|
|
673
|
+
- **Managed PostgreSQL** (`'aws-rds'`, `'gcp-cloud-sql'`, `'azure-database'`,
|
|
674
|
+
`'supabase'`, `'neon'`, `'render'`, or unbranded) and **managed S3** (AWS)
|
|
675
|
+
name catalogue entries the platform cannot serve yet.
|
|
676
|
+
- Before this was refused, such a declaration passed in silence: the stack
|
|
677
|
+
was generated WITHOUT the self-hosted service, and the platform still
|
|
678
|
+
minted the application's credential on its OWN server — a credential for a
|
|
679
|
+
server the application never connects to.
|
|
680
|
+
|
|
681
|
+
There is no opt-out flag. A kind becomes declarable as `MANAGED` in the same
|
|
682
|
+
framework release that adds the provider module serving it. `backup` is not
|
|
683
|
+
a kind: it was withdrawn because nothing read it, and a `backup:` key now
|
|
684
|
+
fails to parse.
|
|
685
|
+
|
|
686
|
+
The authoritative resolution table, with the "Servable today" column, is in
|
|
687
|
+
`references/framework-backing-services-api.md`.
|
|
688
|
+
|
|
689
|
+
### Your declaration decides where credentials are minted
|
|
690
|
+
|
|
691
|
+
Every registration (`wildo local init`, every `wildo local dev` start) sends
|
|
692
|
+
apps-manager the `(source, provider)` pair of each kind the environment
|
|
693
|
+
declares. apps-manager mints the application's cache, broker and database
|
|
694
|
+
credentials on exactly that provider, through the same provider catalogue —
|
|
695
|
+
never on another one because it happens to hold a client for it. A kind the
|
|
696
|
+
environment does not declare keeps the platform's own choice: its self-hosted
|
|
697
|
+
server, or for MongoDB, Atlas whenever the platform holds an Atlas API key.
|
|
698
|
+
|
|
699
|
+
So moving `mongodb` from `{ source: SELF }` to
|
|
700
|
+
`{ source: MANAGED, provider: 'atlas' }` and registering again changes where
|
|
701
|
+
the database user is minted, with no apps-manager edit — provided the
|
|
702
|
+
platform already serves Atlas. A declaration change reaches apps-manager at
|
|
703
|
+
the next registration, not at `wildo config sync` or
|
|
704
|
+
`wildo config reapply-declaration`.
|
|
705
|
+
|
|
706
|
+
Which providers a platform can serve is PLATFORM configuration: an Atlas
|
|
707
|
+
declaration needs apps-manager to hold an Atlas API key, a self-hosted
|
|
708
|
+
PostgreSQL declaration needs a platform PostgreSQL. apps-manager refuses a
|
|
709
|
+
registration whose declared provider it cannot serve, before provisioning
|
|
710
|
+
anything, naming the kind, what you declared and what the platform serves
|
|
711
|
+
instead. Only the kinds the application actually stores in are checked
|
|
712
|
+
against the platform's credentials: a declared MongoDB that a PostgreSQL
|
|
713
|
+
application never uses does not need an Atlas key.
|
|
714
|
+
|
|
715
|
+
Minion confinement holds on MongoDB Atlas exactly as on a self-hosted MongoDB.
|
|
716
|
+
Each minion of an application whose database store is declared on Atlas gets its
|
|
717
|
+
OWN Atlas database user, never the application's: that user holds one custom
|
|
718
|
+
role granting only the collections the minion's `resourceAccess` declares plus
|
|
719
|
+
the execution-history records every minion needs, and it can reach only the
|
|
720
|
+
application's cluster. Removing the minion deletes its user and role and leaves
|
|
721
|
+
the application's user untouched. Each minion takes one database user and one
|
|
722
|
+
custom role from the Atlas project's limits (100 of each by default). When
|
|
723
|
+
apps-manager can read those limits, a minion that would exceed one is refused
|
|
724
|
+
before anything is created, naming the limit; otherwise Atlas's own refusal
|
|
725
|
+
of the create is what stops it.
|
|
509
726
|
|
|
510
727
|
## Capability-driven backing services
|
|
511
728
|
|
|
@@ -549,6 +766,47 @@ there is no secret for you to create. If a backend log says
|
|
|
549
766
|
answer is a `wildo config sync` (which provisions and re-renders), never a
|
|
550
767
|
hand-written key.
|
|
551
768
|
|
|
769
|
+
**Nor do you author the audit store's credentials.** A self-hosted store's
|
|
770
|
+
credentials are MINTED, never authored. Each application gets its OWN immudb
|
|
771
|
+
database and its OWN user, which can write that database and nothing else;
|
|
772
|
+
the platform creates both when the application registers and delivers them to
|
|
773
|
+
the application with its other platform secrets. The server's administrator
|
|
774
|
+
password is a platform secret that only the platform's own apps-manager
|
|
775
|
+
receives. No application receives it.
|
|
776
|
+
|
|
777
|
+
- `IMMUDB_USER`, `IMMUDB_PASSWORD` and `IMMUDB_DATABASE` in your provider
|
|
778
|
+
secrets decide nothing on a self-hosted store. The minted values win.
|
|
779
|
+
Where they differ, the backend logs a warning naming each variable (never
|
|
780
|
+
its value). Remove them with `wildo secrets unset <NAME>`. They matter
|
|
781
|
+
only for a MANAGED immudb.
|
|
782
|
+
- Withdrawing the application (`wildo local deregister`) deactivates its
|
|
783
|
+
audit user and revokes its permission. The database and its events are
|
|
784
|
+
kept, because an audit history must outlive the credential that wrote it.
|
|
785
|
+
`wildo local restore` re-activates the same user.
|
|
786
|
+
- The first boot on the new per-application database records a DELIBERATE
|
|
787
|
+
trust-anchor reset in the backend log, instead of a tamper alarm. The
|
|
788
|
+
verified history now starts there, and the previous database's anchor
|
|
789
|
+
file is kept.
|
|
790
|
+
- An immudb data directory initialised before this change keeps its old
|
|
791
|
+
administrator password. When that password is immudb's packaged default
|
|
792
|
+
(the usual case: nothing set it), apps-manager changes it to
|
|
793
|
+
`immudb.adminPassword` at its first administrator login, logs a warning
|
|
794
|
+
and records `immudb_admin_credential_adopted` on the registration's
|
|
795
|
+
audit event. Nothing is asked of you, with one consequence: another
|
|
796
|
+
application on the same platform that was registered before this change
|
|
797
|
+
still logs in as that administrator, so from then on its audit writes
|
|
798
|
+
are refused (its backend logs a warning). Re-register it
|
|
799
|
+
(`wildo local init`) and it gets its own database and user.
|
|
800
|
+
- When the old password is a real secret (an `IMMUDB_PASSWORD` you authored
|
|
801
|
+
before this change), the platform cannot log in and registration fails;
|
|
802
|
+
apps-manager's log names the cause. Set the server's administrator
|
|
803
|
+
password, once, to the value of `immudb.adminPassword` in the
|
|
804
|
+
environment's `secrets.json`
|
|
805
|
+
(`docker exec -it wildo-immudb immuadmin user changepassword immudb`
|
|
806
|
+
locally), or start from a fresh data directory. This alters a credential
|
|
807
|
+
the platform does not hold, so it is the operator's step. The same holds
|
|
808
|
+
after rotating `immudb.adminPassword`.
|
|
809
|
+
|
|
552
810
|
## Choosing the application's store — and what it obliges
|
|
553
811
|
|
|
554
812
|
`applicationDatabase` selects where THIS application's resources persist, and it
|
|
@@ -561,8 +819,44 @@ from then on every schema change owes an artifact. Follow
|
|
|
561
819
|
`application-database-migrations` — and read
|
|
562
820
|
`references/framework-application-database-api.md` for the contract itself.
|
|
563
821
|
|
|
822
|
+
## Running on another application's infrastructure
|
|
823
|
+
|
|
824
|
+
Several applications can share one environment's platform. One application OWNS the
|
|
825
|
+
infrastructure — its Docker Compose project or cluster, every backing service, and the platform
|
|
826
|
+
services — and the others declare it as their host, per environment:
|
|
827
|
+
|
|
828
|
+
- The owner keeps a normal `defineInfraEnvConfig({...})` descriptor and must declare EVERY backing
|
|
829
|
+
service any application on its platform uses.
|
|
830
|
+
- A hosted application authors `defineHostedInfraEnvConfig({ infrastructureHost: { applicationRoot:
|
|
831
|
+
'../<host-app>' }, ... })` in `./infrastructure/<env>/`. `applicationRoot` is relative to this
|
|
832
|
+
application's root and must hold the host's `wildo.saas.config.ts`: a hosted application cannot run
|
|
833
|
+
without the host's source checked out there.
|
|
834
|
+
- A hosted descriptor authors only what is its own: `publicDomain`, `serviceHosts`,
|
|
835
|
+
`applicationDatabase`, `logging`, `observability`, `providerSelection`, `providerConfigurations`,
|
|
836
|
+
`documentationSite`, `serviceAuth`, `csp`, `cdn`, `devCompanion`, `kubernetes.services` (replica
|
|
837
|
+
counts), `deployment.branch` / `imageTagStrategy`, and under `backingServices` only its
|
|
838
|
+
own NAME on each server (`postgresql.database`, `mongodb.database`, `rabbitmq.vhost`, `s3.bucket`,
|
|
839
|
+
`redis.database`).
|
|
840
|
+
- `runtime`, `locationType`, `runtimeEnvironment`, `database`, `remoteProvider`, `platformStorage`,
|
|
841
|
+
the Kubernetes namespace and ingress class, and every backing-service `source` / `host` / `port` /
|
|
842
|
+
`provider` / `endpoint` come from the host and are refused in a hosted descriptor — two applications
|
|
843
|
+
on one platform cannot disagree about it, and Docker Compose and Kubernetes cannot diverge.
|
|
844
|
+
- Listing a store says the application needs it; the host must declare it, or loading refuses naming
|
|
845
|
+
the host's file. A database, vhost or bucket name equal to the host's is refused: on a shared server
|
|
846
|
+
one name is one application's data.
|
|
847
|
+
|
|
848
|
+
Consequences for commands (`local-environment-bootstrap` has the full workflow): start the platform
|
|
849
|
+
from the host; a hosted application's `wildo local init` only registers it, its `wildo local dev`
|
|
850
|
+
attaches and never starts or recreates shared containers, and `wildo local up` / `down` / `reset` /
|
|
851
|
+
`reinit` refuse and name the host command. Shared credentials are read from the host's
|
|
852
|
+
`secrets.json`; the hosted application's own `secrets.json` keeps only its sections (`admin`,
|
|
853
|
+
`approver`, `application`, `providerEnv`).
|
|
854
|
+
|
|
855
|
+
Read `references/framework-infrastructure-host-api.md` for the source-backed contract.
|
|
856
|
+
|
|
564
857
|
## References
|
|
565
858
|
|
|
859
|
+
- `references/framework-infrastructure-host-api.md` — source-backed `infrastructureHost` / hosted descriptor contract
|
|
566
860
|
- `references/framework-application-database-api.md` — source-backed `applicationDatabase` contract
|
|
567
861
|
|
|
568
862
|
- `references/infra-config-files.md` — repo paths for infra / secrets
|
|
@@ -573,11 +867,13 @@ from then on every schema change owes an artifact. Follow
|
|
|
573
867
|
## Verification
|
|
574
868
|
|
|
575
869
|
- [ ] Infra file is a single `defineInfraEnvConfig({...})` default export
|
|
576
|
-
- [ ]
|
|
870
|
+
- [ ] Environment uses a common named ID or a valid custom slug; runtime and backing-service source use their typed enums
|
|
577
871
|
- [ ] Every backing service the app uses is declared with a valid `source`
|
|
872
|
+
- [ ] Every declaration is one the platform can serve (see "What each kind can be declared as today") — `wildo config validate --domain config` reports no `names no infrastructure provider` / `which no provider module can serve yet` finding
|
|
578
873
|
- [ ] Every capability-required backing service is declared in **every** environment (see "Capability-driven backing services") — `wildo config sync` emits no missing-backing-store warning
|
|
579
874
|
- [ ] No secret values in the file (passwords, keys, tokens — all referenced via the secrets store)
|
|
580
|
-
- [ ]
|
|
875
|
+
- [ ] Every vendor identifier issued per deployment (OAuth client ID, frontend SDK DSN or site key) is authored in THIS file's `providerConfigurations`, and none is authored in `wildo.saas.config.ts`
|
|
876
|
+
- [ ] Local `devCompanion` is optional; remote environments declare `runtimeEnvironment`; remote Kubernetes also requires `remoteProvider`; optional `deployment` matches the chosen workflow
|
|
581
877
|
- [ ] `wildo local status` (or remote equivalent) shows services healthy with the new wiring
|
|
582
878
|
- [ ] App bootstrap log shows successful connection to each backing service
|
|
583
879
|
- [ ] Documentation updated for teammates if ports / hostnames / sources changed
|
|
@@ -589,18 +885,18 @@ Run from the app root, substituting `<env>`:
|
|
|
589
885
|
| Invariant | Command |
|
|
590
886
|
|--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
591
887
|
| Infra file uses typed `defineInfraEnvConfig` | `rg -n "defineInfraEnvConfig\(" infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
592
|
-
|
|
|
888
|
+
| Environment identifier matches its directory and passes `WildoEnvironmentIdSchema` | Inspect `environment` in the authored file; custom remote slugs are supported. |
|
|
593
889
|
| Typed `WildoDeploymentRuntime` enum used | `rg -n "runtime:\s*WildoDeploymentRuntime\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
594
890
|
| Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
891
|
+
| Every `MANAGED` declaration is MongoDB Atlas (anything else is refused) | `rg -n "BackingServiceSource\.MANAGED" infrastructure/*/wildo.infra.*.config.ts` — every hit must be `mongodb` with `provider: 'atlas'` |
|
|
595
892
|
| Audit capability has an audit store in EVERY env (both sides must match) | `rg -n "COMPLIANCE_AUDIT_TRAIL" wildo.saas.config.ts` then `rg -ln "immudb:" infrastructure/*/wildo.infra.*.config.ts` |
|
|
596
893
|
| **No secrets** in infra file (must be empty) | `rg -n "(password\|apiKey\|secret\|token):\s*['\"]" infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
597
|
-
|
|
|
598
|
-
|
|
|
599
|
-
| Remote
|
|
894
|
+
| Custom environment uses the remote filename | Inspect `infrastructure/<env>/wildo.infra.remote.config.ts` for every non-local ID. |
|
|
895
|
+
| Optional local companion binding is deliberate | Inspect `devCompanion` when present; omission is schema-valid. |
|
|
896
|
+
| Remote runtime mode is explicit | Inspect `runtimeEnvironment`; remote Kubernetes additionally requires `remoteProvider`. `deployment` is optional. |
|
|
600
897
|
|
|
601
|
-
|
|
602
|
-
|
|
603
|
-
either compromises secret hygiene or silently mistypes an env id.
|
|
898
|
+
Validate the environment slug and its filename separately from the closed
|
|
899
|
+
runtime/source enums. Keep secret values outside authored infrastructure.
|
|
604
900
|
|
|
605
901
|
## Common Rationalizations
|
|
606
902
|
|
|
@@ -608,8 +904,9 @@ either compromises secret hygiene or silently mistypes an env id.
|
|
|
608
904
|
|-----------------|---------|
|
|
609
905
|
| "Add a top-level `domain` field for the app hostname" | `domain` was deleted as a wrong seam, and the then-misnamed `kubernetes.baseDomain` was renamed to top-level `publicDomain`. The canonical hostname seam is now `publicDomain` (top-level, runtime-agnostic, REQUIRED). The strict schema rejects re-introduction of EITHER `domain` OR `kubernetes.baseDomain`, and both rejections are pinned by the framework's own schema tests. |
|
|
610
906
|
| "Drop the password into the config for now, I'll move it later" | Secrets in git are an outage waiting to happen. Use the secrets store from the first commit; "later" never arrives. |
|
|
611
|
-
| "
|
|
907
|
+
| "Every environment ID must be a `WildoEnvironment` member" | The enum supplies common names; custom validated slugs are supported. Only `local` selects local behavior, so ensure a custom name is intentional. |
|
|
612
908
|
| "Skip declaring `clamav` — we don't use virus scanning yet" | If the app's bootstrap initializes the service, the infra config must declare it. Missing entries fail bootstrap with cryptic `undefined` errors. |
|
|
909
|
+
| "Declare the managed Postgres / Redis we plan to use now, and wire it up later" | A declaration the platform cannot serve is refused outright, and before that refusal existed it silently produced a credential for the wrong server. Declare `SELF` until the framework release that serves the managed option; there is no flag that accepts it early. |
|
|
613
910
|
| "Copy production URL into the example config to keep them in sync" | Production URLs in non-production configs are catastrophic when accidentally promoted. Keep production values exclusively in production config + secrets. |
|
|
614
911
|
|
|
615
912
|
## Red Flags
|
|
@@ -618,10 +915,13 @@ either compromises secret hygiene or silently mistypes an env id.
|
|
|
618
915
|
config (catastrophic accidental promotion)
|
|
619
916
|
- Secret value (password, key, token) in any infra config file
|
|
620
917
|
(catch with the **No secrets** grep — must be empty)
|
|
621
|
-
-
|
|
622
|
-
|
|
918
|
+
- Invalid environment slug, environment/directory mismatch, or a custom remote
|
|
919
|
+
environment stored under the local filename
|
|
623
920
|
- Backing service used by the app but not declared in the infra
|
|
624
921
|
config (bootstrap fails with `undefined` connection params)
|
|
922
|
+
- `source: BackingServiceSource.MANAGED` on anything but `mongodb`
|
|
923
|
+
with `provider: 'atlas'` (catch with the **Every `MANAGED`
|
|
924
|
+
declaration is MongoDB Atlas** grep above)
|
|
625
925
|
- `devCompanion` declared in a remote config (the field is local-only;
|
|
626
926
|
the typed factory may accept it but the companion won't bind correctly)
|
|
627
927
|
- `remoteProvider` or `deployment` declared in a local config (same
|
|
@@ -637,8 +937,14 @@ either compromises secret hygiene or silently mistypes an env id.
|
|
|
637
937
|
that turn the authored `defineInfraEnvConfig({...})` truth into a
|
|
638
938
|
running local docker-compose stack. **Always pair an edit on this
|
|
639
939
|
side with `wildo setup` (re-seeds env state) or
|
|
640
|
-
`wildo config sync --domain manifest` (re-renders
|
|
641
|
-
that side — authored edits do not propagate automatically.**
|
|
940
|
+
`wildo config sync --domain manifest` (re-renders the selected runtime’s
|
|
941
|
+
infrastructure manifests) on that side — authored edits do not propagate automatically.**
|
|
942
|
+
For remote application deployment artifacts, use `wildo config sync --env production --domain config`.
|
|
943
|
+
Then run `wildo config validate --env production --domain manifest --deployment-artifacts`: it checks
|
|
944
|
+
freshly rendered infrastructure/platform manifests and reads every YAML/YML file under
|
|
945
|
+
`.wildo-saas/deploy/production/k8s`, including workload, ingress and Secret documents.
|
|
946
|
+
Missing or empty deployment output fails. Validation checks YAML and required resource
|
|
947
|
+
identities without logging payloads; it does not apply resources or test Kubernetes admission.
|
|
642
948
|
- `frontend-cdn-publish` — the OPT-IN `cdn?[serviceKey]` block + `wildo frontend publish` (serve a frontend from object storage + a CDN instead of an nginx pod). Authored in this same infra file; that skill owns the CDN-specific workflow (vendor, Cloudflare, operator steps).
|
|
643
949
|
- `config-saas` — `wildo.saas.config.ts` (modules / engine capabilities / provider scopes — separate from infra)
|
|
644
950
|
- `config-app-shell` — UI shell composition (separate from infra)
|