@wildo-ai/framework-knowledge 1.1.10 → 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 +7 -5
- 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 +628 -107
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +90 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- 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 +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- 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 +10 -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 +82 -15
- 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 +1 -5
- 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 +4 -16
- 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 +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 +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 +9 -5
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +11 -7
- 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 +38 -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 +20 -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 +2 -2
- 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 +7 -2
- 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 +6 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +4 -3
- 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 +26 -7
- 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 +23 -6
- 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.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 +7 -3
- 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.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 +9 -7
- 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 +9 -2
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.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 +5 -2
- 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 +15 -5
- 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.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 +7 -3
- 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 +6 -4
- 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.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.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 +24 -9
- 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 +8 -2
- 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 +8 -2
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +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.js.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.js.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 +98 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +124 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- 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 +39 -20
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- 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 +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +12 -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 +788 -49
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +18 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +451 -16
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +3 -6
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +3 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +4 -3
- 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 +115 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +71 -7
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +19 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +126 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +28 -9
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +5 -3
- 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 +67 -5
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +10 -3
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +176 -22
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +21 -3
- 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 -5
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +5 -2
- 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 +153 -28
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +36 -7
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +9 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +2 -1
- 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/method.md +9 -2
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +17 -5
- 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 +49 -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 +15 -5
- 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 +10 -3
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +14 -5
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -1
- 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 +8 -1
- 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 +216 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +108 -0
- 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 +21 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +63 -18
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- 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 +28 -2
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +57 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +65 -13
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +463 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +438 -12
- package/dist/knowledge/references/business-model.pricing-plan.config.md +19 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +29 -8
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- 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 +342 -76
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +16 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +4 -3
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +22 -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 +47 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +78 -19
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +34 -63
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- 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.module.relationships.scope-membership-junction.md +8 -10
- 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.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +38 -4
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -5
- 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.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +87 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +80 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +20 -21
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- 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.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- 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.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +127 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +8 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +13 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +168 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +72 -8
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +235 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1272 -3
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- 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 +28 -8
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +94 -13
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +140 -7
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +282 -0
- package/dist/knowledge/references/platform.config.saas.md +126 -32
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- 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.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +11 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +47 -0
- 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/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +158 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +85 -12
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +179 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- 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.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- 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 +105 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +7 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +35 -4
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +219 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +661 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +15 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +28 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- 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.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +394 -104
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -10
- 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.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- 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.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -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.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +92 -23
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +57 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +14 -2
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +7 -4
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +17 -16
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +184 -5
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +3 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +59 -19
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +344 -62
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -8
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +183 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +72 -13
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +18 -5
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +175 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +54 -74
- package/dist/knowledge/references/saas.models.conversation-threads.md +43 -6
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +32 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +29 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +442 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +91 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -79
- package/dist/knowledge/references/saas.models.engine-capabilities.md +39 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +96 -26
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +321 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +154 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +70 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +349 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +4 -3
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +274 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +176 -50
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +75 -3
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +28 -3
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +259 -21
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +74 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +51 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +933 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +228 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +291 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +114 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +114 -7
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +73 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- 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 +280 -40
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +38 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +20 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +52 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -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.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +165 -44
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +92 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- 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-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +137 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +23 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +46 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +12 -6
- package/dist/knowledge/references/saas.models.schema-family-builder.md +32 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -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 +123 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +19 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +110 -14
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -25
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +287 -17
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +30 -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 +22 -4
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +44 -5
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +113 -70
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +51 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +77 -14
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +49 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +17 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +98 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +105 -49
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +106 -9
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +115 -87
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +188 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +5 -2
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +26 -3
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +4 -3
- package/dist/knowledge/references/saas.website.label-pack.validator.md +9 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +19 -4
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +44 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +303 -0
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/website-plan.config.md +544 -32
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +133 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +124 -34
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +99 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +34 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +10 -8
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +6 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +52 -18
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +107 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +193 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -8
- package/dist/knowledge/references/zod.factories.code.md +18 -9
- package/dist/knowledge/references/zod.factories.duration.md +23 -14
- package/dist/knowledge/references/zod.factories.money.md +24 -15
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +5250 -2565
- package/dist/knowledge/registries/playbooks.json +88 -55
- package/dist/knowledge/registries/source-tags.json +9347 -4807
- package/dist/knowledge/rules/database-migration-obligation.md +10 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +62 -33
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +227 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +16 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +376 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- 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 +26 -9
- 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 +37 -1
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +24 -7
- 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 +168 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +92 -0
- 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 +66 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +108 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +81 -10
- 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-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +5 -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/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +191 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +127 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- 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 +166 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +307 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +179 -37
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +48 -11
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +896 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +184 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +487 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +62 -29
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- 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 +21 -6
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +24 -22
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +245 -162
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +38 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +278 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +12 -1
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +4 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -6
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +18 -5
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +333 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +83 -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 -10
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1370 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +77 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +171 -26
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +126 -32
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +16 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- 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-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +167 -84
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +20 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +38 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- 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 +47 -6
- 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 +10 -2
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +102 -23
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +103 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +35 -4
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +71 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +298 -26
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +78 -19
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +455 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +446 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +174 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- 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 +10 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +69 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +695 -11
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +124 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +276 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +120 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +283 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +134 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +91 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +78 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +16 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +5 -4
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -19
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +166 -21
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +1 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +35 -3
- 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 +93 -13
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +49 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +245 -27
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +471 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +44 -5
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +39 -16
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +226 -73
- 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 +140 -7
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +370 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- 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/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- 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 +7 -5
- 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-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +33 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +42 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +49 -7
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +63 -9
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +43 -11
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +58 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +257 -46
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +30 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +110 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +143 -119
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1259 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +555 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +163 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +149 -0
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +98 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +1 -1
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +388 -11
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +31 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- 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 +13 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +755 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +235 -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 +72 -8
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +9 -5
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +11 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +50 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +41 -15
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1275 -4
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +71 -35
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +451 -67
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +57 -8
- 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 +165 -44
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +138 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +171 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +8 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +371 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +51 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +163 -0
- 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 +200 -61
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +8 -3
- 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 +8 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +351 -159
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +160 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +440 -119
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +426 -32
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +344 -62
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +326 -76
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +71 -12
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +96 -26
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +257 -57
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +147 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +62 -15
- 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/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +65 -18
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +77 -7
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +25 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +18 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +42 -3
- 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 +21 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +114 -7
- 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 +46 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +27 -11
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +13 -8
- 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 +4 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +105 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +150 -35
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +32 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +58 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +107 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +200 -69
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +326 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +7 -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 +219 -77
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +105 -24
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +131 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +428 -72
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- 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 +223 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +186 -65
- 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 +138 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +89 -32
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +73 -0
- 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/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +48 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -32
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +72 -13
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- 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 +30 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +15 -7
- 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 +186 -83
- 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 +113 -70
- 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-add-composite-view/SKILL.md +14 -5
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -1
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -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 +41 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- 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 +15 -4
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +11 -2
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +57 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +61 -25
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +253 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1105 -222
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +42 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +20 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +84 -28
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +67 -64
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +58 -23
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +43 -21
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +112 -77
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +24 -13
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +255 -397
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +28 -6
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -326
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +160 -67
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +29 -5
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +48 -28
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +409 -186
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +399 -235
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +562 -303
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +648 -275
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +573 -265
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +533 -234
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +604 -333
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +594 -379
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +189 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +5 -2
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +740 -316
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +183 -67
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +576 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +1 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +6 -94
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17998 -8568
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +0 -169
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -30,6 +30,34 @@ enqueues in its transaction. Delivery is engine-internal; there is no
|
|
|
30
30
|
application-facing relay, so an application declaring it would lose its audit
|
|
31
31
|
rows and notifications.
|
|
32
32
|
|
|
33
|
+
A commit can land and lose its reply, so the transaction throws although its
|
|
34
|
+
writes are in the store. When repeating the operation would be refused once it
|
|
35
|
+
has happened (a status that moved on, a unique key, a "not pending" check), or
|
|
36
|
+
would create a second row, declare `transactionalCoreCommitOutcomeResolver`.
|
|
37
|
+
It reads the row back by something only this attempt wrote, and its answer
|
|
38
|
+
decides what the caller is told: LANDED answers the stored row as a success,
|
|
39
|
+
NOT_LANDED leaves the commit's error, UNKNOWN refuses with a 409 whose `code`
|
|
40
|
+
is `ResourceOperationOutcomeErrorCode.OUTCOME_UNKNOWN`, so a screen can say
|
|
41
|
+
the change may already have been saved rather than that it failed. Build it
|
|
42
|
+
with `createTransactionalCoreCommitReadBack` and `carriesAttemptCreatedRow` (a
|
|
43
|
+
CREATE) or `carriesAttemptUpdateStamp` (an UPDATE), all from
|
|
44
|
+
`@wildo-ai/saas-backend-lib`. On LANDED the framework runs every post-commit
|
|
45
|
+
effect the attempt registered, once, so the resolver records nothing and your
|
|
46
|
+
postfix must register its facts after commit rather than write them inside the
|
|
47
|
+
transaction. A resolver only withholds, through
|
|
48
|
+
`withheldPostCommitEffectKeys`, an effect of its own that the stored row
|
|
49
|
+
disproves.
|
|
50
|
+
|
|
51
|
+
A DELETE leaves nothing only it wrote: the row being gone is also what another
|
|
52
|
+
remover leaves, so never read a delete back by the row's absence. Build its
|
|
53
|
+
resolver with `createTransactionalCoreDeleteReadBack({ reason, readRemovedRow })`
|
|
54
|
+
instead. The framework then writes a commit receipt inside each attempt's
|
|
55
|
+
transaction under an id only that attempt holds, and the read-back answers
|
|
56
|
+
LANDED only when that receipt is stored. Without one, `readRemovedRow` (read the
|
|
57
|
+
row the request removed, through `utils.currentObject`) decides: still stored is
|
|
58
|
+
NOT_LANDED, gone is UNKNOWN. The receipt names the operation and an instant,
|
|
59
|
+
nothing about the row or the person, and expires after an hour.
|
|
60
|
+
|
|
33
61
|
What does reach application code: every resource post-operation hook receives
|
|
34
62
|
a fifth argument, `{ postCommitEffectOwnership }`, which a hook that does not
|
|
35
63
|
own outbox-delivered work ignores.
|
|
@@ -82,6 +110,8 @@ export interface ResourceOperationDeferredEffectContext {
|
|
|
82
110
|
agentActor?: AuditAgentActor;
|
|
83
111
|
/** The external OAuth client a person delegated the operation to, when one was involved. */
|
|
84
112
|
delegatingClientId?: string;
|
|
113
|
+
/** The inbound delivery the operation arrived through, when one caused it (#2665). */
|
|
114
|
+
arrivedThrough?: Inbound_Arrival;
|
|
85
115
|
requestFrame: { correlationId: string; frontendServiceName?: string; clientInstanceId?: string };
|
|
86
116
|
}
|
|
87
117
|
|
|
@@ -241,6 +271,124 @@ export type ResourceCustomServiceImplementationTransactionalCoreConflictResolver
|
|
|
241
271
|
utils: ResourceOperation_CustomImplementation_Utils,
|
|
242
272
|
) => Promise<ResourceCustomServiceImplementationTransactionalCoreConflictResolution>;
|
|
243
273
|
|
|
274
|
+
/**
|
|
275
|
+
* What reading back an owned transaction whose COMMIT threw found (#2820). The attempt's work all resolved and the
|
|
276
|
+
* transaction then failed: the commit may have landed and lost its reply, so the error alone says nothing about whether
|
|
277
|
+
* the operation happened.
|
|
278
|
+
*/
|
|
279
|
+
export enum ResourceCustomServiceImplementationTransactionalCoreCommitOutcome {
|
|
280
|
+
/** The operation's writes are in the store: the request succeeded, and its caller is answered with `value`. */
|
|
281
|
+
LANDED = 'landed',
|
|
282
|
+
/** The read found the writes absent: the transaction did not commit, and the caller gets the commit's error. */
|
|
283
|
+
NOT_LANDED = 'not_landed',
|
|
284
|
+
/** Nothing could be read: the caller gets `refusal`, which must not say the operation failed (it may have happened). */
|
|
285
|
+
UNKNOWN = 'unknown',
|
|
286
|
+
/**
|
|
287
|
+
* This resolver does not judge this attempt (it reads back only some of the shapes its operation writes). The next
|
|
288
|
+
* resolver is asked; when none settles it, the caller gets the commit's error, as without a resolver.
|
|
289
|
+
*/
|
|
290
|
+
UNHANDLED = 'unhandled',
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
export type ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolution =
|
|
294
|
+
| {
|
|
295
|
+
outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.LANDED;
|
|
296
|
+
/** The committed core state as read back: what the operation answers, as if its commit had answered. */
|
|
297
|
+
value: unknown;
|
|
298
|
+
/**
|
|
299
|
+
* Keys of post-commit effects THIS implementation registered whose premise the read-back disproved (an approval
|
|
300
|
+
* announced as waiting that was answered before the read-back): the framework drops them instead of running them.
|
|
301
|
+
* Every other effect the attempt registered runs. Omit it when the stored state still bears out every effect.
|
|
302
|
+
*/
|
|
303
|
+
withheldPostCommitEffectKeys?: readonly string[];
|
|
304
|
+
}
|
|
305
|
+
| {
|
|
306
|
+
outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.NOT_LANDED;
|
|
307
|
+
}
|
|
308
|
+
| {
|
|
309
|
+
outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.UNKNOWN;
|
|
310
|
+
/** The error thrown to the caller instead of the commit's: a stable, client-branchable refusal saying it may have happened. */
|
|
311
|
+
refusal: unknown;
|
|
312
|
+
}
|
|
313
|
+
| {
|
|
314
|
+
outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.UNHANDLED;
|
|
315
|
+
};
|
|
316
|
+
|
|
317
|
+
/**
|
|
318
|
+
* The commit receipt the framework wrote inside an attempt's transaction (#2870): a row whose id only that attempt holds,
|
|
319
|
+
* so it is stored if and only if the attempt committed. Present only for an operation whose commit-outcome resolver reads
|
|
320
|
+
* one (its resolver was built with `createTransactionalCoreDeleteReadBack`).
|
|
321
|
+
*/
|
|
322
|
+
export interface ResourceCustomServiceImplementationTransactionalCoreCommitReceipt {
|
|
323
|
+
/** The id the framework minted for this attempt. For the log; the receipt is read through {@link isStored}. */
|
|
324
|
+
readonly id: string;
|
|
325
|
+
/**
|
|
326
|
+
* Whether the receipt is stored, read outside the failed transaction. `true` proves the attempt committed. Throws when
|
|
327
|
+
* the store cannot answer, and only then is the read worth retrying.
|
|
328
|
+
*/
|
|
329
|
+
readonly isStored: () => Promise<boolean>;
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
/** The attempt whose work resolved before its commit threw (#2820): what the resolver reads back by. */
|
|
333
|
+
export interface ResourceCustomServiceImplementationTransactionalCoreCommittedAttempt {
|
|
334
|
+
/** The input after PREFIX: what the attempt minted (an id, a decision ref) is here. */
|
|
335
|
+
readonly input: unknown;
|
|
336
|
+
/** The core state the attempt produced, as its writes returned it inside the transaction. */
|
|
337
|
+
readonly state: unknown;
|
|
338
|
+
/** The attempt's commit receipt (#2870), when its operation's resolver reads one. */
|
|
339
|
+
readonly commitReceipt?: ResourceCustomServiceImplementationTransactionalCoreCommitReceipt;
|
|
340
|
+
}
|
|
341
|
+
|
|
342
|
+
/**
|
|
343
|
+
* Invoked when an owned transaction's work resolved and its commit then threw (#2820), so the operation may have happened
|
|
344
|
+
* with its caller about to be told it failed. The resolver reads the store back (outside the failed transaction) by
|
|
345
|
+
* something only this attempt wrote (an id it minted, a timestamp it stamped), never by a guess, and answers LANDED,
|
|
346
|
+
* NOT_LANDED or UNKNOWN.
|
|
347
|
+
*
|
|
348
|
+
* On LANDED the framework answers the caller with `value` and runs, once, every post-commit effect the attempt
|
|
349
|
+
* registered on the transaction whose commit threw (#2825): the operation's framework work (audit row, notifications),
|
|
350
|
+
* the implementation's own effects, and those of every nested operation it called. The resolver records nothing itself;
|
|
351
|
+
* it only withholds an effect of its own whose premise the read-back disproved (`withheldPostCommitEffectKeys`).
|
|
352
|
+
*
|
|
353
|
+
* On UNKNOWN its `refusal` is thrown: a 409 with a stable, client-branchable `code` saying the operation may have taken
|
|
354
|
+
* effect. `ResourceOperationOutcomeErrorCode.OUTCOME_UNKNOWN` is the general one; a request that RAISES a human decision
|
|
355
|
+
* uses `HumanDecisionRequestErrorCode.REQUEST_OUTCOME_UNKNOWN`. The attempt's registered effects are then dropped for
|
|
356
|
+
* good (nothing knows whether their writes exist), and a retry is usually refused as already done when the commit did
|
|
357
|
+
* land: the caller is meant to look at the record, not to repeat the act. Only a repair the operation owns (the decision
|
|
358
|
+
* planes' request repairs) records them later.
|
|
359
|
+
*
|
|
360
|
+
* Most operations write one row they can be read back by, and build the resolver with
|
|
361
|
+
* `createTransactionalCoreCommitReadBack` (from `@wildo-ai/saas-backend-lib`): `carriesAttemptCreatedRow` for a CREATE (the
|
|
362
|
+
* id the attempt's write produced), `carriesAttemptUpdateStamp` for an UPDATE (the `updatedAt` its write stamped). It
|
|
363
|
+
* reads up to four times over about 4 s and refuses UNKNOWN with the general code. `readBackTransactionalCoreCommit` is the
|
|
364
|
+
* lower-level loop for a read-back of another shape.
|
|
365
|
+
*
|
|
366
|
+
* A DELETE leaves nothing only it wrote: the row's absence is also what another remover leaves. Build its resolver with
|
|
367
|
+
* `createTransactionalCoreDeleteReadBack` (#2870). The framework then writes a commit receipt inside each attempt's
|
|
368
|
+
* transaction, under an id only that attempt holds, and the read-back answers LANDED only when that receipt is stored.
|
|
369
|
+
* When it is not, a row still stored is NOT_LANDED, and a row that is gone is UNKNOWN: never taken for this attempt's work.
|
|
370
|
+
*
|
|
371
|
+
* @example
|
|
372
|
+
* createResourceCustomServiceImplementation({
|
|
373
|
+
* operationPath,
|
|
374
|
+
* transactionalCore: true,
|
|
375
|
+
* transactionParticipants: {},
|
|
376
|
+
* handlers: { prefixCoreOperations, postfixCoreOperations },
|
|
377
|
+
* // A repeat of this verb is refused once it has happened, so a lost commit reply is read back by the row's stamp.
|
|
378
|
+
* transactionalCoreCommitOutcomeResolver: createTransactionalCoreCommitReadBack({
|
|
379
|
+
* reason: 'invoice_approval_outcome_unknown',
|
|
380
|
+
* read: (prepared, _executionContext, utils) => utils.systemAccessService!.readAsSystem(INVOICES, { _id: String(prepared._id) }),
|
|
381
|
+
* carriesThisAttempt: carriesAttemptUpdateStamp,
|
|
382
|
+
* }),
|
|
383
|
+
* });
|
|
384
|
+
*/
|
|
385
|
+
export type ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolver = (
|
|
386
|
+
error: unknown,
|
|
387
|
+
attempt: ResourceCustomServiceImplementationTransactionalCoreCommittedAttempt,
|
|
388
|
+
executionContext: ExecutionContext<any>,
|
|
389
|
+
utils: ResourceOperation_CustomImplementation_Utils,
|
|
390
|
+
) => Promise<ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolution>;
|
|
391
|
+
|
|
244
392
|
/**
|
|
245
393
|
* Transaction ownership options for one custom-implementation registration.
|
|
246
394
|
*
|
|
@@ -305,6 +453,12 @@ export type ResourceCustomServiceImplementationTransactionalCoreConfiguration =
|
|
|
305
453
|
* retry, or leave the original conflict unhandled.
|
|
306
454
|
*/
|
|
307
455
|
transactionalCoreConflictResolver?: ResourceCustomServiceImplementationTransactionalCoreConflictResolver;
|
|
456
|
+
/**
|
|
457
|
+
* Optional read-back invoked when the transaction's work resolved and its COMMIT then threw (#2820): it decides
|
|
458
|
+
* whether the caller is told the operation succeeded, failed, or may have happened. See
|
|
459
|
+
* {@link ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolver}.
|
|
460
|
+
*/
|
|
461
|
+
transactionalCoreCommitOutcomeResolver?: ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolver;
|
|
308
462
|
}
|
|
309
463
|
| {
|
|
310
464
|
/** Default non-transactional custom-implementation behavior. */
|
|
@@ -313,6 +467,8 @@ export type ResourceCustomServiceImplementationTransactionalCoreConfiguration =
|
|
|
313
467
|
transactionParticipants?: never;
|
|
314
468
|
/** A conflict resolver has no valid invocation boundary without the transaction. */
|
|
315
469
|
transactionalCoreConflictResolver?: never;
|
|
470
|
+
/** Nor has a commit-outcome resolver: without an owned transaction there is no commit of its own to read back. */
|
|
471
|
+
transactionalCoreCommitOutcomeResolver?: never;
|
|
316
472
|
};
|
|
317
473
|
```
|
|
318
474
|
|
|
@@ -341,8 +497,219 @@ export enum ResourceOperation_PostCommitEffectOwnership {
|
|
|
341
497
|
* still run and are told the ownership, so a hook whose work the outbox owns can stand down.
|
|
342
498
|
*
|
|
343
499
|
* Requires `transactionalCore: true`, because the enqueue must commit with the change. Refused for an operation that
|
|
344
|
-
* generates a consumable token, because a replayed notification would need the token's secret persisted
|
|
500
|
+
* generates a consumable token, because a replayed notification would need the token's secret persisted; and for an
|
|
501
|
+
* operation that runs in the background, because its `operation.completed` must name the job its caller holds and a
|
|
502
|
+
* relay replaying it later, outside the run, cannot.
|
|
345
503
|
*/
|
|
346
504
|
IMPLEMENTATION_OUTBOX = "implementation_outbox",
|
|
347
505
|
}
|
|
348
506
|
```
|
|
507
|
+
|
|
508
|
+
The read-back helpers a commit-outcome resolver is built from, and the refusal it answers UNKNOWN with:
|
|
509
|
+
|
|
510
|
+
## Import Origins
|
|
511
|
+
|
|
512
|
+
- `@wildo-ai/saas-backend-lib`
|
|
513
|
+
|
|
514
|
+
## Source Excerpts
|
|
515
|
+
|
|
516
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
517
|
+
|
|
518
|
+
```typescript
|
|
519
|
+
/**
|
|
520
|
+
* The refusal a commit-outcome resolver answers UNKNOWN with when it cannot read its write back: a 409 CONFLICT whose
|
|
521
|
+
* `code` is `ResourceOperationOutcomeErrorCode.OUTCOME_UNKNOWN` (allow-listed through the client sanitizer) and whose
|
|
522
|
+
* message reference is `RESOURCE_OPERATION_OUTCOME_UNKNOWN`, so a screen says "this may have been saved; look before
|
|
523
|
+
* doing it again" rather than a failure or a generic conflict. `reason` and `subject` are for the log only: the sanitizer
|
|
524
|
+
* strips them.
|
|
525
|
+
*
|
|
526
|
+
* Not for a request that RAISES a human decision: that one may be waiting for an approver, and says so with
|
|
527
|
+
* `HumanDecisionRequestErrorCode.REQUEST_OUTCOME_UNKNOWN`.
|
|
528
|
+
*/
|
|
529
|
+
export function buildResourceOperationOutcomeUnknownRefusal(
|
|
530
|
+
errorBuilder: Pick<ErrorBuilderBackendService, 'buildError'>,
|
|
531
|
+
executionContext: ExecutionContext<any>,
|
|
532
|
+
params: { readonly reason: string; readonly subject?: Readonly<Record<string, unknown>> },
|
|
533
|
+
): unknown {
|
|
534
|
+
return errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {
|
|
535
|
+
customMessageReference: ErrorCustomMessageReference.RESOURCE_OPERATION_OUTCOME_UNKNOWN,
|
|
536
|
+
context: { code: ResourceOperationOutcomeErrorCode.OUTCOME_UNKNOWN, reason: params.reason, ...(params.subject ?? {}) },
|
|
537
|
+
});
|
|
538
|
+
}
|
|
539
|
+
|
|
540
|
+
/**
|
|
541
|
+
* Whether `error` is the refusal {@link buildResourceOperationOutcomeUnknownRefusal} builds (#2825): an operation whose
|
|
542
|
+
* commit threw and could not be read back, which may have taken effect. A caller that reads a CONFLICT as "the operation
|
|
543
|
+
* refused" or "another writer won" must test this first: it is neither.
|
|
544
|
+
*/
|
|
545
|
+
export function isResourceOperationOutcomeUnknownRefusal(error: unknown): boolean {
|
|
546
|
+
return isWildoBackendError(error) && (error.context as { code?: unknown } | undefined)?.code === ResourceOperationOutcomeErrorCode.OUTCOME_UNKNOWN;
|
|
547
|
+
}
|
|
548
|
+
```
|
|
549
|
+
|
|
550
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
551
|
+
|
|
552
|
+
```typescript
|
|
553
|
+
/** A stored row as a read-back sees it: its id, and whatever else the operation's resource carries. */
|
|
554
|
+
export type TransactionalCoreCommitReadBackRow = Readonly<Record<string, unknown>> & { readonly _id?: unknown };
|
|
555
|
+
|
|
556
|
+
/**
|
|
557
|
+
* A commit-outcome resolver for an operation whose transaction writes ONE row it can be read back by (#2825): the
|
|
558
|
+
* attempt's core state names that row (`_id`), `read` fetches it outside the failed transaction, and `carriesThisAttempt`
|
|
559
|
+
* says whether the stored row is this attempt's write. Every other effect of the attempt is the framework's to run once
|
|
560
|
+
* the answer is LANDED; the resolver records nothing.
|
|
561
|
+
*
|
|
562
|
+
* - The attempt produced no row with an id (a REPLACE that answered nothing): UNHANDLED, the commit's error stands.
|
|
563
|
+
* - `read` throws on every try: UNKNOWN, refused with `refusal` (default: the general
|
|
564
|
+
* {@link buildResourceOperationOutcomeUnknownRefusal}, carrying `reason` and the row's id for the log).
|
|
565
|
+
* - The row is absent, or another writer's: NOT_LANDED, the commit's error stands.
|
|
566
|
+
* - The row is this attempt's write: LANDED, answered with the stored row, less any effect `withheldPostCommitEffectKeys`
|
|
567
|
+
* names.
|
|
568
|
+
*
|
|
569
|
+
* Choose `carriesThisAttempt` by what only this attempt wrote: {@link carriesAttemptCreatedRow} for a CREATE (the id it
|
|
570
|
+
* minted), {@link carriesAttemptUpdateStamp} for an UPDATE (the `updatedAt` its write stamped; both adapters stamp it on
|
|
571
|
+
* every update). A stored row a LATER writer changed no longer carries the stamp and reads NOT_LANDED: the caller is then
|
|
572
|
+
* told what the commit said, which is no worse than without a resolver, and never told a write landed that is not theirs.
|
|
573
|
+
*/
|
|
574
|
+
export function createTransactionalCoreCommitReadBack<TRow extends TransactionalCoreCommitReadBackRow = TransactionalCoreCommitReadBackRow>(params: {
|
|
575
|
+
/** Names the operation in the log lines and in the refusal's (log-only) reason. */
|
|
576
|
+
readonly reason: string;
|
|
577
|
+
/** The stored row the attempt wrote, `null` / `undefined` when there is none; throws when the store cannot answer. */
|
|
578
|
+
readonly read: (prepared: TRow, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils) => Promise<TRow | null | undefined>;
|
|
579
|
+
readonly carriesThisAttempt: (stored: TRow, prepared: TRow) => boolean;
|
|
580
|
+
readonly withheldPostCommitEffectKeys?: (stored: TRow, prepared: TRow) => readonly string[];
|
|
581
|
+
/** The UNKNOWN refusal; default the general outcome-unknown one. A request that raises a human decision passes its own. */
|
|
582
|
+
readonly refusal?: (prepared: TRow, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils) => unknown;
|
|
583
|
+
/** Tests pass an immediate wait. */
|
|
584
|
+
readonly wait?: (delayMs: number) => Promise<void>;
|
|
585
|
+
}): ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolver {
|
|
586
|
+
return async (_commitError, attempt, executionContext, utils) => {
|
|
587
|
+
const prepared = attempt.state as TRow | null | undefined;
|
|
588
|
+
if (!prepared || typeof prepared !== 'object' || prepared._id === undefined || prepared._id === null || prepared._id === '') {
|
|
589
|
+
return { outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.UNHANDLED };
|
|
590
|
+
}
|
|
591
|
+
const rowId = String(prepared._id);
|
|
592
|
+
return readBackTransactionalCoreCommit<TRow>({
|
|
593
|
+
read: () => params.read(prepared, executionContext, utils),
|
|
594
|
+
carriesThisAttempt: (stored) => params.carriesThisAttempt(stored, prepared),
|
|
595
|
+
refusal: () => params.refusal?.(prepared, executionContext, utils)
|
|
596
|
+
?? buildResourceOperationOutcomeUnknownRefusal(utils.errorBuilder, executionContext, { reason: params.reason, subject: { rowId } }),
|
|
597
|
+
logger: utils.logger,
|
|
598
|
+
logSubject: { reason: params.reason, rowId },
|
|
599
|
+
...(params.wait ? { wait: params.wait } : {}),
|
|
600
|
+
...(params.withheldPostCommitEffectKeys ? { withheldPostCommitEffectKeys: (stored: TRow) => params.withheldPostCommitEffectKeys!(stored, prepared) } : {}),
|
|
601
|
+
});
|
|
602
|
+
};
|
|
603
|
+
}
|
|
604
|
+
|
|
605
|
+
/**
|
|
606
|
+
* A commit-outcome resolver for a DELETE (#2870): an operation whose transaction removes one row, so nothing of its own is
|
|
607
|
+
* left to read back by. The row's absence proves nothing: another remover leaves the same. So the proof is the attempt's
|
|
608
|
+
* COMMIT RECEIPT, which the framework writes inside the attempt's transaction under an id only that attempt holds
|
|
609
|
+
* (building the resolver with this helper is what makes the framework write it). Commit is atomic, so a stored receipt
|
|
610
|
+
* means this attempt's writes committed, whoever else touched the row.
|
|
611
|
+
*
|
|
612
|
+
* - The receipt is stored: LANDED, answered with the state the attempt's core produced (what its commit would have
|
|
613
|
+
* answered), and the framework runs every post-commit effect the attempt registered, once.
|
|
614
|
+
* - The receipt is absent and the row is still stored (`readRemovedRow` answers it): NOT_LANDED, the commit's
|
|
615
|
+
* error stands.
|
|
616
|
+
* - The receipt is absent and the row is gone: nothing proves this attempt (another remover, or a commit not yet visible).
|
|
617
|
+
* Read again on the same schedule as a failed read, and refused UNKNOWN when it stays so. Never LANDED: that would
|
|
618
|
+
* announce this attempt's audit rows and notices for a delete somebody else performed.
|
|
619
|
+
* - No read could be made, on every try: UNKNOWN.
|
|
620
|
+
*
|
|
621
|
+
* `readRemovedRow` reads the row the operation deleted, outside the failed transaction (the request's `currentObject`
|
|
622
|
+
* names it), and answers it, or `null` / `undefined` when it is not stored; it throws when the store cannot answer.
|
|
623
|
+
*/
|
|
624
|
+
export function createTransactionalCoreDeleteReadBack(params: {
|
|
625
|
+
/** Names the operation in the log lines and in the refusal's (log-only) reason. */
|
|
626
|
+
readonly reason: string;
|
|
627
|
+
readonly readRemovedRow: (executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils) => Promise<unknown>;
|
|
628
|
+
/** The UNKNOWN refusal; default the general outcome-unknown one. */
|
|
629
|
+
readonly refusal?: (executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils) => unknown;
|
|
630
|
+
/** Tests pass an immediate wait. */
|
|
631
|
+
readonly wait?: (delayMs: number) => Promise<void>;
|
|
632
|
+
}): ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolver {
|
|
633
|
+
const resolver: ResourceCustomServiceImplementationTransactionalCoreCommitOutcomeResolver = async (_commitError, attempt, executionContext, utils) => {
|
|
634
|
+
const wait = params.wait ?? waitBeforeTransactionalCoreCommitReadBack;
|
|
635
|
+
const rowId = (utils.currentObject as { _id?: unknown } | undefined)?._id;
|
|
636
|
+
const logSubject = { reason: params.reason, ...(rowId === undefined || rowId === null ? {} : { rowId: String(rowId) }) };
|
|
637
|
+
const refuse = () => ({
|
|
638
|
+
outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.UNKNOWN as const,
|
|
639
|
+
refusal: params.refusal?.(executionContext, utils)
|
|
640
|
+
?? buildResourceOperationOutcomeUnknownRefusal(utils.errorBuilder, executionContext, { reason: params.reason, subject: logSubject }),
|
|
641
|
+
});
|
|
642
|
+
// The state is what LANDED answers with; an attempt that produced none (a REPLACE that answered nothing) is not judged.
|
|
643
|
+
if (attempt.state === undefined) {
|
|
644
|
+
return { outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.UNHANDLED };
|
|
645
|
+
}
|
|
646
|
+
// A read-back built with this helper makes the framework write a receipt in every root-owned attempt. Its absence
|
|
647
|
+
// here means a registration path that lost the mark; nothing can then prove the delete, so it is refused UNKNOWN,
|
|
648
|
+
// never guessed.
|
|
649
|
+
if (!attempt.commitReceipt) {
|
|
650
|
+
utils.logger.error('A delete read-back found no commit receipt on its attempt; the outcome is refused as unknown', logSubject);
|
|
651
|
+
return refuse();
|
|
652
|
+
}
|
|
653
|
+
for (let readIndex = 0; ; readIndex += 1) {
|
|
654
|
+
const delayMs = TRANSACTIONAL_CORE_COMMIT_READ_BACK_DELAYS_MS[readIndex];
|
|
655
|
+
try {
|
|
656
|
+
if (await attempt.commitReceipt.isStored()) {
|
|
657
|
+
return { outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.LANDED, value: attempt.state };
|
|
658
|
+
}
|
|
659
|
+
const remaining = await params.readRemovedRow(executionContext, utils);
|
|
660
|
+
if (remaining !== null && remaining !== undefined) {
|
|
661
|
+
return { outcome: ResourceCustomServiceImplementationTransactionalCoreCommitOutcome.NOT_LANDED };
|
|
662
|
+
}
|
|
663
|
+
utils.logger.warn('A delete whose commit threw left no receipt and no row: another remover, or a commit not yet visible', {
|
|
664
|
+
...logSubject, attempt: readIndex + 1, retrying: delayMs !== undefined,
|
|
665
|
+
});
|
|
666
|
+
} catch (error) {
|
|
667
|
+
utils.logger.warn('A transactional operation whose commit threw could not be read back', {
|
|
668
|
+
...logSubject, attempt: readIndex + 1, retrying: delayMs !== undefined, ...projectCaughtErrorLogFields(error),
|
|
669
|
+
});
|
|
670
|
+
}
|
|
671
|
+
if (delayMs === undefined) return refuse();
|
|
672
|
+
await wait(delayMs);
|
|
673
|
+
}
|
|
674
|
+
};
|
|
675
|
+
Object.defineProperty(resolver, TRANSACTIONAL_CORE_COMMIT_RECEIPT_READER, { value: true, enumerable: false });
|
|
676
|
+
return resolver;
|
|
677
|
+
}
|
|
678
|
+
|
|
679
|
+
/** The stored row is the one this attempt CREATED: it carries the id the attempt's write produced. */
|
|
680
|
+
export function carriesAttemptCreatedRow(stored: TransactionalCoreCommitReadBackRow, prepared: TransactionalCoreCommitReadBackRow): boolean {
|
|
681
|
+
return stored._id !== undefined && stored._id !== null && String(stored._id) === String(prepared._id);
|
|
682
|
+
}
|
|
683
|
+
|
|
684
|
+
/**
|
|
685
|
+
* The stored row carries this attempt's UPDATE: the same row, with the `updatedAt` the attempt's write stamped. Both
|
|
686
|
+
* adapters stamp `updatedAt` on every update (mongoose `timestamps`, the PostgreSQL repository for parity), so a row whose
|
|
687
|
+
* commit did not land still carries the previous stamp.
|
|
688
|
+
*/
|
|
689
|
+
export function carriesAttemptUpdateStamp(stored: TransactionalCoreCommitReadBackRow, prepared: TransactionalCoreCommitReadBackRow): boolean {
|
|
690
|
+
return carriesAttemptCreatedRow(stored, prepared) && isSameStoredInstant(stored.updatedAt, prepared.updatedAt);
|
|
691
|
+
}
|
|
692
|
+
```
|
|
693
|
+
|
|
694
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
695
|
+
|
|
696
|
+
```typescript
|
|
697
|
+
/**
|
|
698
|
+
* Whether two stored instants are the same instant: a `Date`, an ISO string or epoch milliseconds on either side (an
|
|
699
|
+
* adapter answers a `Date`; a row read through another door may carry its string form). Absent on either side is never
|
|
700
|
+
* the same instant, so a row that lacks the attempt's stamp is never taken for the attempt's write.
|
|
701
|
+
*/
|
|
702
|
+
export function isSameStoredInstant(left: unknown, right: unknown): boolean {
|
|
703
|
+
const millisecondsOf = (value: unknown): number | undefined => {
|
|
704
|
+
if (value instanceof Date) return Number.isNaN(value.getTime()) ? undefined : value.getTime();
|
|
705
|
+
if (typeof value === 'string' || typeof value === 'number') {
|
|
706
|
+
const parsed = new Date(value).getTime();
|
|
707
|
+
return Number.isNaN(parsed) ? undefined : parsed;
|
|
708
|
+
}
|
|
709
|
+
return undefined;
|
|
710
|
+
};
|
|
711
|
+
const leftMs = millisecondsOf(left);
|
|
712
|
+
const rightMs = millisecondsOf(right);
|
|
713
|
+
return leftMs !== undefined && rightMs !== undefined && leftMs === rightMs;
|
|
714
|
+
}
|
|
715
|
+
```
|
|
@@ -0,0 +1,191 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: blueprint-authoring
|
|
3
|
+
description: Define a blueprint from this application, export it with `wildo blueprint pack` or publish it with `wildo blueprint publish`, and start new applications from one with `wildo init --blueprint`. A blueprint is a reusable layer on the `wildo init` base, holding an organization's predefined modules, configuration, roles, design and guide. Use when the user says "make this app a blueprint", "export our internal-tool setup", "package these modules for other apps", "start a new app from our corporate blueprint", "what does wildo blueprint pack leave behind", or "why does the pack say it does not reproduce the application". NOT for installing one module from the registry (`module-registration`) or scaffolding a module (`resource-add-module`).
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Blueprint Authoring — Define, Pack, Apply
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
A blueprint is a LAYER UPON the `wildo init` base, never a replacement of it. It can:
|
|
24
|
+
- lock or default the database;
|
|
25
|
+
- add new files;
|
|
26
|
+
- bring modules with their registration;
|
|
27
|
+
- set the values the base DECLARES (organization types, capabilities, roles, feature profiles, design system, sidebar order);
|
|
28
|
+
- append barrel exports;
|
|
29
|
+
- add runtime dependencies;
|
|
30
|
+
- write text into the agent-guide slot.
|
|
31
|
+
|
|
32
|
+
It never overwrites a base file.
|
|
33
|
+
|
|
34
|
+
You define a blueprint in the application that already works the way you want: a definition SELECTS what belongs to it, and `wildo blueprint pack` reads every byte and value from the application. The pack then PROVES the export: the blueprint is applied onto the base this application was scaffolded as, and it must reproduce the application exactly, or nothing is packed.
|
|
35
|
+
|
|
36
|
+
## App Paths
|
|
37
|
+
|
|
38
|
+
| Surface | Path | Contract |
|
|
39
|
+
|---|---|---|
|
|
40
|
+
| Definition | `blueprints/<name>/blueprint.definition.ts` | `export const blueprintDefinition = { … } satisfies BlueprintDefinitionInput;`, read as data and never executed. The folder is the name half of its id |
|
|
41
|
+
| Parameter templates | `blueprints/<name>/templates/<path>.hbs` | A carried file whose text depends on a parameter |
|
|
42
|
+
| Declaration files | `wildo.saas.config.ts`, `backend-api/src/{saas-config.backend,bootstrap-config}.ts`, `shared-lib/src/engine/{roles,features,milestones,product}.ts`, `frontend/src/modules/index.ts`, `frontend/src/config/*.config.ts` | The values a blueprint may set. The full list is `BlueprintDeclarationFile` |
|
|
43
|
+
| Agent-guide slot | `CLAUDE.md`, between the `application.guide` slot markers | The only free text a blueprint writes |
|
|
44
|
+
| Scaffold record | `.wildo-saas/wildo-saas.lock.json`, section `scaffold` | The database and blueprint layers the application was created with |
|
|
45
|
+
|
|
46
|
+
## When to Use
|
|
47
|
+
|
|
48
|
+
- Turn a working application, or part of it, into a starting point for others.
|
|
49
|
+
- Stack a second blueprint on one this application was created from.
|
|
50
|
+
- Start a new application from one or more packed blueprints.
|
|
51
|
+
|
|
52
|
+
## When NOT to Use
|
|
53
|
+
|
|
54
|
+
- Add one published module to an existing application: use `module-registration`.
|
|
55
|
+
- Scaffold an empty module: use `resource-add-module` (`wildo compose add-module`).
|
|
56
|
+
- Change one application's configuration: use `config-saas`. A blueprint is for what several applications share.
|
|
57
|
+
|
|
58
|
+
## Workflow
|
|
59
|
+
|
|
60
|
+
1. **Classify each thing to carry.** Use `references/blueprint-content-kinds.md`.
|
|
61
|
+
- Your own code goes in NEW files or modules.
|
|
62
|
+
- A value the base declares is a declaration.
|
|
63
|
+
- A changed line inside a base file that is not a declaration CANNOT be carried. Move it into a new file and set or import it from there.
|
|
64
|
+
2. **Write the definition.** Its shape is in `references/framework-blueprint-definition-api.md`.
|
|
65
|
+
- Select files, modules, declarations, barrels, dependencies and slots.
|
|
66
|
+
- A module installed from the registry is selected by module id in `include.registryModules`: the blueprint carries a reference and `wildo init` installs it from the registry, so it stays an ordinary registry install in the new application.
|
|
67
|
+
- `include.line: true` carries this application's line (its answer to the line question). The new application starts with that question answered.
|
|
68
|
+
- Declare each parameter with this application's own value as `appValue`; it is the witness the pack renders templates with.
|
|
69
|
+
3. **Run `wildo blueprint status <name>`.** It is a dry pack.
|
|
70
|
+
- Read every `·` notice, such as a selected value equal to the base's or a barrel line naming a file you do not carry.
|
|
71
|
+
- Read the "not carried" report: it lists what the application holds that the blueprint will not bring.
|
|
72
|
+
- A notice that the slug sits inside a longer word means an apply renames that word too. Rename it, or accept it knowingly.
|
|
73
|
+
4. **Fix what does not reproduce, at its root.**
|
|
74
|
+
- A refusal names the difference.
|
|
75
|
+
- A local declaration inside a base file must move to a carried file.
|
|
76
|
+
- A template must render this application's bytes.
|
|
77
|
+
5. **Pack or publish.**
|
|
78
|
+
- `wildo blueprint pack <name> --out <dir>` writes a directory (`--layer <dir>` for a lower blueprint not defined here).
|
|
79
|
+
- `wildo blueprint publish <name>` publishes it to the module registry like a module (`--domain`, `--tag`). Bump the definition's `version` for each publish: a version is immutable.
|
|
80
|
+
6. **Apply** in an empty directory: `wildo init --blueprint <lower> <upper> --blueprint-param name=value`.
|
|
81
|
+
- Each entry is a packed directory, a blueprint the framework ships (`wildo/b2b-saas`, `wildo/internal-tool`, `wildo/service-firm`: one per application line, holding the line and the posture that line gives an application), or a registry blueprint, `<domain>/<scope>/<name>@<range>`. `--blueprint-registry` picks the registry for the blueprints AND for every registry module they reference: a reference records no registry, because a registry alias is local to a machine.
|
|
82
|
+
- With no `--blueprint`, `wildo init` asks the kind of application (`--line b2b_saas | internal_tool | service_firm | later`) and layers `wildo/<line>`; `--line` with blueprints must match the line they make.
|
|
83
|
+
- Every layer is rehearsed on a throwaway base first, so a refusal leaves the directory untouched.
|
|
84
|
+
- The base, each layer and the remaining init outputs are separate commits.
|
|
85
|
+
- A locked `--database` refuses a contradicting flag before anything is written.
|
|
86
|
+
- `wildo registry add` refuses a blueprint: it starts an application and is never installed into one.
|
|
87
|
+
7. **Hand off:** run `wildo config sync`, which derives what the configuration implies (for example the systems-of-record library), then install and build as usual.
|
|
88
|
+
- A generated module the blueprint carries (for example `backend-api/src/subject-data-recipients.generated.ts`) is the defining application's output: regenerate it in the new application (`wildo config subject-data-recipients`) once its own providers and register are set.
|
|
89
|
+
|
|
90
|
+
## Worked Example
|
|
91
|
+
|
|
92
|
+
This is Wonder Procurement's real internal-tool definition, which packs and reproduces its application:
|
|
93
|
+
- it is layered on the framework's `wildo/internal-tool` (`extends`), which answers the line question, marks the base's single organization type as the owner, and turns ORGANIZATIONS on;
|
|
94
|
+
- it replaces both with the group's own (its organization type, and its ORGANIZATIONS entry), so it names `organizationTypes` and `engineCapabilities.EngineCapability.ORGANIZATIONS` in `overrides`, and carries the line it shares (`include.line`). Any value a lower blueprint sets that you set too must be named there, or the pack and the apply refuse;
|
|
95
|
+
- PostgreSQL is locked;
|
|
96
|
+
- the posture is set through declarations: one owner organization type, the backend's user types, the roles and features;
|
|
97
|
+
- the role's enum travels in its own file, not inside the base `roles.ts`.
|
|
98
|
+
|
|
99
|
+
|
|
100
|
+
## Usage Example
|
|
101
|
+
|
|
102
|
+
```typescript
|
|
103
|
+
export const blueprintDefinition = {
|
|
104
|
+
id: 'wonder/internal-tool',
|
|
105
|
+
version: '0.1.0',
|
|
106
|
+
description: 'Corporate internal-tool posture: one owner organization, invitation and directory sign-in, no billing or marketing, PostgreSQL.',
|
|
107
|
+
extends: [{ id: 'wildo/internal-tool', range: '^1.0.0' }],
|
|
108
|
+
init: [{ flag: InitFlag.DATABASE, mode: BlueprintInitConstraintMode.LOCK }],
|
|
109
|
+
include: {
|
|
110
|
+
line: true,
|
|
111
|
+
files: ['shared-lib/src/engine/group-roles.ts'],
|
|
112
|
+
barrelExports: ['shared-lib/src/index.ts'],
|
|
113
|
+
declarations: [
|
|
114
|
+
{ file: 'wildo.saas.config.ts', path: ['organizationTypes'] },
|
|
115
|
+
{ file: 'wildo.saas.config.ts', path: ['bootstrap', 'firstAdmin', 'userTypes'] },
|
|
116
|
+
{ file: 'wildo.saas.config.ts', path: ['engineCapabilities', 'EngineCapability.ORGANIZATIONS'] },
|
|
117
|
+
{ file: 'wildo.saas.config.ts', path: ['engineCapabilities', 'EngineCapability.BILLING'] },
|
|
118
|
+
{ file: 'wildo.saas.config.ts', path: ['engineCapabilities', 'EngineCapability.EMAIL_MARKETING'] },
|
|
119
|
+
{ file: 'wildo.saas.config.ts', path: ['engineCapabilities', 'EngineCapability.EMAIL_TRANSACTIONAL'] },
|
|
120
|
+
{ file: 'backend-api/src/saas-config.backend.ts', path: ['userTypes'] },
|
|
121
|
+
// Which user type the application's frontend registers and signs in: without it the base's `member` stays, and
|
|
122
|
+
// nobody can sign in once `employee` is the only user type.
|
|
123
|
+
{ file: 'backend-api/src/saas-config.backend.ts', path: ['frontendServices'] },
|
|
124
|
+
// The non-sending dev email provider, so invitations and password resets work with no live key, and its posture.
|
|
125
|
+
{ file: 'wildo.saas.config.ts', path: ['providers', 'scopes', 'backend'] },
|
|
126
|
+
{ file: 'wildo.saas.config.ts', path: ['providerComplianceChoices'] },
|
|
127
|
+
// The finance controller the owner organization type offers, and the identity features every member holds.
|
|
128
|
+
{ file: 'shared-lib/src/engine/roles.ts', declaration: 'CUSTOM_ROLES_CONFIGURATION', path: [] },
|
|
129
|
+
{ file: 'shared-lib/src/engine/features.ts', declaration: 'FEATURE_PROFILES', path: [] },
|
|
130
|
+
],
|
|
131
|
+
},
|
|
132
|
+
// The group's organization type replaces the base type `wildo/internal-tool` marked as the owner, the group's
|
|
133
|
+
// ORGANIZATIONS entry replaces the `enabled: true` it set, and the group's user types replace the base `member` whose
|
|
134
|
+
// registration it closed to invitations (#3037): `employee` is invitation-only too.
|
|
135
|
+
overrides: {
|
|
136
|
+
declarations: [
|
|
137
|
+
{ file: 'wildo.saas.config.ts', path: ['organizationTypes'] },
|
|
138
|
+
{ file: 'wildo.saas.config.ts', path: ['engineCapabilities', 'EngineCapability.ORGANIZATIONS'] },
|
|
139
|
+
{ file: 'backend-api/src/saas-config.backend.ts', path: ['userTypes'] },
|
|
140
|
+
],
|
|
141
|
+
},
|
|
142
|
+
} satisfies BlueprintDefinitionInput;
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
## References
|
|
146
|
+
|
|
147
|
+
- `references/framework-blueprint-definition-api.md`: the definition and its vocabularies (source-backed).
|
|
148
|
+
- `references/blueprint-content-kinds.md`: which content kind carries what, and what cannot be carried.
|
|
149
|
+
|
|
150
|
+
## Verification
|
|
151
|
+
|
|
152
|
+
- [ ] `wildo blueprint status <name>` exits 0: the export reproduces this application.
|
|
153
|
+
- [ ] No local declaration was added to a base declaration file. Your own code lives in new files.
|
|
154
|
+
- [ ] Every `include.files` path is new to the base. A base file is never selected.
|
|
155
|
+
- [ ] The packed `blueprint.json` carries no `appValue`, no secret and nothing under `blueprints/`.
|
|
156
|
+
|
|
157
|
+
### Grep invariants
|
|
158
|
+
|
|
159
|
+
```bash
|
|
160
|
+
# The dry pack reproduces the application
|
|
161
|
+
wildo blueprint status <name>
|
|
162
|
+
# A local enum or const added inside a base declaration file (move it to a new file)
|
|
163
|
+
rg -n '^export (enum|const) ' shared-lib/src/engine/roles.ts shared-lib/src/engine/features.ts
|
|
164
|
+
# A packed manifest that leaked a witness value
|
|
165
|
+
rg -n 'appValue' <out>/blueprint.json
|
|
166
|
+
# Nothing under blueprints/ was packed
|
|
167
|
+
find <out>/files -path '*blueprints*'
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
## Common Rationalizations
|
|
171
|
+
|
|
172
|
+
| Rationalization | Reality |
|
|
173
|
+
|---|---|
|
|
174
|
+
| "I'll select the whole base file; it's easier." | A base file is refused. The base belongs to the framework and moves with it, and a blueprint that replaced it would freeze one version for every application. Set the declaration instead. |
|
|
175
|
+
| "The enum can stay in `roles.ts`; the pack will copy it." | A declaration's value is carried, not the code beside it. A name declared locally in a base file refuses. Move the enum to a carried file. |
|
|
176
|
+
| "I'll type the value into the definition." | The definition only selects. Values are read from the application and proven, so a typed value could never be wrong silently. Use a parameter and a template when the value varies. |
|
|
177
|
+
| "The 'not carried' list is noise." | It is the list of what the blueprint leaves behind. Each entry is either application-specific (fine) or something your blueprint needed and does not bring. |
|
|
178
|
+
| "I'll override the lower layer's value quietly." | An upper layer replacing a lower layer's file, lock or declaration must name it in `overrides`. Otherwise the apply refuses. |
|
|
179
|
+
|
|
180
|
+
## Red Flags
|
|
181
|
+
|
|
182
|
+
- `status` reports a changed base file you meant to carry. Move the change into a declaration or a new file, and re-run the dry pack (Verification grep 1).
|
|
183
|
+
- A new `export enum` or `export const` sits in `roles.ts` or `features.ts`. Catch it with grep 2.
|
|
184
|
+
- `appValue` appears in a packed manifest. That means a hand-edited manifest; pack again (grep 3).
|
|
185
|
+
- A `blueprints/` path appears in the packed files. A forged artifact; never apply it (grep 4).
|
|
186
|
+
|
|
187
|
+
## Related Skills
|
|
188
|
+
|
|
189
|
+
- `resource-add-module`: scaffold the modules a blueprint then carries.
|
|
190
|
+
- `module-registration`: what a carried module's registration writes into the registries.
|
|
191
|
+
- `config-saas`, `config-saas-backend`, `config-design-system`, `application-roles-authoring`: the values a declaration operation sets.
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Which content kind carries what
|
|
2
|
+
|
|
3
|
+
A blueprint never replaces a base file. Each thing you want to carry falls into exactly one row below. If none fits, the change cannot be carried as it is written: move it into a shape that fits.
|
|
4
|
+
|
|
5
|
+
| What you changed in the application | Content kind | Definition field |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| A new file (specification, asset, document, helper, enum) | file | `include.files` (globs) |
|
|
8
|
+
| A domain module, minion or worker | module, with its registration (the same edits `wildo compose add-module` and a registry install write) | `include.modules`, `include.minions`, `include.workers` |
|
|
9
|
+
| A module you installed from the module registry (`wildo registry add`) | registry module REFERENCE: never copied; `wildo init` installs it from the registry, at the range you asked for, before the layer's own files | `include.registryModules` (module ids, e.g. `acme/billing`) |
|
|
10
|
+
| The database the application runs on | init flag (`lock` or `default`) | `init` |
|
|
11
|
+
| The kind of application it is: its application line (B2B SaaS, internal tool, service firm), as the application answered the line question | the line: `wildo init` records it as the new application's answer, so the question is not asked again. Read from this application's answer; the pack refuses when it has none. A stack names at most one line | `include.line: true` |
|
|
12
|
+
| A value the base declares: organization types, capabilities, user types, roles, feature profiles, unit narrowing, own rows, the frontend module order, the design system, navigation, the app shell | declaration operation: the value is SET, with the imports it needs | `include.declarations` (`file`, optional `declaration`, `path`) |
|
|
13
|
+
| An `export … from` line a carried file needs in `shared-lib/src/index.ts` or `specifications/src/index.ts` | barrel export (derived: lines naming a file you do not carry are skipped and reported) | `include.barrelExports` |
|
|
14
|
+
| A runtime dependency in a workspace `package.json` | dependency (by name; the specifier is read from each manifest that declares it) | `include.dependencies` |
|
|
15
|
+
| What this application is and how it is organised, in `CLAUDE.md` | slot contribution in `application.guide` | `include.slots` |
|
|
16
|
+
|
|
17
|
+
## What cannot be carried, and what to do instead
|
|
18
|
+
|
|
19
|
+
| You did this | Instead |
|
|
20
|
+
|---|---|
|
|
21
|
+
| Declared an enum, a constant or a function INSIDE a base declaration file | Move it to a new file and import it. The base file keeps only the declaration's value. |
|
|
22
|
+
| Edited a base file outside any declaration: a comment, a script, the dev configuration | Leave it application-specific. The pack lists it under "not carried". |
|
|
23
|
+
| Added a dependency the framework derives (for example the systems-of-record library, derived from `systemsOfRecord`) | Do not select it. `wildo config sync` declares it in every application whose configuration implies it. |
|
|
24
|
+
| Selected a registry module's files with `include.files` or `include.modules` | The pack refuses: a copy would carry the files without the lockfile record that `wildo registry update` and `remove` act on. Name the module in `include.registryModules`. |
|
|
25
|
+
| Hard-coded a value that differs per application | Declare a parameter. The value goes in a template (`templates/<path>.hbs`) or in a declaration's `valueTemplate`. The parameter's `appValue` is this application's value. |
|
|
26
|
+
|
|
27
|
+
## Stacking
|
|
28
|
+
|
|
29
|
+
A blueprint may be layered on others (`extends`). Start from the one the framework ships for your line, `wildo/b2b-saas`, `wildo/internal-tool` or `wildo/service-firm` (`extends: [{ id: 'wildo/internal-tool', range: '^1.0.0' }]`): it answers the line question for every application made from yours, and carries the line's posture (an internal tool: an organization type that owns the application, ORGANIZATIONS on; a service firm: a `firm` type that owns it, a `client` type created at registration, and the `service` relationship between them). `wildo blueprint pack` finds it by id; no `--layer` is needed. Its definition is packed against the base PLUS those layers, so it exports only what it adds. Replacing anything a lower layer wrote (a file, a locked init flag, a declaration) must be named in `overrides`, or the pack and the apply refuse. Nothing of the base can ever be overridden.
|