@wildo-ai/framework-knowledge 1.1.11 → 1.1.12
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 +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +170 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.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/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- 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 +4 -12
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- 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 +76 -14
- 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 +0 -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 +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- 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 +35 -14
- 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 +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -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.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- 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 +3 -3
- 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.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- 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 +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- 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 +36 -13
- 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 +8 -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 +7 -1
- 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 +4 -1
- 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 +34 -6
- 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 +5 -2
- 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 +4 -3
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- 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 +39 -29
- 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.map +1 -1
- 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 +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -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.map +1 -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 +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- 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 -7
- 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 +12 -14
- 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 +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- 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 +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- 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 +4 -2
- 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 +34 -1
- 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 +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.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 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- 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/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +27 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -14,16 +14,15 @@ when the migration exists and is committed.
|
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
rg -n "applicationDatabase" infrastructure/*/wildo.infra.*.config.ts
|
|
17
|
-
rg -n "persistenceAdapter: PersistenceAdapter.POSTGRESQL" shared-lib backend-api
|
|
18
17
|
```
|
|
19
18
|
|
|
20
|
-
You are out of it only when
|
|
21
|
-
`applicationDatabase: { engine: DatabaseEngine.MONGODB }
|
|
22
|
-
declares `persistenceAdapter: PersistenceAdapter.POSTGRESQL`. Stop here in that
|
|
19
|
+
You are out of it only when every environment declares
|
|
20
|
+
`applicationDatabase: { engine: DatabaseEngine.MONGODB }`. Stop here in that
|
|
23
21
|
case. Otherwise every line below is live: an environment that names no
|
|
24
|
-
`applicationDatabase` persists to PostgreSQL, one environment on PostgreSQL
|
|
25
|
-
enough
|
|
26
|
-
|
|
22
|
+
`applicationDatabase` persists to PostgreSQL, and one environment on PostgreSQL
|
|
23
|
+
is enough. An application uses exactly one transactional store, so no resource
|
|
24
|
+
can be kept on PostgreSQL inside a MongoDB application. `wildo db generate` plans
|
|
25
|
+
exactly the tables your environments need.
|
|
27
26
|
|
|
28
27
|
## What you owe, and when
|
|
29
28
|
|
|
@@ -25,7 +25,7 @@ empty or fails.
|
|
|
25
25
|
| `wildo context workspace map\|get\|related` | the application's own code, by resource — its fields, operations and relationships — instead of the whole registry |
|
|
26
26
|
| `wildo context journey` | where the application's creation stands: what is eligible, what is unmet, and what each run took and spent — per round and per child for a composite, with the rounds that began from a state an earlier round had already begun from |
|
|
27
27
|
| `wildo context coherence` | what disagrees across the landed specification families |
|
|
28
|
-
| `wildo context launch-blockers` | what still stands between the application and a real user — each open compliance decision (an undeclared part of `operatorComplianceIdentity`, an unanswered governance question, an undeclared retention class, undeclared subject-data recipients, sign-up acceptance) and a brand name its trademark screening has not cleared, where it is decided and what settles it. It marks and never blocks; a settled item is gone on the next read |
|
|
28
|
+
| `wildo context launch-blockers` | what still stands between the application and a real user — each open compliance decision (an undeclared part of `operatorComplianceIdentity`, an unanswered governance question, an undeclared retention class, undeclared subject-data recipients, sign-up acceptance, a HARD obligation of the compliance programme that is not met, a data residency answered and not yet declared, a data-serving provider not placed inside the residency) and a brand name its trademark screening has not cleared, where it is decided and what settles it. It marks and never blocks; a settled item is gone on the next read |
|
|
29
29
|
| `wildo context health` | whether the companion is answering at all |
|
|
30
30
|
|
|
31
31
|
## Commands that ask the running application backend
|
|
@@ -41,6 +41,7 @@ describes adding or changing its capabilities.
|
|
|
41
41
|
| **`resource-status-lifecycle`** — give a resource states the engine enforces: one operation per transition (`enabledCondition` + `basicPrefixOperation` + `authoritativeFields`), the status excluded from UPDATE, the record frozen once final, and a conversion's write in one transaction; for a quote, order or invoice, the parts that make it a trustworthy commercial document | "accept a quote", "issue the invoice", "mark it paid", "lock it after it is sent", "only allow X when Y", "convert the quote into a job" |
|
|
42
42
|
| **`resource-config-wiring`** — edit `*.resources-config.ts` for operations, variants, relationships, roles | "wire a new operation variant", "add a custom operation to a resource", "configure resource relationships in registry", "change operation roles" |
|
|
43
43
|
| **`resource-retention-binding`** — bind a resource to a retention class and start point so expired rows are deleted on schedule | "delete closed tickets after 90 days", "how long do we keep X", "keep invoices ten years", "purge old logs", "retention period for this resource" |
|
|
44
|
+
| **`subject-data-export`** — answer an access or portability request with the subject export, and deliver portability as one archive with the files the person uploaded | "export everything we hold about this user", "answer a data access request", "download my data", "include the user's uploaded files in their export", "zip the export" |
|
|
44
45
|
| **`resource-ui-behavior`** — edit `*.ui-behavior.tsx` for layouts, display/edit modes, enum UI | "change how the priority field renders", "tweak the tasks list UI behavior", "add display-mode badge-with-colors", "conditional visibility on a field" |
|
|
45
46
|
| **`resource-custom-view`** — implement `*CustomView.tsx` components bound to operation context | "implement TaskExecutionView", "write a custom view component", "hook custom React into a resource operation", "author a resource-owned view host" |
|
|
46
47
|
| **`resource-rag-source-fields`** — declare which fields feed the retrieval corpus (`.ragSource()`), their chunking, and embeddings | "make this searchable by AI", "add RAG over our documents", "let the assistant answer from the knowledge base", "make uploaded PDFs searchable", "set up embeddings" |
|
|
@@ -256,6 +257,7 @@ Anything that changes **backend-api code** beyond schema-driven CRUD.
|
|
|
256
257
|
| **`application-roles-authoring`** — declare the application's own user roles (`shared-lib/src/engine/roles.ts`), offer each on its organization types (`availableOrgRoles`) and name it in the `roles` of every operation it unlocks; roles are configuration, never a resource of role names or permissions | "office and field users see different things", "add a technician role", "only admins can issue invoices", "permissions per role", "different user roles see different screens", "who can do what" |
|
|
257
258
|
| **`authorization-unit-narrowing`** — declare a resource confined to the organization UNIT (department / region / team) a member holds a role in, via the `organizationUnitNarrowing` startup opt-in, or to the rows a member OWNS via `organizationOwnRows`; confines reads and writes without touching the organization scope | "scope this resource to a department", "each team should only see their own records", "each employee should only see their own requests", "regional managers should only manage their region's data", "restrict projects to the user's business unit", "add unit-level permissions", "why can a unit manager see every record" |
|
|
258
259
|
| **`professional-qualifications`** — decide who may take a decision (a role, a relationship role, one named person, or a person holding a verified professional qualification) and declare it: `professionalQualificationKinds`, the organization's qualifications register, and `requiredQualificationKinds` on an approval gate, an operation's `requiresApproval` or a flow's person step | "only a chartered accountant may approve", "the approver must be licensed", "a qualified person must sign off", "track our staff's certifications", "who is allowed to approve this" |
|
|
260
|
+
| **`electronic-signature-deliverables`** — have an approved file deliverable signed by its approver through a trust-service vendor: `FunctionTool.electronicSignature`, the `ELECTRONIC_SIGNATURE` capability, and what makes a request SIGNED (the validated signed PDF, never the vendor's word) | "the client must e-sign the engagement letter", "send the approved report for electronic signature", "we need an advanced electronic signature", "the signature request stays open", "why is the signed document rejected" |
|
|
259
261
|
| **`organization-relationships`** — let one organization's people work inside other organizations (an agency, a practice, a partner) under a relationship the granting organization proposes or accepts, can confine to some of its teams, and can end on the next request; relationship kinds under the top-level `organizationRelationships`, and each relationship's records separated from the others' in one tenant | "let an agency work in our customers' workspaces", "our consultants need access to client accounts", "managed service provider access", "limit the agency to one department", "two firms serve one client and must not see each other's work", "how does a client revoke an outside firm" |
|
|
260
262
|
|
|
261
263
|
### Data seeding — declarative row materialization + operations
|
|
@@ -360,7 +362,7 @@ contracts and the `InboundContact` resource.
|
|
|
360
362
|
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
361
363
|
| **`website-page-authoring`** — author an application homepage, product page, solution page or other website page: page kind (route, menu placement, essential sections), product message, visual direction, composed sections, manifest and route | "create the homepage", "make the landing page more modern", "add a product page", "add a solution page for <audience>", "add a new website page", "compose a landing page", "create a new marketing route" |
|
|
362
364
|
| **`website-page-variants`** — add a page for a distinct audience or campaign (a SOLUTION page at `/solutions/<slug>`, or its own page); the engine has no variant field and serves one page per route | "add an audience variant", "create a /for-X version of the landing page", "spin up a campaign variant", "split-test a landing page" |
|
|
363
|
-
| **`website-label-pack`** — author the per-locale JSON label packs (`website/src/i18n/<locale>.json`) a section's `expectedLabelKeys` commit to, read through `useWebsiteLabel` / `useWebsiteLabelByKey` | "add a translation key", "author a label pack", "override a page label per locale", "give an audience page its own words" |
|
|
365
|
+
| **`website-label-pack`** — author the per-locale JSON label packs (`website/src/i18n/<locale>.json`, a section's words in its own `<locale>/<page>.<sectionRef>.json`) a section's `expectedLabelKeys` commit to, read through `useWebsiteLabel` / `useWebsiteLabelByKey` | "add a translation key", "author a label pack", "override a page label per locale", "give an audience page its own words" |
|
|
364
366
|
| **`website-seo-aeo-geo`** — configure first-class SEO / AEO / GEO surfaces (meta, canonical, hreflang, JSON-LD, llms.txt, robots.txt, sitemap, AI crawler policy) | "configure SEO", "add JSON-LD for X", "wire llms.txt", "configure AI crawler policy", "add hreflang", "audit our SEO/AEO/GEO posture" |
|
|
365
367
|
| **`website-blog-authoring`** — author blog posts as fully localized MDX files per locale; auto-emit `BlogPosting` JSON-LD | "add a blog post", "author a per-locale article", "publish an MDX article", "configure blog frontmatter" |
|
|
366
368
|
| **`website-navigation-authoring`** — author the site menu declared in `website/src/site-menu.ts` (links, Product/Solutions panels with described items, featured card, overview, header actions into the application by entry point) rendered by the engine's `WebsiteSiteHeader` (desktop panels, mobile drawer, sticky / auto-hide) and `WebsiteSiteFooterMenu`; build-checked routes and derived label keys | "add a menu item", "add a Products / Solutions mega menu", "wire site navigation", "add a sign-in button to the header", "make the header sticky", "configure footer columns", "swap the header on a campaign page" |
|
|
@@ -26,6 +26,9 @@ How it fits together:
|
|
|
26
26
|
the proposing agent there too: an operation an agent's tool call dispatched sees it as
|
|
27
27
|
`executionContext.agentActor.agentRef` (evidence only, never authority). Mark the question `review` only when it is
|
|
28
28
|
set; a question a person proposed is not a review of any agent.
|
|
29
|
+
A CHOICE field whose options are record ids (which document, which person) gives each id its words in
|
|
30
|
+
`optionLabels` — `{ [id]: title }`, only for ids in `options` — so the reviewer picks between documents, not ids;
|
|
31
|
+
the answer still carries the id, and the decision's seal records the words the reviewer read.
|
|
29
32
|
A run that must be the only open question on its subject (one bank line, one invoice) carries `exclusiveSubject`,
|
|
30
33
|
but a WAITING run holds no lease: check for an open run on the subject yourself before opening another.
|
|
31
34
|
2. The run waits on your application's own actor-plane rows; the question appears in the decision inbox of the people
|
|
@@ -97,6 +100,27 @@ export interface ActorExecutionContinuation<T = unknown> {
|
|
|
97
100
|
* CALENDAR clock in an application with no `reviewCalendar`, and a host whose actor store cannot keep the clocks.
|
|
98
101
|
*/
|
|
99
102
|
readonly deadlines?: ReviewDeadlinesDeclaration;
|
|
103
|
+
/**
|
|
104
|
+
* Whether an answer to this system's questions must carry a fresh step-up proof bound to the question (#2923), as an
|
|
105
|
+
* operation approval's `requiresApproval.requiresStepUpAuthentication` does. The person re-proves a factor
|
|
106
|
+
* (`POST /auth/reauth` with a `decisionBinding` naming the question and the presentation they answer) and answers from
|
|
107
|
+
* the decision inbox with it in `X-Reauth-Token`; a chat answer carries none and is refused. Armed on each ROUTED
|
|
108
|
+
* question when it is raised (the ones the inbox answers, as `deadlines` are) and stored with it, so a change to this
|
|
109
|
+
* declaration never changes what a waiting question requires. The engine also refuses to settle such a question for any
|
|
110
|
+
* door whose decider shows no step-up meeting it.
|
|
111
|
+
*/
|
|
112
|
+
readonly requiresStepUpAuthentication?: boolean;
|
|
113
|
+
/**
|
|
114
|
+
* What that step-up must ALSO be (#2923), with `requiresStepUpAuthentication: true`; startup refuses it without:
|
|
115
|
+
* `maximumAgeSeconds` (at most 300) since the factor was proven, and a `minimumAssurance` of `reproven`, `possession`
|
|
116
|
+
* or `phishing_resistant`. The factor and the instant it was proven are recorded on the decision and its approval seal.
|
|
117
|
+
*/
|
|
118
|
+
readonly stepUp?: HumanDecision_StepUpRequirement;
|
|
119
|
+
/**
|
|
120
|
+
* The channels that may answer this system's routed questions (#2923): `web_session`, `chat`, `api_client`. Armed and
|
|
121
|
+
* stored with each question like its step-up. `chat` is refused beside a step-up.
|
|
122
|
+
*/
|
|
123
|
+
readonly answerChannels?: HumanDecision_AnswerChannels;
|
|
100
124
|
/** Continue the run with the person's answer. Runs as the run's executor, under the run's work attribution. */
|
|
101
125
|
continue(input: ActorExecutionContinuationInput): Promise<T>;
|
|
102
126
|
/** How the continuation's result is read: whether it asks again, and how it concluded. */
|
package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md
CHANGED
|
@@ -75,7 +75,7 @@ export const AGENT_WORK_REASON_CODE_VOCABULARY = ApplicationConfigVocabulary.AGE
|
|
|
75
75
|
* A tool approval is always a proposal and needs no marker.
|
|
76
76
|
*/
|
|
77
77
|
review: z.strictObject({
|
|
78
|
-
surface: z.enum(AgentWorkDecisionSurface),
|
|
78
|
+
surface: z.enum(AgentWorkDecisionSurface).systemEnum('AgentWorkDecisionSurface'),
|
|
79
79
|
}).optional(),
|
|
80
80
|
```
|
|
81
81
|
|
package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md
CHANGED
|
@@ -167,7 +167,7 @@ const CountryCodeSchema = z.string().length(2).refine((code) => COUNTRY_CODES.ha
|
|
|
167
167
|
/** The `ref` of the request field this form field asks. Opaque, as the request's refs are. */
|
|
168
168
|
const FieldRefSchema = z.string().min(1);
|
|
169
169
|
|
|
170
|
-
|
|
170
|
+
const TEXT_FIELD_SHAPE = {
|
|
171
171
|
ref: FieldRefSchema,
|
|
172
172
|
type: z.literal(HumanInputForm_FieldType.TEXT).systemEnum('HumanInputForm_FieldType'),
|
|
173
173
|
format: z.enum(HumanInputForm_TextFormat).systemEnum('HumanInputForm_TextFormat').optional(),
|
|
@@ -176,11 +176,13 @@ export const HumanInputForm_TextFieldSchema = z.strictObject({
|
|
|
176
176
|
textareaRows: z.int().min(2).max(20).optional(),
|
|
177
177
|
minLength: z.int().min(1).optional(),
|
|
178
178
|
maxLength: z.int().min(1).optional(),
|
|
179
|
-
}
|
|
179
|
+
};
|
|
180
|
+
export const HumanInputForm_TextFieldSchema = z.strictObject(TEXT_FIELD_SHAPE)
|
|
181
|
+
.refine((field) => field.minLength === undefined || field.maxLength === undefined || field.minLength <= field.maxLength, {
|
|
180
182
|
message: 'minLength is above maxLength.',
|
|
181
183
|
});
|
|
182
184
|
|
|
183
|
-
|
|
185
|
+
const NUMBER_FIELD_SHAPE = {
|
|
184
186
|
ref: FieldRefSchema,
|
|
185
187
|
type: z.literal(HumanInputForm_FieldType.NUMBER).systemEnum('HumanInputForm_FieldType'),
|
|
186
188
|
integer: z.boolean().optional(),
|
|
@@ -192,7 +194,9 @@ export const HumanInputForm_NumberFieldSchema = z.strictObject({
|
|
|
192
194
|
prefix: z.string().min(1).max(8).optional(),
|
|
193
195
|
/** Shown after the value, such as "kg" or "%". */
|
|
194
196
|
suffix: z.string().min(1).max(12).optional(),
|
|
195
|
-
}
|
|
197
|
+
};
|
|
198
|
+
export const HumanInputForm_NumberFieldSchema = z.strictObject(NUMBER_FIELD_SHAPE)
|
|
199
|
+
.refine((field) => field.min === undefined || field.max === undefined || field.min <= field.max, {
|
|
196
200
|
message: 'min is above max.',
|
|
197
201
|
}).refine((field) => field.editMode !== NumberEditMode.SLIDER || (field.min !== undefined && field.max !== undefined), {
|
|
198
202
|
message: 'A SLIDER needs min and max.',
|
|
@@ -208,13 +212,15 @@ export const HumanInputForm_DateTimeFieldSchema = z.strictObject({
|
|
|
208
212
|
type: z.literal(HumanInputForm_FieldType.DATETIME).systemEnum('HumanInputForm_FieldType'),
|
|
209
213
|
});
|
|
210
214
|
|
|
211
|
-
|
|
215
|
+
const MONEY_FIELD_SHAPE = {
|
|
212
216
|
ref: FieldRefSchema,
|
|
213
217
|
type: z.literal(HumanInputForm_FieldType.MONEY).systemEnum('HumanInputForm_FieldType'),
|
|
214
218
|
currenciesAllowed: z.array(z.enum(CurrencyAllowed)).min(1).optional(),
|
|
215
219
|
allowCurrencyChange: z.boolean().optional(),
|
|
216
220
|
defaultCurrency: AvailableCurrencySchema.optional(),
|
|
217
|
-
}
|
|
221
|
+
};
|
|
222
|
+
export const HumanInputForm_MoneyFieldSchema = z.strictObject(MONEY_FIELD_SHAPE)
|
|
223
|
+
.refine((field) => !field.defaultCurrency || currencyIsInAllowedCategories(field.defaultCurrency, field.currenciesAllowed), {
|
|
218
224
|
message: 'defaultCurrency is not in currenciesAllowed.',
|
|
219
225
|
});
|
|
220
226
|
|
|
@@ -233,14 +239,16 @@ export const HumanInputForm_RangeFieldSchema = z.strictObject({
|
|
|
233
239
|
message: 'A range whose start and end are both optional can be answered with nothing.',
|
|
234
240
|
});
|
|
235
241
|
|
|
236
|
-
|
|
242
|
+
const DURATION_FIELD_SHAPE = {
|
|
237
243
|
ref: FieldRefSchema,
|
|
238
244
|
type: z.literal(HumanInputForm_FieldType.DURATION).systemEnum('HumanInputForm_FieldType'),
|
|
239
245
|
allowedUnits: z.array(z.enum(DurationUnit)).min(1).optional(),
|
|
240
246
|
defaultUnit: z.enum(DurationUnit).optional(),
|
|
241
247
|
minValue: z.number().optional(),
|
|
242
248
|
maxValue: z.number().optional(),
|
|
243
|
-
}
|
|
249
|
+
};
|
|
250
|
+
export const HumanInputForm_DurationFieldSchema = z.strictObject(DURATION_FIELD_SHAPE)
|
|
251
|
+
.refine((field) => !field.defaultUnit || !field.allowedUnits || field.allowedUnits.includes(field.defaultUnit), {
|
|
244
252
|
message: 'defaultUnit is not one of allowedUnits.',
|
|
245
253
|
});
|
|
246
254
|
|
|
@@ -250,24 +258,28 @@ export const HumanInputForm_PhoneFieldSchema = z.strictObject({
|
|
|
250
258
|
defaultCountry: CountryCodeSchema.optional(),
|
|
251
259
|
});
|
|
252
260
|
|
|
253
|
-
|
|
261
|
+
const ADDRESS_FIELD_SHAPE = {
|
|
254
262
|
ref: FieldRefSchema,
|
|
255
263
|
type: z.literal(HumanInputForm_FieldType.ADDRESS).systemEnum('HumanInputForm_FieldType'),
|
|
256
264
|
countriesAllowed: z.array(CountryCodeSchema).min(1).optional(),
|
|
257
265
|
defaultCountry: CountryCodeSchema.optional(),
|
|
258
|
-
}
|
|
266
|
+
};
|
|
267
|
+
export const HumanInputForm_AddressFieldSchema = z.strictObject(ADDRESS_FIELD_SHAPE)
|
|
268
|
+
.refine((field) => !field.defaultCountry || !field.countriesAllowed
|
|
259
269
|
|| field.countriesAllowed.some((country) => country.toUpperCase() === field.defaultCountry!.toUpperCase()), {
|
|
260
270
|
message: 'defaultCountry is not one of countriesAllowed.',
|
|
261
271
|
});
|
|
262
272
|
|
|
263
|
-
|
|
273
|
+
const DECIMAL_FIELD_SHAPE = {
|
|
264
274
|
ref: FieldRefSchema,
|
|
265
275
|
type: z.literal(HumanInputForm_FieldType.DECIMAL).systemEnum('HumanInputForm_FieldType'),
|
|
266
276
|
/** Most decimal places a value may have. */
|
|
267
277
|
precision: z.int().min(0).max(20).optional(),
|
|
268
278
|
min: BigDecimalValueSchema.optional(),
|
|
269
279
|
max: BigDecimalValueSchema.optional(),
|
|
270
|
-
}
|
|
280
|
+
};
|
|
281
|
+
export const HumanInputForm_DecimalFieldSchema = z.strictObject(DECIMAL_FIELD_SHAPE)
|
|
282
|
+
.refine((field) => field.min === undefined || field.max === undefined || bigDecimalCompare(field.min, field.max) <= 0, {
|
|
271
283
|
message: 'min is above max.',
|
|
272
284
|
});
|
|
273
285
|
|
|
@@ -303,6 +315,29 @@ export const HumanInputForm_FieldSchema = z.discriminatedUnion('type', [
|
|
|
303
315
|
]);
|
|
304
316
|
export type HumanInputForm_Field = z.infer<typeof HumanInputForm_FieldSchema>;
|
|
305
317
|
|
|
318
|
+
/** One member of {@link HumanInputForm_FieldSchema}: the schema of one field type. */
|
|
319
|
+
export type HumanInputForm_FieldTypeSchema = (typeof HumanInputForm_FieldSchema)['options'][number];
|
|
320
|
+
|
|
321
|
+
/**
|
|
322
|
+
* The schema of each field type, by type (#3146). Total over `HumanInputForm_FieldType`, so a type added tomorrow does not
|
|
323
|
+
* compile until it has one. A form a model composes is written in a narrower vocabulary, the same types without their
|
|
324
|
+
* validation constraints (#3176), and is a form of this one.
|
|
325
|
+
*/
|
|
326
|
+
export const HUMAN_INPUT_FORM_FIELD_SCHEMA_BY_TYPE: Readonly<Record<HumanInputForm_FieldType, HumanInputForm_FieldTypeSchema>> = {
|
|
327
|
+
[HumanInputForm_FieldType.TEXT]: HumanInputForm_TextFieldSchema,
|
|
328
|
+
[HumanInputForm_FieldType.NUMBER]: HumanInputForm_NumberFieldSchema,
|
|
329
|
+
[HumanInputForm_FieldType.DATE]: HumanInputForm_DateFieldSchema,
|
|
330
|
+
[HumanInputForm_FieldType.DATETIME]: HumanInputForm_DateTimeFieldSchema,
|
|
331
|
+
[HumanInputForm_FieldType.MONEY]: HumanInputForm_MoneyFieldSchema,
|
|
332
|
+
[HumanInputForm_FieldType.RANGE]: HumanInputForm_RangeFieldSchema,
|
|
333
|
+
[HumanInputForm_FieldType.DURATION]: HumanInputForm_DurationFieldSchema,
|
|
334
|
+
[HumanInputForm_FieldType.PHONE]: HumanInputForm_PhoneFieldSchema,
|
|
335
|
+
[HumanInputForm_FieldType.ADDRESS]: HumanInputForm_AddressFieldSchema,
|
|
336
|
+
[HumanInputForm_FieldType.DECIMAL]: HumanInputForm_DecimalFieldSchema,
|
|
337
|
+
[HumanInputForm_FieldType.CHOICE]: HumanInputForm_ChoiceFieldSchema,
|
|
338
|
+
[HumanInputForm_FieldType.CONFIRM]: HumanInputForm_ConfirmFieldSchema,
|
|
339
|
+
};
|
|
340
|
+
|
|
306
341
|
/**
|
|
307
342
|
* One heading and the fields under it: a `<Section>` or a `<WizardStep>`. Its words are the asker's, written as text
|
|
308
343
|
* (`DisplayOrFormSectionLabel.title`). It has no name: the compiler names it by position.
|
|
@@ -242,8 +242,8 @@ together.
|
|
|
242
242
|
| Visible UI, navigation and labels | `frontend/src/**` |
|
|
243
243
|
| Application configuration | `wildo.saas.config.ts` and explicitly referenced config files |
|
|
244
244
|
| Documentation plan — which chapters exist, each one's title, kind and audiences | `specifications/src/documentation-plan/index.ts` |
|
|
245
|
-
| **Chapter bodies — the documentation authoring target** | `specifications/src/technical-documentation/
|
|
246
|
-
| Wiring
|
|
245
|
+
| **Chapter bodies — the documentation authoring target** | `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, one file per chapter |
|
|
246
|
+
| Wiring | `specifications/src/companion-exports.ts` (`documentationPlan`). A chapter file needs no wiring: publication reads the directory |
|
|
247
247
|
| Generated portal output | `technical-doc/src/generated/**` — written by `wildo docs publish`, read/verify only |
|
|
248
248
|
|
|
249
249
|
## When to use
|
|
@@ -291,9 +291,11 @@ A chapter is published only when TWO accepted files agree on it:
|
|
|
291
291
|
1. the **documentation plan** (`specifications/src/documentation-plan/index.ts`)
|
|
292
292
|
declares its `chapterRef` (`chapter-<slug>`), title, kind and reader
|
|
293
293
|
audiences — the plan owns the chapter's identity;
|
|
294
|
-
2. the **chapter file** (`specifications/src/technical-documentation/
|
|
295
|
-
carries its body under that same key, through
|
|
296
|
-
`
|
|
294
|
+
2. the **chapter file** (`specifications/src/technical-documentation/chapters/<chapterRef>.ts`,
|
|
295
|
+
named by the chapter) carries its body under that same key, through
|
|
296
|
+
`export const documentationChapter = defineApplicationDocumentationChapter('<chapterRef>', { … })`.
|
|
297
|
+
One file per chapter, and nothing imports it: several chapters are written at once,
|
|
298
|
+
so never edit another chapter's file, and never add the chapter to an index.
|
|
297
299
|
|
|
298
300
|
Confirm the plan declares the chapter you are writing. If it does not, and your
|
|
299
301
|
task does not own the plan, stop and return a documentation design packet —
|
|
@@ -304,9 +306,13 @@ never write generated MDX.
|
|
|
304
306
|
|
|
305
307
|
Decide the chapter's `classification` explicitly: `PUBLIC` publishes, and
|
|
306
308
|
`RESTRICTED` keeps it out of the public portal. There is no default — an
|
|
307
|
-
unclassified chapter
|
|
308
|
-
`
|
|
309
|
-
|
|
309
|
+
unclassified chapter is refused when the file is evaluated, by the
|
|
310
|
+
`check:specification-exports` verification of the task that writes it and by
|
|
311
|
+
publication. Mark unfinished work `editorialStatus: DRAFT`; it stays in the file
|
|
312
|
+
and is not published. A chapter file imports only `@wildo-ai/*` packages (it is
|
|
313
|
+
re-read when the file itself changes, so a local helper it imported would go
|
|
314
|
+
stale). Read `references/framework-documentation-chapters-api.md` for the exact
|
|
315
|
+
contract.
|
|
310
316
|
|
|
311
317
|
### Step 3: Build the source-fact matrix
|
|
312
318
|
|
|
@@ -399,9 +405,14 @@ message — for every word, and the API reference and the sign-in hand-off page
|
|
|
399
405
|
`technical-doc/i18n/<locale>/code.json`: the `docs.search.*` ids, one
|
|
400
406
|
`docs.search.readerAudience.<VALUE>` entry for every reader audience (the words
|
|
401
407
|
of the audience filter), and the `docs.apiReference.*` and `docs.authExchange.*`
|
|
402
|
-
ids. A counted word is a `|`-separated plural message with `{count}`.
|
|
403
|
-
|
|
404
|
-
|
|
408
|
+
ids. A counted word is a `|`-separated plural message with `{count}`. The site's
|
|
409
|
+
other languages are written by `wildo generate translate`: it translates
|
|
410
|
+
`technical-doc/i18n/en/code.json` into `technical-doc/i18n/<locale>/code.json`
|
|
411
|
+
for each language the application serves (`--units documentation_site` for the
|
|
412
|
+
site alone), whole or not at all, and `docusaurus.config.ts` lists a locale
|
|
413
|
+
exactly when that file exists (`src/documentation-site-locales.ts`). So add a
|
|
414
|
+
word to the English file and run the translation; never add a locale to
|
|
415
|
+
`i18n.locales` by hand, which would show its readers ids. Do not
|
|
405
416
|
use `docusaurus write-translations` for these entries: the calls carry no
|
|
406
417
|
default message, so it writes each id as its own message, drops the authored
|
|
407
418
|
descriptions, and with `--override` replaces the English words with ids. An
|
|
@@ -431,8 +442,8 @@ source-backed in `references/framework-documentation-chapters-api.md`.
|
|
|
431
442
|
- [ ] V2: every material claim has an accepted application source
|
|
432
443
|
- [ ] V3: common framework, application-specific, API and internal content are
|
|
433
444
|
routed to their correct owners
|
|
434
|
-
- [ ] V4: the plan declares every chapter key, and
|
|
435
|
-
`specifications/src/technical-documentation/
|
|
445
|
+
- [ ] V4: the plan declares every chapter key, and each body lives only in its own
|
|
446
|
+
`specifications/src/technical-documentation/chapters/<chapterRef>.ts`
|
|
436
447
|
- [ ] V5: the category has one landing and focused task/reference/support pages
|
|
437
448
|
- [ ] V6: consumer prose contains no Wildo/app-creator/internal vocabulary
|
|
438
449
|
- [ ] V7: variable roles/labels/capabilities are source-derived, not copied
|
|
@@ -444,24 +455,24 @@ source-backed in `references/framework-documentation-chapters-api.md`.
|
|
|
444
455
|
| Invariant | Command |
|
|
445
456
|
|---|---|
|
|
446
457
|
| No framework/internal vocabulary in consumer prose | see the commands below the table |
|
|
447
|
-
| No generic related labels | `rg -n "Related documentation" specifications/src/technical-documentation
|
|
458
|
+
| No generic related labels | `rg -n "Related documentation" specifications/src/technical-documentation/` |
|
|
448
459
|
| No endpoint inventory disguised as a guide | see the commands below the table |
|
|
449
|
-
| No hand-typed API-reference URL in a body | `rg -n "\]\(/api" specifications/src/technical-documentation
|
|
460
|
+
| No hand-typed API-reference URL in a body | `rg -n "\]\(/api" specifications/src/technical-documentation/` prints nothing |
|
|
450
461
|
| Every chapter key is planned | run the command below the table; it prints nothing |
|
|
451
462
|
| No hand-authored generated output | `git diff --name-only -- technical-doc/src/generated` changes only after `wildo docs publish` |
|
|
452
463
|
| Every chapter materialized | `ls technical-doc/src/generated/consumer-documentation/docusaurus/docs/guides/` |
|
|
453
464
|
|
|
454
465
|
```bash
|
|
455
466
|
# No framework/internal vocabulary in consumer prose
|
|
456
|
-
rg -n "Wildo|framework-capabilit|projectionRef|app-creator" specifications/src/technical-documentation/
|
|
467
|
+
rg -n "Wildo|framework-capabilit|projectionRef|app-creator" specifications/src/technical-documentation/
|
|
457
468
|
|
|
458
469
|
# No endpoint inventory disguised as a guide
|
|
459
|
-
rg -n "^(GET|POST|PUT|PATCH|DELETE) /" specifications/src/technical-documentation/
|
|
470
|
+
rg -n "^(GET|POST|PUT|PATCH|DELETE) /" specifications/src/technical-documentation/
|
|
460
471
|
```
|
|
461
472
|
|
|
462
473
|
```bash
|
|
463
474
|
# Every chapter key is planned
|
|
464
|
-
comm -23 <(rg -o -N "chapter-[a-z0-9-]+" specifications/src/technical-documentation/
|
|
475
|
+
comm -23 <(rg -o -N --no-filename "chapter-[a-z0-9-]+" specifications/src/technical-documentation/ | sort -u) <(rg -o -N "chapter-[a-z0-9-]+" specifications/src/documentation-plan/index.ts | sort -u)
|
|
465
476
|
```
|
|
466
477
|
|
|
467
478
|
## Common rationalizations
|
|
@@ -470,7 +481,7 @@ comm -23 <(rg -o -N "chapter-[a-z0-9-]+" specifications/src/technical-documentat
|
|
|
470
481
|
|---|---|
|
|
471
482
|
| “The framework supports it, so this application has it.” | Support is not configuration or availability. V2/V7 require application evidence. |
|
|
472
483
|
| “I know where docs usually live.” | There is exactly one authoring target, keyed by the plan. V4 prevents a parallel convention. |
|
|
473
|
-
| “I'll classify it later; public is the obvious default.” | There is no default: an unclassified chapter
|
|
484
|
+
| “I'll classify it later; public is the obvious default.” | There is no default: an unclassified chapter is refused when its file is evaluated. Decide PUBLIC or RESTRICTED from the sources. |
|
|
474
485
|
| “A business use case can be assembled from generic feature names.” | It needs accepted domain semantics and a real outcome. V1/V2 catch filler. |
|
|
475
486
|
| “Copying the API operations will make the guide concrete.” | Decisions and recovery make a guide concrete. V3 keeps API reference separate. |
|
|
476
487
|
| “The sample app uses these roles.” | The target application's labels and roles are authoritative. V7 catches copying. |
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# Documentation chapter file contract
|
|
2
2
|
|
|
3
|
-
The exact contract of
|
|
4
|
-
one file
|
|
5
|
-
portal.
|
|
3
|
+
The exact contract of a chapter file,
|
|
4
|
+
`specifications/src/technical-documentation/chapters/<chapterRef>.ts` — one file per
|
|
5
|
+
chapter, in which this application authors the prose of its documentation portal.
|
|
6
6
|
|
|
7
7
|
Read this when you:
|
|
8
8
|
|
|
@@ -30,10 +30,16 @@ publication joins the two by `chapterRef`.
|
|
|
30
30
|
*
|
|
31
31
|
* ## Where it lives, and what makes it accepted
|
|
32
32
|
*
|
|
33
|
-
* One file: `specifications/src/technical-documentation/
|
|
34
|
-
* `
|
|
35
|
-
*
|
|
36
|
-
*
|
|
33
|
+
* One file PER CHAPTER: `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, exporting
|
|
34
|
+
* `documentationChapter = defineApplicationDocumentationChapter('<chapterRef>', { … })`. The file is named
|
|
35
|
+
* by the chapter's `chapterRef` and declares that same ref, which is what a build task's landing probe looks
|
|
36
|
+
* for in it. Publication reads every file in that directory; nothing imports or registers them, so writing
|
|
37
|
+
* one chapter never edits a file another chapter is written in, and a build writes its chapters at once
|
|
38
|
+
* (#3204: with one shared file, 23 chapter tasks queued behind each other for about 48 minutes).
|
|
39
|
+
*
|
|
40
|
+
* A set may still be written inline, as a `defineApplicationDocumentationChapters({ … })` value wired into
|
|
41
|
+
* the companion exports as `documentationChapters`. Publication merges the two and refuses a chapter
|
|
42
|
+
* declared in both, or in two files.
|
|
37
43
|
*
|
|
38
44
|
* Accepted means COMMITTED — there is no acceptance state, ledger or digest beside git. Publication
|
|
39
45
|
* (`wildo docs publish`) renders the WORKING TREE, exactly as every other specification-derived page
|
|
@@ -62,12 +68,11 @@ publication joins the two by `chapterRef`.
|
|
|
62
68
|
*
|
|
63
69
|
* @example
|
|
64
70
|
* ```ts
|
|
65
|
-
*
|
|
66
|
-
*
|
|
67
|
-
*
|
|
68
|
-
*
|
|
69
|
-
*
|
|
70
|
-
* },
|
|
71
|
+
* // specifications/src/technical-documentation/chapters/chapter-close-a-deal.ts
|
|
72
|
+
* export const documentationChapter = defineApplicationDocumentationChapter('chapter-close-a-deal', {
|
|
73
|
+
* classification: TechnicalDocumentationSourceClassification.PUBLIC,
|
|
74
|
+
* body: 'Closing a deal moves it to won and notifies its owner.\n\n## Before you start\n\n…',
|
|
75
|
+
* apiReferences: [{ label: 'Change a deal status', resource: 'deals', operation: 'change_status' }],
|
|
71
76
|
* });
|
|
72
77
|
* ```
|
|
73
78
|
*/
|
|
@@ -132,6 +137,7 @@ export const ApplicationDocumentationChapterSourceSchema = z.strictObject({
|
|
|
132
137
|
applicabilityRequirements: z.array(TechnicalDocumentationApplicabilityRequirementV1Schema).default([]),
|
|
133
138
|
});
|
|
134
139
|
export type ApplicationDocumentationChapterSource = z.infer<typeof ApplicationDocumentationChapterSourceSchema>;
|
|
140
|
+
export type ApplicationDocumentationChapterSourceInput = z.input<typeof ApplicationDocumentationChapterSourceSchema>;
|
|
135
141
|
|
|
136
142
|
/** Every authored chapter, keyed by the plan's `chapterRef`. */
|
|
137
143
|
export const ApplicationDocumentationChapterSetSchema = z
|
|
@@ -164,4 +170,33 @@ export type ApplicationDocumentationChapterSetInput = z.input<typeof Application
|
|
|
164
170
|
export function defineApplicationDocumentationChapters(chapters: ApplicationDocumentationChapterSetInput): ApplicationDocumentationChapterSet {
|
|
165
171
|
return ApplicationDocumentationChapterSetSchema.parse(chapters);
|
|
166
172
|
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* Where a chapter's own file lives, relative to the specifications package's `src/`: one file per chapter, named by
|
|
176
|
+
* its `chapterRef` (#3204).
|
|
177
|
+
*/
|
|
178
|
+
export const APPLICATION_DOCUMENTATION_CHAPTER_FILES_DIRECTORY = 'technical-documentation/chapters';
|
|
179
|
+
/** The export a chapter file declares its chapter under. */
|
|
180
|
+
export const APPLICATION_DOCUMENTATION_CHAPTER_FILE_EXPORT = 'documentationChapter';
|
|
181
|
+
|
|
182
|
+
/** One chapter, as its own file declares it: the ref it is the body of, and the body. */
|
|
183
|
+
export interface ApplicationDocumentationChapterDeclaration {
|
|
184
|
+
readonly chapterRef: string;
|
|
185
|
+
readonly chapter: ApplicationDocumentationChapterSource;
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/**
|
|
189
|
+
* Declares ONE chapter, in its own file `technical-documentation/chapters/<chapterRef>.ts` (#3204): the ref's shape, the
|
|
190
|
+
* body rules, and a chapter relating to itself are checked when the file is evaluated. Nothing imports a chapter file, so
|
|
191
|
+
* the specifications package's own load never evaluates it: a build task writing one evaluates it in its
|
|
192
|
+
* `check:specification-exports` verification, and publication evaluates every file before it merges them. Whether a
|
|
193
|
+
* related chapter EXISTS is a question about the whole set, answered by that merge, since sibling chapters are written at
|
|
194
|
+
* the same time. A chapter file imports only `@wildo-ai/*` packages.
|
|
195
|
+
*/
|
|
196
|
+
export function defineApplicationDocumentationChapter(chapterRef: string, chapter: ApplicationDocumentationChapterSourceInput): ApplicationDocumentationChapterDeclaration {
|
|
197
|
+
const ref = ApplicationDocumentationChapterRefSchema.parse(chapterRef);
|
|
198
|
+
const parsed = ApplicationDocumentationChapterSourceSchema.parse(chapter);
|
|
199
|
+
if (parsed.relatedChapterRefs.includes(ref)) throw new Error(`${ref} cannot relate to itself`);
|
|
200
|
+
return { chapterRef: ref, chapter: parsed };
|
|
201
|
+
}
|
|
167
202
|
```
|
|
@@ -37,8 +37,8 @@ Only write the strongest statement supported by the accepted authoring inputs.
|
|
|
37
37
|
|
|
38
38
|
## Design packet when the plan does not declare the chapter
|
|
39
39
|
|
|
40
|
-
The only accepted place to persist a chapter is
|
|
41
|
-
`specifications/src/technical-documentation/
|
|
40
|
+
The only accepted place to persist a chapter is its own file,
|
|
41
|
+
`specifications/src/technical-documentation/chapters/<chapterRef>.ts`, under a `chapterRef` the
|
|
42
42
|
documentation plan declares. When the plan does not declare the chapter you
|
|
43
43
|
would write, and your task does not own the plan, return:
|
|
44
44
|
|
|
@@ -31,9 +31,10 @@ from is committed as `backend-api/migrations/schema-plan.lock.json`. When the
|
|
|
31
31
|
two disagree, that difference is **drift**, and a migration is what closes it.
|
|
32
32
|
|
|
33
33
|
Only resources stored in PostgreSQL are in the plan. A resource read through
|
|
34
|
-
from another system (`persistenceAdapter: HTTP_API`)
|
|
35
|
-
|
|
36
|
-
|
|
34
|
+
from another system (`persistenceAdapter: HTTP_API`) or an introspected one has no
|
|
35
|
+
table and owes no migration, and neither does any resource of a MongoDB
|
|
36
|
+
application. Moving an existing resource to a read-through or introspected adapter
|
|
37
|
+
drops its table, which is a destructive change.
|
|
37
38
|
|
|
38
39
|
Nothing warns you until the backend refuses to start:
|
|
39
40
|
|
|
@@ -48,21 +49,18 @@ command that writes it. This skill is how you avoid ever reading it.
|
|
|
48
49
|
|
|
49
50
|
## Am I even on PostgreSQL?
|
|
50
51
|
|
|
51
|
-
Check before anything else. MongoDB must be declared
|
|
52
|
-
kept on PostgreSQL inside a MongoDB application:
|
|
52
|
+
Check before anything else. MongoDB must be declared:
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
55
|
rg -n "applicationDatabase" infrastructure/*/wildo.infra.*.config.ts
|
|
56
|
-
rg -n "persistenceAdapter: PersistenceAdapter.POSTGRESQL" shared-lib backend-api
|
|
57
56
|
```
|
|
58
57
|
|
|
59
58
|
`applicationDatabase: { engine: DatabaseEngine.POSTGRESQL }` means every workflow
|
|
60
59
|
below is live for you, and so does an ABSENT `applicationDatabase`: an environment
|
|
61
60
|
that declares nothing persists to PostgreSQL. One such environment is enough. You
|
|
62
|
-
opt out only when every environment declares `{ engine: DatabaseEngine.MONGODB }
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
alone (`references/postgresql-vs-mongodb-obligations.md`).
|
|
61
|
+
opt out only when every environment declares `{ engine: DatabaseEngine.MONGODB }`.
|
|
62
|
+
An application uses exactly one transactional store, so no resource is kept on
|
|
63
|
+
PostgreSQL inside a MongoDB application (`references/postgresql-vs-mongodb-obligations.md`).
|
|
66
64
|
|
|
67
65
|
Your application already carries its INITIAL migration: `wildo init` writes it beside the lockfile
|
|
68
66
|
for a PostgreSQL application, because the platform seeds your database during the first registration
|
|
@@ -87,7 +85,7 @@ author a baseline — you generate the migrations that follow your own resource
|
|
|
87
85
|
|
|
88
86
|
## When NOT to Use
|
|
89
87
|
|
|
90
|
-
- Every environment is on MongoDB
|
|
88
|
+
- Every environment is on MongoDB — nothing here applies
|
|
91
89
|
- You are designing the schema itself → `resource-schema-authoring`
|
|
92
90
|
- You are adding a whole resource → `resource-add-resource` (come back here at its last step)
|
|
93
91
|
- You are choosing the store or the backing services → `infra-environment-config`
|
|
@@ -197,6 +195,7 @@ narrow, and both limits are worth knowing:
|
|
|
197
195
|
- `references/framework-application-database-api.md` — source-backed `applicationDatabase` contract
|
|
198
196
|
- `references/migration-refusals.md` — every refusal, what it means, and what to do
|
|
199
197
|
- `references/postgresql-vs-mongodb-obligations.md` — what differs once you are on PostgreSQL
|
|
198
|
+
- `references/postgresql-supported-surfaces.md` — which framework features run on PostgreSQL, and the few observable differences
|
|
200
199
|
|
|
201
200
|
## Verification
|
|
202
201
|
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# What works on PostgreSQL
|
|
2
|
+
|
|
3
|
+
Read this when you are choosing `applicationDatabase`, or when you need to know
|
|
4
|
+
whether a framework feature behaves the same once your application persists to
|
|
5
|
+
PostgreSQL. `postgresql-vs-mongodb-obligations.md` covers what PostgreSQL asks of
|
|
6
|
+
you (migrations); this file covers what you get.
|
|
7
|
+
|
|
8
|
+
The short answer: **every framework surface runs on PostgreSQL.** No engine
|
|
9
|
+
resource is pinned to MongoDB, so a PostgreSQL application keeps all of its
|
|
10
|
+
framework data (users, organizations, files, audit rows, deliveries, billing
|
|
11
|
+
records, agent conversations) in its own PostgreSQL database. The differences
|
|
12
|
+
below are the whole list, and each is a property of the store, not a missing
|
|
13
|
+
feature.
|
|
14
|
+
|
|
15
|
+
## Supported surfaces
|
|
16
|
+
|
|
17
|
+
| Surface | On PostgreSQL | What to know |
|
|
18
|
+
|---|---|---|
|
|
19
|
+
| Resources: create, read, update, delete, list, search, count, bulk writes | Supported | Same operations, same authorization and tenancy scoping as on MongoDB. Scope-anchored list, search and count resolve through the membership junction on both stores. |
|
|
20
|
+
| Field aggregation (sum, max, … used by charts and computed totals) | Supported | A dotted path into a nested object, or a field only one variant carries, is aggregated too. A present value that is not a number FAILS the aggregation instead of counting as 0. |
|
|
21
|
+
| Uniqueness and document numbers | Supported | A unique index is created by your migration; concurrent document-number allocation is serialized by the database. |
|
|
22
|
+
| Files | Supported | File metadata is a row in your database and commits in the same transaction as the row that links it. |
|
|
23
|
+
| Retrieval-augmented generation (`.ragSource()` fields) | Supported, through pgvector | The database must expose the `vector` extension. Startup EXECUTES a vector expression on the live connection and refuses to start without it. The chunk tables are created and kept current by the framework itself, not by your migrations. See the `resource-rag-source-fields` skill. |
|
|
24
|
+
| Audit trail (the database audit rows) | Supported | Audit rows are a resource in your database. One row per event id is enforced by the store, and organization routing is the same as on MongoDB. An optional tamper-evident audit provider (immudb) is a separate backing service and does not depend on which database you chose. |
|
|
25
|
+
| Durable delivery records (inbound deliveries, the billing effect outbox, webhook and SIEM delivery rows and their dead-letter drains) | Supported | The message broker (RabbitMQ) carries the work; the record the framework reads back to deduplicate, retry and drain is a resource in your database. |
|
|
26
|
+
| Transactions | Supported | See below. |
|
|
27
|
+
|
|
28
|
+
## The differences you can observe
|
|
29
|
+
|
|
30
|
+
**Filter operators.** The portable operators are `$eq`, `$ne`, `$gt`, `$gte`,
|
|
31
|
+
`$lt`, `$lte`, `$in`, `$nin`, `$and`, `$or`, `$not`, `$regex`, `$startsWith`,
|
|
32
|
+
`$endsWith`, `$contains` and `$exists`. MongoDB-specific operators (`$where`,
|
|
33
|
+
`$expr`, `$jsonSchema`, `$elemMatch`, `$all`, `$size`, `$type`, `$mod`, `$text`
|
|
34
|
+
and the geospatial ones) are REFUSED on PostgreSQL with an error; nothing
|
|
35
|
+
silently ignores them. A filter written with the portable set runs on both.
|
|
36
|
+
|
|
37
|
+
**A cleared field reads back as absent.** Clearing a `.nullish()` field returns
|
|
38
|
+
it ABSENT on both stores. What is not portable is telling "explicitly set to
|
|
39
|
+
null" apart from "never set": PostgreSQL stores both as NULL. If your logic
|
|
40
|
+
needs that distinction, give it a field of its own.
|
|
41
|
+
|
|
42
|
+
**Transaction options.** `isolationLevel` and `maxWaitMs` (the lock wait) apply
|
|
43
|
+
on PostgreSQL only. `timeoutMs` bounds each statement on PostgreSQL and the
|
|
44
|
+
commit on MongoDB. A transaction that PostgreSQL aborts for a serialization
|
|
45
|
+
failure or a deadlock is run again from the start, up to three runs in total,
|
|
46
|
+
before the error reaches you.
|
|
47
|
+
|
|
48
|
+
**Nesting.** A nested `executeTransaction` either refuses
|
|
49
|
+
(`TransactionNestedBehavior.ERROR`, the default) or joins the active transaction
|
|
50
|
+
(`TransactionNestedBehavior.REUSE`). There is no nested rollback (savepoint) on
|
|
51
|
+
either store: a failure inside a joined call aborts the whole transaction.
|
|
52
|
+
|
|
53
|
+
## One store per application
|
|
54
|
+
|
|
55
|
+
An application uses exactly one transactional store. Every resource it declares
|
|
56
|
+
lives there; startup refuses a resource pinned to the other store. Resources read
|
|
57
|
+
through from another system (`HTTP_API`) or computed from the application
|
|
58
|
+
(`INTROSPECTION`) have no table and behave the same whichever store you chose.
|
|
59
|
+
|
|
60
|
+
## What has not been measured
|
|
61
|
+
|
|
62
|
+
Throughput and latency at production volume have not been benchmarked against a
|
|
63
|
+
representative workload on PostgreSQL. Everything above is verified for
|
|
64
|
+
correctness, not for performance. Size your database from your own load tests.
|