@wildo-ai/framework-knowledge 1.1.11 → 1.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +170 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +27 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -88,6 +88,18 @@
|
|
|
88
88
|
return result;
|
|
89
89
|
}
|
|
90
90
|
|
|
91
|
+
/**
|
|
92
|
+
* Whether a system READ or LIST of `resourceType` handed `options` runs in the caller's transaction (#3091): it does
|
|
93
|
+
* exactly when the resource lives on that transaction's database, since the services registry's reads drop another
|
|
94
|
+
* database's transaction (`readOptionsOnItsOwnDatabase`). A caller that catches a failed system read asks this to apply
|
|
95
|
+
* THE rule for a caught read failure (`readFailureEndsTheOperation`).
|
|
96
|
+
*/
|
|
97
|
+
public readSharesTheCallersTransaction(resourceType: ResourceType, options?: ServiceOptions): boolean {
|
|
98
|
+
if (options?.transaction === undefined) return false;
|
|
99
|
+
const repositoriesRegistry = this.container.get<RepositoriesRegistryHandlerBackendService>(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService);
|
|
100
|
+
return readOptionsOnItsOwnDatabase(repositoriesRegistry, resourceType, options)?.transaction !== undefined;
|
|
101
|
+
}
|
|
102
|
+
|
|
91
103
|
/**
|
|
92
104
|
* List resources using a synthesised INTERNALLY_INITIATED_REQUEST execution
|
|
93
105
|
* context with system-level admin roles. The cross-scope sibling of
|
|
@@ -100,7 +112,8 @@
|
|
|
100
112
|
public async listAsSystem<T = any>(
|
|
101
113
|
resourceType: ResourceType,
|
|
102
114
|
filter?: FilterQuery<any>,
|
|
103
|
-
|
|
115
|
+
/** Page, limit and an optional `sort` (`{ field: 1 | -1 }`), validated against the LIST variant's `sortFields`. */
|
|
116
|
+
pagination?: Partial<Resources_PaginationRequest> & { sort?: Record<string, 1 | -1> },
|
|
104
117
|
options?: ServiceOptions & {
|
|
105
118
|
scopeContext?: { organizationId?: string; applicationId?: string; userId?: string };
|
|
106
119
|
/** Skip the `SYSTEM_CONTEXT_READ` audit for a self-referential internal routing read — see {@link readAsSystem}. */
|
|
@@ -574,6 +587,73 @@
|
|
|
574
587
|
return result;
|
|
575
588
|
}
|
|
576
589
|
|
|
590
|
+
/**
|
|
591
|
+
* Record the CLOSURE of a record an erasure has RESTRICTED (#1841): write the `CLOSURE_EVENT` binding's closure date on
|
|
592
|
+
* one RETAINED row, only where it is still null. The owning resource's close operation calls it when the record it
|
|
593
|
+
* closes is retained, so a period counted from the end of a contract or a matter starts when the matter really ends,
|
|
594
|
+
* and the retention-class sweep deletes the row at closure + period. Without it such a record would be hidden from the
|
|
595
|
+
* close operation (a retained row reads as absent) and would stay open, and therefore kept, forever.
|
|
596
|
+
*
|
|
597
|
+
* ## What makes it narrow
|
|
598
|
+
*
|
|
599
|
+
* - **Declared, or refused.** The resource must bind `RetentionStartPoint.CLOSURE_EVENT` AND name the closure field in
|
|
600
|
+
* `retentionPolicy.retainedRowCompletion.fields`; anything else is a CONFIGURATION refusal before any read.
|
|
601
|
+
* - **One field, written once.** It writes nothing but the closure field, and only where that field is null, so an
|
|
602
|
+
* established closure date is never moved and no retention clock is ever extended. A second call is a no-op.
|
|
603
|
+
* - **Retained rows only.** It goes through `completeRetainedRowForInfrastructure`, which narrows the filter to
|
|
604
|
+
* RETAINED rows and refuses any field the declaration does not name. A LIVE record is the owning handlers' to close
|
|
605
|
+
* through their ordinary write; this door answers `false` for it.
|
|
606
|
+
* - **Discloses nothing.** It returns only whether a retained open record with that id was closed; the row itself
|
|
607
|
+
* never leaves this method. When `scopeContext.organizationId` is given, the row must belong to that organization.
|
|
608
|
+
*
|
|
609
|
+
* Audited as a system-context write (`SYSTEM_CONTEXT_WRITE`, best-effort like every trusted write here).
|
|
610
|
+
*
|
|
611
|
+
* assurance-control: WILDO.PRIVACY.STORAGE_LIMITATION — a statutory record restricted while still open starts its
|
|
612
|
+
* retention period when it closes, so it is deleted when that period ends rather than kept forever.
|
|
613
|
+
*
|
|
614
|
+
* @returns `true` when the closure was recorded; `false` when no RETAINED row with that id is still open.
|
|
615
|
+
*/
|
|
616
|
+
public async closeRetainedRecordAsSystem(
|
|
617
|
+
resourceType: ResourceType,
|
|
618
|
+
rowId: string,
|
|
619
|
+
closedAt: Date,
|
|
620
|
+
options?: ServiceOptions & {
|
|
621
|
+
scopeContext?: { organizationId?: string; applicationId?: string; userId?: string };
|
|
622
|
+
},
|
|
623
|
+
): Promise<boolean> {
|
|
624
|
+
const configuration = this.resourcesRegistry.getResourceConfiguration(resourceType);
|
|
625
|
+
const binding = configuration?.retentionBinding;
|
|
626
|
+
const closureFieldName = binding?.startPoint === RetentionStartPoint.CLOSURE_EVENT ? binding.closureFieldName : undefined;
|
|
627
|
+
if (!closureFieldName || !(configuration?.retentionPolicy?.retainedRowCompletion?.fields ?? []).includes(closureFieldName)) {
|
|
628
|
+
throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
|
|
629
|
+
context: {
|
|
630
|
+
reason: 'retained_record_closure_undeclared',
|
|
631
|
+
resourceType,
|
|
632
|
+
message: `'${String(resourceType)}' cannot close a retained record: it must bind retentionBinding.startPoint CLOSURE_EVENT `
|
|
633
|
+
+ 'and name that closure field in retentionPolicy.retainedRowCompletion.fields.',
|
|
634
|
+
},
|
|
635
|
+
});
|
|
636
|
+
}
|
|
637
|
+
if (typeof rowId !== 'string' || rowId.trim().length === 0 || !(closedAt instanceof Date) || Number.isNaN(closedAt.getTime())) {
|
|
638
|
+
throw this.errorBuilder.buildError(ErrorType.VALIDATION, undefined, {
|
|
639
|
+
context: { reason: 'retained_record_closure_invalid', resourceType, message: 'closeRetainedRecordAsSystem needs a row id and a valid closure date.' },
|
|
640
|
+
});
|
|
641
|
+
}
|
|
642
|
+
const organizationId = options?.scopeContext?.organizationId;
|
|
643
|
+
const repositoriesRegistry = this.container.get<RepositoriesRegistryHandlerBackendService>(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService);
|
|
644
|
+
const closed = await repositoriesRegistry.completeRetainedRowForInfrastructure(
|
|
645
|
+
resourceType,
|
|
646
|
+
// `null` matches an absent field on both adapters: the closure is recorded once, never moved.
|
|
647
|
+
{ _id: rowId, [closureFieldName]: null, ...(organizationId ? { organizationId } : {}) },
|
|
648
|
+
{ set: { [closureFieldName]: closedAt } },
|
|
649
|
+
undefined,
|
|
650
|
+
options?.transaction ? { transaction: options.transaction } : undefined,
|
|
651
|
+
);
|
|
652
|
+
if (closed === null) return false;
|
|
653
|
+
this.scheduleSystemContextWriteAudit(resourceType, CoreResourceOperation.UPDATE, options);
|
|
654
|
+
return true;
|
|
655
|
+
}
|
|
656
|
+
|
|
577
657
|
/**
|
|
578
658
|
* DIRECT subject erasure — impersonalize-and-retain the named rows of a retention-governed resource.
|
|
579
659
|
*
|
|
@@ -781,8 +861,13 @@
|
|
|
781
861
|
* @param resourceType the subject's resource type.
|
|
782
862
|
* @param id_or_ids the explicit subject rows. An export is not a query.
|
|
783
863
|
* @param purpose WHICH right is being answered — the two produce genuinely different bundles.
|
|
864
|
+
* @param options.fileContents PORTABILITY only (#3561): `maxTotalBytes` bounds the bytes of the person's own files the
|
|
865
|
+
* bundle carries (default 2 GiB, at most 3 GiB); a file past the bound stays in the rows and is reported
|
|
866
|
+
* `OVER_SIZE_LIMIT` rather than refusing the export. `writeSubjectExportArchive` turns the bundle into one zip.
|
|
867
|
+
* @param options.dataSubjectRequestId #2296: the data-subject request this export is delivered for, recorded on the
|
|
868
|
+
* `SUBJECT_DATA_EXPORT` audit row so the disclosure joins the request that records who asked and when.
|
|
784
869
|
* @returns the {@link SubjectExportBundle}. Only `bundle.report` is safe to log; `bundle.slices`
|
|
785
|
-
* carry the personal data itself.
|
|
870
|
+
* carry the personal data itself, and `bundle.fileContents` opens the person's files.
|
|
786
871
|
*/
|
|
787
872
|
public async exportSubjectAsSystem(
|
|
788
873
|
resourceType: ResourceType,
|
|
@@ -790,6 +875,8 @@
|
|
|
790
875
|
purpose: SubjectExportPurpose,
|
|
791
876
|
options?: ServiceOptions & {
|
|
792
877
|
scopeContext?: { organizationId?: string; applicationId?: string; userId?: string };
|
|
878
|
+
fileContents?: { maxTotalBytes?: number };
|
|
879
|
+
dataSubjectRequestId?: string;
|
|
793
880
|
},
|
|
794
881
|
): Promise<SubjectExportBundle> {
|
|
795
882
|
// Guard 1 (fail-closed): the subject's own resource must permit system READ — the verb every
|
|
@@ -834,6 +921,11 @@
|
|
|
834
921
|
.getService(resourceType)
|
|
835
922
|
.exportSubjectInPlace(resourceType, subjectIds, purpose, systemContext, options);
|
|
836
923
|
|
|
924
|
+
// ── The bytes of the person's own files (Art. 20, #3561) ──
|
|
925
|
+
if (purpose === SubjectExportRight.PORTABILITY_ART_20) {
|
|
926
|
+
await this.attachSubjectFileContents(bundle, subjectIds, options?.fileContents?.maxTotalBytes);
|
|
927
|
+
}
|
|
928
|
+
|
|
837
929
|
// ── Who else holds this data (Art. 15(1)(c), #1710) ──
|
|
838
930
|
// Selected for the resources this export actually read, from the application's derived declaration. Vendor facts
|
|
839
931
|
// only, so the report stays safe to log.
|
|
@@ -880,11 +972,57 @@
|
|
|
880
972
|
organizationId: options?.scopeContext?.organizationId,
|
|
881
973
|
recipientsStatus: bundle.report.recipients.status,
|
|
882
974
|
recipientRefs: bundle.report.recipients.recipients.map((recipient) => recipient.ref).sort(),
|
|
975
|
+
// #3561: counts only, never a file's name or bytes. Absent on an access export.
|
|
976
|
+
...(bundle.report.fileContentsExcluded !== undefined ? {
|
|
977
|
+
fileContentCount: bundle.fileContents?.length ?? 0,
|
|
978
|
+
fileContentBytes: (bundle.fileContents ?? []).reduce((total, part) => total + part.size, 0),
|
|
979
|
+
fileContentsExcludedCount: bundle.report.fileContentsExcluded.length,
|
|
980
|
+
} : {}),
|
|
981
|
+
...(options?.dataSubjectRequestId ? { dataSubjectRequestId: options.dataSubjectRequestId } : {}),
|
|
883
982
|
});
|
|
884
983
|
|
|
885
984
|
return bundle;
|
|
886
985
|
}
|
|
887
986
|
|
|
987
|
+
/**
|
|
988
|
+
* Attach the bytes of the person's own files to a PORTABILITY bundle (#3561): the files the export carried as rows
|
|
989
|
+
* (owned AND uploaded by them, not derived), opened by the file service under the download gates. What it cannot carry
|
|
990
|
+
* joins `report.fileContentsExcluded` with the reason.
|
|
991
|
+
*
|
|
992
|
+
* Refuses, rather than hand over a bundle that silently lacks the bytes, when the runtime holds the person's files but
|
|
993
|
+
* not the file service (a minion), and when the bound is outside what an archive can carry.
|
|
994
|
+
*/
|
|
995
|
+
private async attachSubjectFileContents(bundle: SubjectExportBundle, subjectIds: string[], maxTotalBytes = SUBJECT_EXPORT_FILE_CONTENT_DEFAULT_MAX_BYTES): Promise<void> {
|
|
996
|
+
const fileIds = bundle.slices
|
|
997
|
+
.filter((slice) => slice.resourceType === CoreResourceType.FILES)
|
|
998
|
+
.flatMap((slice) => slice.rows.map((row) => String(row._id ?? row.fileId)));
|
|
999
|
+
if (fileIds.length === 0) return;
|
|
1000
|
+
if (!(maxTotalBytes > 0 && maxTotalBytes <= SUBJECT_EXPORT_FILE_CONTENT_MAX_BYTES_CEILING)) {
|
|
1001
|
+
throw this.errorBuilder.buildError(ErrorType.VALIDATION, undefined, {
|
|
1002
|
+
customMessageReference: ErrorCustomMessageReference.VALIDATION,
|
|
1003
|
+
context: {
|
|
1004
|
+
message: `A portability export's file bound must be between 1 byte and ${SUBJECT_EXPORT_FILE_CONTENT_MAX_BYTES_CEILING} bytes `
|
|
1005
|
+
+ '(a ZIP without ZIP64 addresses 4 GiB, and the archive also holds the rows)',
|
|
1006
|
+
maxTotalBytes,
|
|
1007
|
+
},
|
|
1008
|
+
});
|
|
1009
|
+
}
|
|
1010
|
+
if (!this.container.isBound(SAAS_SERVICE_TYPES.FilesBackendService)) {
|
|
1011
|
+
throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
|
|
1012
|
+
context: {
|
|
1013
|
+
reason: 'subject_export_file_service_unavailable',
|
|
1014
|
+
message: 'A portability export carries the bytes of the person\'s own files, and this runtime binds no file service: '
|
|
1015
|
+
+ 'run the export where the application\'s files are served (its backend), not here',
|
|
1016
|
+
fileCount: fileIds.length,
|
|
1017
|
+
},
|
|
1018
|
+
});
|
|
1019
|
+
}
|
|
1020
|
+
const files = this.container.get<Pick<FilesBackendService, 'openFileContentsForSubjectPortability'>>(SAAS_SERVICE_TYPES.FilesBackendService);
|
|
1021
|
+
const { parts, excluded } = await files.openFileContentsForSubjectPortability(fileIds, subjectIds, { maxTotalBytes });
|
|
1022
|
+
if (parts.length > 0) bundle.fileContents = parts;
|
|
1023
|
+
bundle.report.fileContentsExcluded = [...(bundle.report.fileContentsExcluded ?? []), ...excluded];
|
|
1024
|
+
}
|
|
1025
|
+
|
|
888
1026
|
public async eraseSubjectAsSystem(
|
|
889
1027
|
resourceType: ResourceType,
|
|
890
1028
|
id_or_ids: string | string[],
|
|
@@ -967,6 +1105,7 @@
|
|
|
967
1105
|
heldByLegalHold: [],
|
|
968
1106
|
strandedRestrictedDependents: [],
|
|
969
1107
|
severedReferences: [],
|
|
1108
|
+
unconfirmedSeveredReferences: [],
|
|
970
1109
|
// The recipients are stated; no outcome is, because nothing was erased and no recipient was asked to erase.
|
|
971
1110
|
recipients: { statement: this.subjectDataRecipientsFor(resourceType, []), outcomes: [] },
|
|
972
1111
|
};
|
|
@@ -1185,14 +1324,30 @@
|
|
|
1185
1324
|
}
|
|
1186
1325
|
|
|
1187
1326
|
const incompleteEffects = selectIncompleteExternalEffects(report.externalEffects);
|
|
1188
|
-
|
|
1327
|
+
// Owed work (#3495, `SubjectErasureExternalEffectStatus.PENDING`) is incomplete and NOT an operator's: the engine's own
|
|
1328
|
+
// durable work finishes it, and raises its own ERROR if it is still owed after 24 hours. Logging it here at ERROR as well
|
|
1329
|
+
// would fire on every erasure that met a change in flight, for work nobody has to do, which is how an alert stops being read.
|
|
1330
|
+
const effectsNeedingOperator = incompleteEffects.filter((effect) => !isOwedSubjectErasureExternalEffect(effect.status));
|
|
1331
|
+
const owedEffects = incompleteEffects.filter((effect) => isOwedSubjectErasureExternalEffect(effect.status));
|
|
1332
|
+
if (owedEffects.length > 0) {
|
|
1333
|
+
this.logger?.info('Subject erasure completed LOCALLY; external effects are OWED and scheduled, and complete without operator action', {
|
|
1334
|
+
subjectResourceType: resourceType,
|
|
1335
|
+
subjectCount: subjectIds.length,
|
|
1336
|
+
owedEffects: owedEffects.map((effect) => ({
|
|
1337
|
+
effectRef: effect.effectRef,
|
|
1338
|
+
status: effect.status,
|
|
1339
|
+
owedSteps: (effect.steps ?? []).filter((step) => !step.succeeded).map((step) => ({ step: step.step, targetRef: step.targetRef })),
|
|
1340
|
+
})),
|
|
1341
|
+
});
|
|
1342
|
+
}
|
|
1343
|
+
if (effectsNeedingOperator.length > 0) {
|
|
1189
1344
|
// ERROR, not warn: personal data is potentially still live at a third party after a
|
|
1190
1345
|
// completed data-protection request. That is an operator obligation, not a footnote — and the
|
|
1191
1346
|
// report is returned to a caller who may only persist it, so the log has to stand alone.
|
|
1192
1347
|
this.logger?.error('Subject erasure completed LOCALLY but external effects are incomplete', {
|
|
1193
1348
|
subjectResourceType: resourceType,
|
|
1194
1349
|
subjectCount: subjectIds.length,
|
|
1195
|
-
incompleteEffects:
|
|
1350
|
+
incompleteEffects: effectsNeedingOperator.map((effect) => ({
|
|
1196
1351
|
effectRef: effect.effectRef,
|
|
1197
1352
|
status: effect.status,
|
|
1198
1353
|
detail: effect.detail,
|
|
@@ -28,10 +28,19 @@
|
|
|
28
28
|
* ## `reportOnly` is a posture, not a formality
|
|
29
29
|
*
|
|
30
30
|
* `reportOnly: true` emits the report-only header: the browser reports violations and BLOCKS
|
|
31
|
-
* NOTHING. Flipping it is one field.
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
31
|
+
* NOTHING. Flipping it is one field.
|
|
32
|
+
*
|
|
33
|
+
* ## Where violations are reported
|
|
34
|
+
*
|
|
35
|
+
* Every application backend serves a violation collector, and with nothing authored here the policy
|
|
36
|
+
* names it: `report-uri` (one request per violation) and `report-to` with a `Reporting-Endpoints`
|
|
37
|
+
* header (batched reports, the mechanism current browsers prefer). The collector counts each report
|
|
38
|
+
* by directive in the backend's metrics and logs a sample — it is observability, not an audit trail.
|
|
39
|
+
* Read those before flipping `reportOnly`: a report-only policy that reports nothing has not been
|
|
40
|
+
* shown to be safe to enforce.
|
|
41
|
+
*
|
|
42
|
+
* Author `reportUri` and/or `reportTo` only to send reports to a collector of your own. Either one
|
|
43
|
+
* replaces the platform collector on BOTH mechanisms, so name both when your collector accepts both.
|
|
35
44
|
*
|
|
36
45
|
* Nonces and hashes are not generated per request or at build time. A source list may name one by
|
|
37
46
|
* hand, but there is no generation, which is why a baseline that must admit inline script still does.
|
|
@@ -85,12 +94,20 @@ export const WildoCspConfigSchema = z.strictObject({
|
|
|
85
94
|
*/
|
|
86
95
|
directives: CspDirectivesOverrideSchema.default({}),
|
|
87
96
|
/**
|
|
88
|
-
*
|
|
89
|
-
*
|
|
90
|
-
*
|
|
91
|
-
* Reporting API endpoint config which the platform doesn't ship; add
|
|
92
|
-
* when the violation collector lands (#2867).
|
|
97
|
+
* Your own collector for the `report-uri` mechanism: one POST per violation, as
|
|
98
|
+
* `application/csp-report`. Header-only (the meta tag ignores it). Omit both this and
|
|
99
|
+
* `reportTo` to use the platform collector the application backend serves.
|
|
93
100
|
*/
|
|
94
101
|
reportUri: z.string().min(1).optional(),
|
|
102
|
+
/**
|
|
103
|
+
* Your own collector for the Reporting API mechanism: batched reports as
|
|
104
|
+
* `application/reports+json`, sent with CORS from the page's origin. The policy names it
|
|
105
|
+
* through `report-to` and a `Reporting-Endpoints` header. An absolute URL that browsers treat
|
|
106
|
+
* as trustworthy: `https://…`, or `http://localhost…` in development; any other URL is ignored
|
|
107
|
+
* by the browser. Omit both this and `reportUri` to use the platform collector.
|
|
108
|
+
*
|
|
109
|
+
* spec-cite: Reporting API (W3C Working Draft, 11 June 2025) §3.2 (an endpoint URL that is not potentially trustworthy is ignored) — https://www.w3.org/TR/reporting-1/
|
|
110
|
+
*/
|
|
111
|
+
reportTo: z.url().optional(),
|
|
95
112
|
});
|
|
96
113
|
```
|
|
@@ -35,7 +35,7 @@
|
|
|
35
35
|
* omitted for LAZY (factory auto-injects from `lazyAccess`).
|
|
36
36
|
* - `lazyAccess` — required for LAZY, FORBIDDEN otherwise.
|
|
37
37
|
* - `onOrphan` — required for SYNC, forbidden otherwise.
|
|
38
|
-
* - `existingRowTreatment` — ADDITIVE only. Declare `FILL_MISSING_DEFAULTS`
|
|
38
|
+
* - `existingRowTreatment` — ADDITIVE and LAZY only. Declare `FILL_MISSING_DEFAULTS`
|
|
39
39
|
* when the seed CREATES a row a person owns afterwards (a config
|
|
40
40
|
* singleton): the default re-applies the declared payload on every pass,
|
|
41
41
|
* which replaces whole stored blocks.
|
|
@@ -19,7 +19,10 @@
|
|
|
19
19
|
* materialization, per-scope idempotency cache. Cannot combine with
|
|
20
20
|
* `schedule?` (periodic re-run contradicts the contract). Write path
|
|
21
21
|
* bypasses the operation pipeline (no hook re-entry from the seed's
|
|
22
|
-
* own write).
|
|
22
|
+
* own write). "Never again" is per scope, by the run ledger, not by the
|
|
23
|
+
* row: the first pass writes like ADDITIVE, so a row ANOTHER seed already
|
|
24
|
+
* created there is re-stamped with the payload unless the seed declares
|
|
25
|
+
* `existingRowTreatment: FILL_MISSING_DEFAULTS` (#3383).
|
|
23
26
|
* - **`ADDITIVE`** — "insert if business key absent; on present rows,
|
|
24
27
|
* re-apply the entry's `data` payload via `upsertByBusinessKey`'s
|
|
25
28
|
* `$set` semantics (no managed-fields gating, no version comparison)".
|
|
@@ -51,7 +51,8 @@ export class DataSeedRowReference {
|
|
|
51
51
|
* @param businessKey The row's business key. Leave out the scope foreign key (`organizationId`, `userId`, …) when the
|
|
52
52
|
* target seed has the same scope kind as the referring seed: the engine fills it from the scope being seeded.
|
|
53
53
|
* @throws Error when `target` has no `seedKey`, when `businessKey` is not a plain object, or when a business-key value
|
|
54
|
-
* is `undefined
|
|
54
|
+
* is `undefined`. A business-key value may be another reference (a child keyed under its parent): it resolves first,
|
|
55
|
+
* and its seed must be in `dependsOn` too.
|
|
55
56
|
*
|
|
56
57
|
* @example
|
|
57
58
|
* ```ts
|
|
@@ -76,9 +77,6 @@ export function referenceDataSeedRow(
|
|
|
76
77
|
if (value === undefined) {
|
|
77
78
|
throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is undefined — a business key is identity; use null for a genuinely-nullable field.`);
|
|
78
79
|
}
|
|
79
|
-
if (containsDataSeedRowReference(value)) {
|
|
80
|
-
throw new Error(`referenceDataSeedRow: business-key field '${field}' of a reference to seed '${target.seedKey}' is itself a reference — a reference names its row by literal values.`);
|
|
81
|
-
}
|
|
82
80
|
}
|
|
83
81
|
return new DataSeedRowReference(
|
|
84
82
|
{
|
|
@@ -27,6 +27,12 @@ export interface BackendProviderResolutionRequest {
|
|
|
27
27
|
* package without publishing one; production passes nothing.
|
|
28
28
|
*/
|
|
29
29
|
readonly importModule?: (specifier: string) => Promise<unknown>;
|
|
30
|
+
/**
|
|
31
|
+
* The deployment environment a bound module's region answers are compared with (#3513): a deployment slot naming a
|
|
32
|
+
* different region for the application's own account than the one it declares refuses the provider. Overridable for a
|
|
33
|
+
* test; production passes nothing and `process.env` is read.
|
|
34
|
+
*/
|
|
35
|
+
readonly env?: Readonly<Record<string, string | undefined>>;
|
|
30
36
|
}
|
|
31
37
|
|
|
32
38
|
export interface BackendProviderResolution {
|
|
@@ -45,6 +45,8 @@
|
|
|
45
45
|
providerRuntime?: ProviderRuntimeArtifact,
|
|
46
46
|
unresolvedReasons?: ReadonlyMap<string, string>,
|
|
47
47
|
): void {
|
|
48
|
+
this.dataResidency = providerRuntime?.providerDataResidency;
|
|
49
|
+
this.processingRegions = providerRuntime?.providerProcessingRegions ?? {};
|
|
48
50
|
if (!providerRuntime) {
|
|
49
51
|
this.registry = registry;
|
|
50
52
|
return;
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# saas.frontend.chart-dashboard-view
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
/**
|
|
13
|
+
* A whole composite view that is a chart dashboard, declared as data — register it under the frontend domain module's
|
|
14
|
+
* `compositeViews` like any app-level composite. The rest of the config is the composite view's
|
|
15
|
+
* own (`sectionRefs`, `icon`, `requiredFeatures`, …).
|
|
16
|
+
*
|
|
17
|
+
* @example
|
|
18
|
+
* ```ts
|
|
19
|
+
* compositeViews: {
|
|
20
|
+
* 'operations-dashboard': defineChartDashboardView({
|
|
21
|
+
* tiles: [
|
|
22
|
+
* { resourceType: R.CASES, chartViewRef: casesByStatusChart.ref },
|
|
23
|
+
* { resourceType: R.INVOICES, chartViewRef: revenueByMonthChart.ref, span: ChartDashboardTileSpan.TWO },
|
|
24
|
+
* { resourceType: R.SLA_BREACHES, chartViewRef: breachesByTeamChart.ref },
|
|
25
|
+
* ],
|
|
26
|
+
* }),
|
|
27
|
+
* }
|
|
28
|
+
* ```
|
|
29
|
+
*/
|
|
30
|
+
export function defineChartDashboardView(
|
|
31
|
+
config: { tiles: readonly ChartDashboardTile[] } & Omit<CompositeViewAuthoringConfig, 'viewComponent'>,
|
|
32
|
+
): CompositeViewAuthoringConfig {
|
|
33
|
+
const { tiles, ...compositeConfig } = config;
|
|
34
|
+
function ChartDashboardView(): React.JSX.Element {
|
|
35
|
+
return (
|
|
36
|
+
<CompositeLayout>
|
|
37
|
+
<ChartDashboard tiles={tiles} />
|
|
38
|
+
</CompositeLayout>
|
|
39
|
+
);
|
|
40
|
+
}
|
|
41
|
+
return defineCompositeView(ChartDashboardView, compositeConfig);
|
|
42
|
+
}
|
|
43
|
+
```
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
# saas.frontend.chart-dashboard
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
/** How many grid columns a dashboard tile spans, where the dashboard is wide enough to have them. */
|
|
13
|
+
export enum ChartDashboardTileSpan {
|
|
14
|
+
/** One column (the default): a donut, a bar of a few categories. */
|
|
15
|
+
ONE = 'one',
|
|
16
|
+
/** Two columns: a trend over time, a bar of many categories. One column where the dashboard has one. */
|
|
17
|
+
TWO = 'two',
|
|
18
|
+
/** The whole row: a long timeline, a wide table-like chart. */
|
|
19
|
+
FULL = 'full',
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
/** How many grid rows a dashboard tile spans, where the dashboard has more than one column. */
|
|
23
|
+
export enum ChartDashboardTileRows {
|
|
24
|
+
/** One row (the default). */
|
|
25
|
+
ONE = 'one',
|
|
26
|
+
/**
|
|
27
|
+
* Two rows: a large chart beside two smaller ones stacked in the next column. Place it right after the first
|
|
28
|
+
* small tile, so the second small tile flows into the row beneath the first: `[small, large (TWO rows), small]`.
|
|
29
|
+
*/
|
|
30
|
+
TWO = 'two',
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* The most columns a dashboard's grid reaches, as its container widens. Every dashboard is one column in a narrow pane.
|
|
35
|
+
*/
|
|
36
|
+
export enum ChartDashboardColumns {
|
|
37
|
+
/** Two columns from a medium container (42rem). */
|
|
38
|
+
TWO = 'two',
|
|
39
|
+
/**
|
|
40
|
+
* Three narrow columns from a small container (28rem): small charts beside a large one, in a dashboard that shares
|
|
41
|
+
* its row with something else (a block of counters, a list).
|
|
42
|
+
*/
|
|
43
|
+
THREE = 'three',
|
|
44
|
+
/** Two columns from a medium container (42rem), four from a wide one (64rem). The default. */
|
|
45
|
+
FOUR = 'four',
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* One tile of a {@link ChartDashboard}: a chart a resource declares in its `chartViews`. A chart whose `chartType` is
|
|
50
|
+
* `ChartType.KPI` is a KPI tile: one figure under its title instead of a drawing.
|
|
51
|
+
*/
|
|
52
|
+
export interface ChartDashboardTile {
|
|
53
|
+
/** The resource whose `chartViews` declares the chart. */
|
|
54
|
+
resourceType: string;
|
|
55
|
+
/** The chart view's `ref` on that resource (`InsertedChartDeclaration.ref`, usually `<chartDefinition>.ref`). */
|
|
56
|
+
chartViewRef: string;
|
|
57
|
+
/** Grid columns the tile spans. Default: {@link ChartDashboardTileSpan.ONE}. */
|
|
58
|
+
span?: ChartDashboardTileSpan;
|
|
59
|
+
/** Grid rows the tile spans. Default: {@link ChartDashboardTileRows.ONE}. */
|
|
60
|
+
rows?: ChartDashboardTileRows;
|
|
61
|
+
/**
|
|
62
|
+
* Chart canvas height in px (the canvas is sized by this, not by the tile). Default: 280 for a chart; a KPI tile takes
|
|
63
|
+
* the height of its figure, and this only sizes its loading placeholder (default 64).
|
|
64
|
+
*/
|
|
65
|
+
height?: number;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
export interface ChartDashboardProps {
|
|
69
|
+
/** The tiles, in reading order. Tiles may name charts of any number of resources. */
|
|
70
|
+
tiles: readonly ChartDashboardTile[];
|
|
71
|
+
/** The most columns the grid reaches. Default: {@link ChartDashboardColumns.FOUR}. */
|
|
72
|
+
columns?: ChartDashboardColumns;
|
|
73
|
+
className?: string;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Lays charts from several resources on one responsive grid: one column in a narrow pane, then up to `columns`
|
|
78
|
+
* ({@link ChartDashboardColumns}, four by default) as the container widens (container queries, so a dashboard in a
|
|
79
|
+
* split pane is laid out for the pane). A tile may span two columns or the whole row, and two rows.
|
|
80
|
+
*
|
|
81
|
+
* Each tile is headed by the chart view's own title (`views.chart.resources.<resourceType>.<ref>.title`, the words
|
|
82
|
+
* its route and launcher use) and drawn through `EmbedChart`: the chart's feature gate, the host composite's scope and
|
|
83
|
+
* a failure kept inside the tile. A tile whose chart the viewer may not read — the backend's aggregation gate would
|
|
84
|
+
* refuse it: no LIST role on its resource or on a resource it joins, or outside the chart's own `accessControl.roles`,
|
|
85
|
+
* or only a role confined there to its holder's own or assigned rows (a chart reads every row in scope) — is not drawn,
|
|
86
|
+
* and the grid closes up. A dashboard with nothing the viewer may read renders nothing.
|
|
87
|
+
*
|
|
88
|
+
* A KPI tile (a chart view whose chart is `ChartType.KPI`) shows one figure under that title, hidden by the same rule.
|
|
89
|
+
*
|
|
90
|
+
* Place it inside a composite view (`CompositeLayout`), or declare a whole view as one with
|
|
91
|
+
* {@link defineChartDashboardView}.
|
|
92
|
+
*
|
|
93
|
+
* @example
|
|
94
|
+
* ```tsx
|
|
95
|
+
* <ChartDashboard
|
|
96
|
+
* tiles={[
|
|
97
|
+
* { resourceType: R.TODOS, chartViewRef: todosByStatusChartDefinition.ref },
|
|
98
|
+
* { resourceType: R.TASKS, chartViewRef: todoTaskPriorityChartDefinition.ref },
|
|
99
|
+
* { resourceType: R.TODOS, chartViewRef: todosCreatedTimelineChartDefinition.ref, span: ChartDashboardTileSpan.TWO },
|
|
100
|
+
* ]}
|
|
101
|
+
* />
|
|
102
|
+
* ```
|
|
103
|
+
*/
|
|
104
|
+
export function ChartDashboard({ tiles, columns = ChartDashboardColumns.FOUR, className }: ChartDashboardProps): React.JSX.Element | null {
|
|
105
|
+
const { registry } = useResourceRegistry();
|
|
106
|
+
const viewer = useViewerEffectiveRoles();
|
|
107
|
+
const visibleTiles = useMemo(
|
|
108
|
+
() => tiles.flatMap((tile) => {
|
|
109
|
+
const chartView = registry.resourceConfigurations[tile.resourceType]?.frontendConfiguration?.chartViews
|
|
110
|
+
?.find((candidate) => candidate.ref === tile.chartViewRef);
|
|
111
|
+
// An unknown chart is an authoring error, and `EmbedChart` throws it with the resource and ref named.
|
|
112
|
+
if (chartView !== undefined && !viewerMayReadChart(chartView.chartDefinition, registry, viewer)) return [];
|
|
113
|
+
return [{ tile, isFigure: chartView?.chartDefinition.chartType === ChartType.KPI }];
|
|
114
|
+
}),
|
|
115
|
+
[tiles, registry, viewer],
|
|
116
|
+
);
|
|
117
|
+
|
|
118
|
+
if (visibleTiles.length === 0) return null;
|
|
119
|
+
const grid = GRID_CLASSES[columns];
|
|
120
|
+
return (
|
|
121
|
+
<div className={cn('@container w-full', className)} data-chart-dashboard>
|
|
122
|
+
<div className={cn('grid grid-cols-1 gap-group', grid.columns)}>
|
|
123
|
+
{visibleTiles.map(({ tile, isFigure }) => (
|
|
124
|
+
<ChartDashboardTileCell key={`${tile.resourceType}:${tile.chartViewRef}`} tile={tile} isFigure={isFigure} grid={grid} />
|
|
125
|
+
))}
|
|
126
|
+
</div>
|
|
127
|
+
</div>
|
|
128
|
+
);
|
|
129
|
+
}
|
|
130
|
+
```
|
|
@@ -12,11 +12,13 @@
|
|
|
12
12
|
/**
|
|
13
13
|
* Read the DATA of a resource's declared chart view, scoped exactly as the rendered chart is.
|
|
14
14
|
*
|
|
15
|
-
* Import from `@wildo-ai/saas-frontend-lib`. Use it when
|
|
16
|
-
* canvas:
|
|
15
|
+
* Import from `@wildo-ai/saas-frontend-lib`. Use it when code needs a chart's numbers without its
|
|
16
|
+
* canvas: a summary sentence, a count on a badge, a decision in a custom view. A figure SHOWN as a tile
|
|
17
|
+
* is a `ChartType.KPI` chart on a `ChartDashboard` instead (#2299): the backend computes it and the
|
|
18
|
+
* dashboard hides it from a viewer who may not read it. It resolves the chart the way an
|
|
17
19
|
* embedded chart does. It finds the resource's `chartViews` entry, turns the entry's declared
|
|
18
20
|
* `primaryScope` (for example the organization) into context from the signed-in session, then
|
|
19
|
-
* fetches.
|
|
21
|
+
* fetches. Time buckets are cut in the zone the reader reads every other date in, as a rendered chart's are.
|
|
20
22
|
*
|
|
21
23
|
* Do not call `useChartData` with a bare `ChartDefinition` for this. That hook is the transport and
|
|
22
24
|
* sends only the context you pass it, so a chart scoped to an organization is refused by the
|
|
@@ -29,7 +31,7 @@
|
|
|
29
31
|
* @param params.viewRef - that chart view's `ref`
|
|
30
32
|
* @param params.contextResourceIdentifiers - context you already hold (a parent record's id); merged
|
|
31
33
|
* with what the chart's scope resolves
|
|
32
|
-
* @param params.localErrorOnly - `true` when your view shows the failure itself
|
|
34
|
+
* @param params.localErrorOnly - `true` when your view shows the failure itself, so no
|
|
33
35
|
* page-level error toast is raised
|
|
34
36
|
* @returns `{ data, loading, error, refetch }`; `data.data` holds one row per dimension value, keyed by
|
|
35
37
|
* the query's dimension and measure refs
|
|
@@ -56,6 +58,7 @@ export function useResourceChartData(params: {
|
|
|
56
58
|
}): ChartDataState {
|
|
57
59
|
const { resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, localErrorOnly = false } = params;
|
|
58
60
|
const { registry } = useResourceRegistry();
|
|
61
|
+
const { resolvedRegionalPreferences } = useI18n();
|
|
59
62
|
const chartView = registry.resourceConfigurations[resourceType]
|
|
60
63
|
?.frontendConfiguration
|
|
61
64
|
?.chartViews
|
|
@@ -87,6 +90,7 @@ export function useResourceChartData(params: {
|
|
|
87
90
|
runtime?.contextResourceIdentifiers,
|
|
88
91
|
urlParamValues,
|
|
89
92
|
localErrorOnly,
|
|
93
|
+
resolvedRegionalPreferences.timezone,
|
|
90
94
|
);
|
|
91
95
|
}
|
|
92
96
|
```
|