@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
|
@@ -0,0 +1,264 @@
|
|
|
1
|
+
# A workflow record page
|
|
2
|
+
|
|
3
|
+
Read this for a resource with a LIFECYCLE that other people move after its author wrote it — a request that waits for
|
|
4
|
+
approvals, a claim that is assessed, an order that is placed. Its record page has one job beyond showing the fields:
|
|
5
|
+
**where does it stand, and what happens next?** The engine's generated page puts the status first and who made the
|
|
6
|
+
record last, but it cannot know the route the record takes or which facts belong to which stage.
|
|
7
|
+
|
|
8
|
+
## The page, part by part
|
|
9
|
+
|
|
10
|
+
| part | what it holds | construct |
|
|
11
|
+
|---|---|---|
|
|
12
|
+
| header | the record's name, and its status as a badge — the fact every reader needs first | `layout.header`: `<ResourceHeaderTitle />`, then `<DisplayField name="status" labelPlacement="hidden" />` (the name stays for a screen reader; `hideLabel` would remove it) |
|
|
13
|
+
| route | the steps the record takes, with the current one marked: the step after it IS the next step | a `Stepper` derived from the lifecycle (never a hand-kept list), each step named by the status enum's own words (`tResourceFieldEnumValue`) |
|
|
14
|
+
| what was asked | what the author wrote, once: the content, then its facts as tiles | `<Section name="…">` with the prose field and a `<FieldTiles>` |
|
|
15
|
+
| what happened | what other people did to it afterwards: when it was submitted, decided, completed, and the decisions recorded on it | a second `<Section>`; the decisions as their LIST, confined to the record and with its toolbar hidden (see below), drawn only for a reader who may list them; the section not drawn at all before anything has happened (a draft) |
|
|
16
|
+
| record keeping | who wrote it, when, and when it last changed | `<RecordKeepingFacts>` closing the page — never tiles inside either section (`framework-record-page-parts-api.md`) |
|
|
17
|
+
| actions | the transitions, each offered only from its `from` states, with words | the operations' views and icons (`views: [...]`); availability is the operations' `enabledCondition` |
|
|
18
|
+
|
|
19
|
+
The two sections pass the "different time, different reader" test of `references/surface-decisions.md`: the first is
|
|
20
|
+
written once by the author, the second is filled over time by the approvers. A record whose fields are all written at
|
|
21
|
+
one time needs no sections.
|
|
22
|
+
|
|
23
|
+
- **The route is derived.** Compute it from the same policy the transitions route by (which steps a record of this
|
|
24
|
+
amount needs), so a change of policy moves the route with it. A record that LEFT its route (refused, withdrawn)
|
|
25
|
+
shows no route: the badge says so, and the decision history says why.
|
|
26
|
+
- **The decisions are read by the person the record belongs to.** A refusal's reason is written for the requester, so
|
|
27
|
+
they read the decisions on their own record and on no colleague's: the decision names its requester in a field of its
|
|
28
|
+
own, confined by own rows (the `authorization-unit-narrowing` skill, "The rows ABOUT an owner's record"). Decisions
|
|
29
|
+
that outlive their record are a REFERENCE child on a standalone edge: the embed confines them to the record through
|
|
30
|
+
the decisions' route under it, or, where there is none, pins the record's foreign key declared in the decisions LIST's
|
|
31
|
+
`filterFields` (`framework-related-resource-embeds-api.md`, "A child whose route does not name the record"); with
|
|
32
|
+
neither the section is left out. Build the section from the embed's context with the toolbar hidden (a history is read, not searched). The
|
|
33
|
+
card shows what the requester asks: the outcome, the step, the reason in full, then who decided and when.
|
|
34
|
+
- **Leave out what is true of every record.** The owner organization of a single-tenant tool tells nobody anything.
|
|
35
|
+
- **Status words come from the enum.** The route adds no vocabulary: "Awaiting finance" on the stepper is the same
|
|
36
|
+
word as on the list's badge.
|
|
37
|
+
- **A date the business needs in the future** (needed by, due on) is refused when it is in the past by the operations
|
|
38
|
+
that write it (create, edit, submit) — never by a refinement of the main schema, which also parses every stored
|
|
39
|
+
record, including one whose date has since passed.
|
|
40
|
+
|
|
41
|
+
## Worked example
|
|
42
|
+
|
|
43
|
+
Wonder Procurement's purchase request: header with the status badge, the route from draft through the approvals its
|
|
44
|
+
amount requires to ordered, then `request` and `approval` sections, the form and the card.
|
|
45
|
+
|
|
46
|
+
|
|
47
|
+
## Usage Example
|
|
48
|
+
|
|
49
|
+
```tsx
|
|
50
|
+
/**
|
|
51
|
+
* The decisions recorded on THIS request: who decided at which step, what, when, and why.
|
|
52
|
+
*
|
|
53
|
+
* Read by the approvers and finance, and by the requester (#3068): a refusal's reason is written for them, and they read
|
|
54
|
+
* the decisions on their own requests through own rows on the decision's `requesterUserId`. A section a reader cannot
|
|
55
|
+
* read is not drawn at all rather than drawn as an error, and a draft has never been decided, so it shows no empty
|
|
56
|
+
* history either.
|
|
57
|
+
*
|
|
58
|
+
* The decisions' LIST, embedded from this request. A decision is a REFERENCE child (it outlives the request) on a
|
|
59
|
+
* standalone edge, which puts no requirement for the request in the context, so the embed runtime sends the LIST down
|
|
60
|
+
* its route under the request, `/purchase-requests/{purchaseRequestId}/approval-decisions` (#3072, #3073), inside what
|
|
61
|
+
* the reader may read, so it only narrows. Built here
|
|
62
|
+
* rather than through `RelatedResourceSections` for what that component does not offer: the toolbar is hidden (a
|
|
63
|
+
* history is read, not searched), and the section is not drawn for a reader who may not list decisions or for a draft.
|
|
64
|
+
* The title is the decisions' own header label, as `RelatedResourceSections` uses.
|
|
65
|
+
*/
|
|
66
|
+
function ApprovalDecisionsOfRequest(): React.JSX.Element | null {
|
|
67
|
+
const mayList = useViewerMayListRelatedResource(R.APPROVAL_DECISIONS);
|
|
68
|
+
const { data } = useDisplayTemplateContext();
|
|
69
|
+
const embedded = useEmbeddedResourceContext();
|
|
70
|
+
const { tResourceHeader, isReady } = useI18n();
|
|
71
|
+
const requestId = embedded.hostResourceId;
|
|
72
|
+
// Built only once the reader may list them: `mayList` is also false when the runtime could not confine the list to
|
|
73
|
+
// this request, and building it then would throw where the section should simply not be drawn.
|
|
74
|
+
const decisionsOfRequest = useMemo(
|
|
75
|
+
() => (requestId && mayList
|
|
76
|
+
? {
|
|
77
|
+
...embedded.buildOperationContext({ resourceType: R.APPROVAL_DECISIONS, operationLike: Op.LIST, requireAddressable: false }),
|
|
78
|
+
collectionToolbar: CollectionToolbarPresence.HIDDEN,
|
|
79
|
+
}
|
|
80
|
+
: null),
|
|
81
|
+
[embedded, requestId, mayList],
|
|
82
|
+
);
|
|
83
|
+
if (!mayList || !decisionsOfRequest || !isReady || data?.status === PurchaseRequestStatus.DRAFT) return null;
|
|
84
|
+
return (
|
|
85
|
+
<ContentSectionContainer
|
|
86
|
+
config={{ mode: SectionMode.INLINE }}
|
|
87
|
+
sections={[{
|
|
88
|
+
id: R.APPROVAL_DECISIONS,
|
|
89
|
+
title: resolveResourceHeaderLabel({ tResourceHeader, resourceType: R.APPROVAL_DECISIONS, key: 'title' }),
|
|
90
|
+
content: <EmbedResourceOperation resourceContext={decisionsOfRequest} />,
|
|
91
|
+
}]}
|
|
92
|
+
/>
|
|
93
|
+
);
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* What happened to the request after it was written. A draft has not been submitted, so nothing has happened to it yet:
|
|
98
|
+
* the section is not drawn at all, rather than drawn as a heading over nothing (every fact in it is empty and drops out).
|
|
99
|
+
*/
|
|
100
|
+
function ApprovalSection(): React.JSX.Element | null {
|
|
101
|
+
const { data } = useDisplayTemplateContext();
|
|
102
|
+
if (data?.status === PurchaseRequestStatus.DRAFT) return null;
|
|
103
|
+
return (
|
|
104
|
+
<Section name="approval">
|
|
105
|
+
<FieldTiles>
|
|
106
|
+
<DisplayField name="submittedAt" />
|
|
107
|
+
<DisplayField name="decidedAt" />
|
|
108
|
+
<DisplayField name="orderedAt" />
|
|
109
|
+
<DisplayField name="erpPurchaseOrderRef" />
|
|
110
|
+
</FieldTiles>
|
|
111
|
+
<ApprovalDecisionsOfRequest />
|
|
112
|
+
</Section>
|
|
113
|
+
);
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## Usage Example
|
|
118
|
+
|
|
119
|
+
```tsx
|
|
120
|
+
layout: {
|
|
121
|
+
refs: { sections: ['request', 'approval'] },
|
|
122
|
+
defaultChromeMode: {
|
|
123
|
+
summary: DisplayChromeMode.HIDDEN,
|
|
124
|
+
edit: EditChromeMode.STACKED,
|
|
125
|
+
},
|
|
126
|
+
|
|
127
|
+
header: () => (
|
|
128
|
+
<div className="flex min-w-0 flex-wrap items-center gap-field">
|
|
129
|
+
<ResourceHeaderTitle />
|
|
130
|
+
{/* The name stays for assistive technology (`labelPlacement="hidden"` renders it screen-reader only; `hideLabel` would drop it). */}
|
|
131
|
+
<DisplayField name="status" labelPlacement="hidden" hideDescription className="w-auto" />
|
|
132
|
+
</div>
|
|
133
|
+
),
|
|
134
|
+
|
|
135
|
+
display: () => (
|
|
136
|
+
<DisplayLayout>
|
|
137
|
+
<PurchaseRequestProgress />
|
|
138
|
+
<Section name="request">
|
|
139
|
+
<DisplayField name="justification" />
|
|
140
|
+
<FieldTiles>
|
|
141
|
+
<DisplayField name="supplierDirectoryEntryId" />
|
|
142
|
+
<DisplayField name="estimatedTotal" />
|
|
143
|
+
<DisplayField name="neededBy" />
|
|
144
|
+
<DisplayField name="organizationUnitId" />
|
|
145
|
+
</FieldTiles>
|
|
146
|
+
</Section>
|
|
147
|
+
<ApprovalSection />
|
|
148
|
+
{/* Who wrote the request and when it last changed: record keeping, not what was asked or decided, so it
|
|
149
|
+
closes the page on one quiet line instead of sitting among the request's facts (#3066). */}
|
|
150
|
+
<RecordKeepingFacts>
|
|
151
|
+
<DisplayField name="createdByUserId" />
|
|
152
|
+
<DisplayField name="createdAt" />
|
|
153
|
+
<DisplayField name="updatedAt" />
|
|
154
|
+
</RecordKeepingFacts>
|
|
155
|
+
</DisplayLayout>
|
|
156
|
+
),
|
|
157
|
+
|
|
158
|
+
edit: () => (
|
|
159
|
+
<FormLayout>
|
|
160
|
+
<FormField name="title" autoFocus />
|
|
161
|
+
<FormField name="justification" />
|
|
162
|
+
<div className="grid grid-cols-1 gap-field sm:grid-cols-2">
|
|
163
|
+
<FormField name="organizationUnitId" />
|
|
164
|
+
<FormField name="supplierDirectoryEntryId" />
|
|
165
|
+
<FormField name="estimatedTotal" />
|
|
166
|
+
<FormField name="neededBy" />
|
|
167
|
+
</div>
|
|
168
|
+
</FormLayout>
|
|
169
|
+
),
|
|
170
|
+
|
|
171
|
+
summary: () => (
|
|
172
|
+
<SummaryLayout titlePlacement={SummaryTitlePlacement.TEMPLATE_OWNED}>
|
|
173
|
+
<SummaryHeader>
|
|
174
|
+
<SummaryTitle className="flex-initial" />
|
|
175
|
+
<DisplayField name="status" />
|
|
176
|
+
</SummaryHeader>
|
|
177
|
+
<SummaryMeta>
|
|
178
|
+
<DisplayField name="estimatedTotal" />
|
|
179
|
+
<DisplayField name="organizationUnitId" />
|
|
180
|
+
<DisplayField name="neededBy" />
|
|
181
|
+
</SummaryMeta>
|
|
182
|
+
</SummaryLayout>
|
|
183
|
+
),
|
|
184
|
+
},
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
## Usage Example
|
|
188
|
+
|
|
189
|
+
```tsx
|
|
190
|
+
/**
|
|
191
|
+
* The route a request takes, in the order it is walked: a draft, the approval steps its amount requires
|
|
192
|
+
* (`requiredApprovalSteps`, the purchasing policy's one rule), then approved and ordered. Derived from the policy rather
|
|
193
|
+
* than listed, so a request under the finance threshold shows no finance step and a change of threshold moves the
|
|
194
|
+
* route with it.
|
|
195
|
+
*/
|
|
196
|
+
export function purchaseRequestRoute(totalMinorUnits: bigint): readonly PurchaseRequestStatus[] {
|
|
197
|
+
return [
|
|
198
|
+
PurchaseRequestStatus.DRAFT,
|
|
199
|
+
...requiredApprovalSteps(totalMinorUnits).map((step) => STATUS_AWAITING_STEP[step]),
|
|
200
|
+
PurchaseRequestStatus.APPROVED,
|
|
201
|
+
PurchaseRequestStatus.ORDERED,
|
|
202
|
+
];
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** The amount in minor units, as the wire carries it (a bigint, or its decimal string once serialized). */
|
|
206
|
+
function minorUnitsOf(estimatedTotal: unknown): bigint | undefined {
|
|
207
|
+
const amount = (estimatedTotal as { amount?: unknown } | undefined)?.amount;
|
|
208
|
+
if (typeof amount === 'bigint') return amount;
|
|
209
|
+
if (typeof amount === 'number' && Number.isFinite(amount)) return BigInt(Math.trunc(amount));
|
|
210
|
+
if (typeof amount === 'string' && /^-?\d+$/.test(amount)) return BigInt(amount);
|
|
211
|
+
return undefined;
|
|
212
|
+
}
|
|
213
|
+
|
|
214
|
+
/**
|
|
215
|
+
* Where a purchase request stands on its route, and what comes next — the record page's progress line (#3066).
|
|
216
|
+
*
|
|
217
|
+
* Each step is named by the status it reaches, in the words the status badge already uses (`system enum` labels of
|
|
218
|
+
* `PurchaseRequestStatus`), so the page adds no vocabulary: the step after the current one IS the next step, read in
|
|
219
|
+
* the same words the list's badges use ("Awaiting department head", "Awaiting finance").
|
|
220
|
+
*
|
|
221
|
+
* A request that left its route — refused or withdrawn — renders nothing: the header's badge says so, and the
|
|
222
|
+
* approval history below says who and why. Drawing a route it will never finish would show a next step that is not
|
|
223
|
+
* coming.
|
|
224
|
+
*/
|
|
225
|
+
export function PurchaseRequestProgress(): React.JSX.Element | null {
|
|
226
|
+
const { data } = useDisplayTemplateContext();
|
|
227
|
+
const { tResourceFieldEnumValue } = useI18n();
|
|
228
|
+
const status = data?.status as PurchaseRequestStatus | undefined;
|
|
229
|
+
const total = minorUnitsOf(data?.estimatedTotal);
|
|
230
|
+
|
|
231
|
+
const route = useMemo(() => (total === undefined ? undefined : purchaseRequestRoute(total)), [total]);
|
|
232
|
+
if (!route || !status) return null;
|
|
233
|
+
const current = route.indexOf(status);
|
|
234
|
+
if (current < 0) return null;
|
|
235
|
+
const last = route.length - 1;
|
|
236
|
+
// An ordered request has walked every step: all of them are done, the last included.
|
|
237
|
+
const completedSteps = status === PurchaseRequestStatus.ORDERED ? new Set(route.map((_, index) => index)) : undefined;
|
|
238
|
+
|
|
239
|
+
return (
|
|
240
|
+
<Stepper currentStep={current} totalSteps={route.length} orientation={DisplayDirection.HORIZONTAL} completedSteps={completedSteps}>
|
|
241
|
+
{route.map((step, index) => (
|
|
242
|
+
<Fragment key={step}>
|
|
243
|
+
<StepperItem step={index}>
|
|
244
|
+
<StepperIndicator step={index} />
|
|
245
|
+
<StepperTitle step={index}>
|
|
246
|
+
{tResourceFieldEnumValue(R.PURCHASE_REQUESTS, 'status', step, PurchaseRequests_Schema.shape.status)}
|
|
247
|
+
</StepperTitle>
|
|
248
|
+
</StepperItem>
|
|
249
|
+
{index < last && <StepperSeparator step={index} />}
|
|
250
|
+
</Fragment>
|
|
251
|
+
))}
|
|
252
|
+
</Stepper>
|
|
253
|
+
);
|
|
254
|
+
}
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
## Verify
|
|
258
|
+
|
|
259
|
+
- The page of a record at each status shows the route with that step current (or no route when refused/withdrawn).
|
|
260
|
+
- No section holds only record keeping: `createdByUserId`, `createdAt` and `updatedAt` sit in `<RecordKeepingFacts>`, and a
|
|
261
|
+
draft's page draws no empty "what happened" section.
|
|
262
|
+
- Every named section is in `layout.refs.sections` and documented in the specification's `frontend.layout.sections`.
|
|
263
|
+
- A future-date rule is checked in the operations that write the date (`rg -n "neededBy" backend-api/src/modules`),
|
|
264
|
+
and no `*.schemas.ts` refines the date field.
|
|
@@ -123,6 +123,14 @@ specific resource row. The triggering row's `_id` is the natural
|
|
|
123
123
|
> is a resource, not a deployment event). The same applies to any
|
|
124
124
|
> "on creation of resource X" pattern.
|
|
125
125
|
|
|
126
|
+
**The application start does not iterate rows.** `ON_APP_INIT` and `ON_APP_VERSION_UPGRADE` run a
|
|
127
|
+
seed once, against one anchor, so they take a `GLOBAL` or `APPLICATION` scope only.
|
|
128
|
+
`createDataSeedDefinition` refuses an `ORGANIZATION`, `USER` or `CUSTOM` seed carrying either
|
|
129
|
+
trigger, `scopeIteration` or not. Per-row data reaches its rows another way: a `RESOURCE_LIFECYCLE`
|
|
130
|
+
trigger for each new row, `lazyAccess` for an existing row on first read, or the cron path
|
|
131
|
+
(`ON_SCHEDULED_REFRESH` with a `schedule` whose `iterationStrategy` names the rows) to revisit every
|
|
132
|
+
row.
|
|
133
|
+
|
|
126
134
|
On any level, a per-scope seed keeps STATIC entries with `anchorEntriesToScopeForeignKey: true`:
|
|
127
135
|
leave the scope key (`organizationId`, …) out of the business key and the engine adds the id of the
|
|
128
136
|
scope row being seeded. Use a computed `entry()` only when VALUES depend on the triggering row. It returns
|
|
@@ -138,7 +146,7 @@ computed (a server-owned total, a derived status) itself, and a seeded row annou
|
|
|
138
146
|
|
|
139
147
|
| Mode | Re-run safe? | Touches existing rows? | Required fields | Pick when … |
|
|
140
148
|
|------------|--------------|--------------------------------|-----------------------------------------------------------------------|--------------------------------------------------------------------------|
|
|
141
|
-
| `LAZY` | Yes |
|
|
149
|
+
| `LAZY` | Yes | On first access in a scope only — the payload is re-stamped on a row another seed already created, unless `existingRowTreatment: FILL_MISSING_DEFAULTS` | `lazyAccess`, `entry()` | "Default X appears the first time the user opens Y" |
|
|
142
150
|
| `ADDITIVE` | Yes | Yes — full payload re-stamped, unless `existingRowTreatment: FILL_MISSING_DEFAULTS` | none beyond the base | "New rows shipped in vN+1 should appear; existing rows are re-stamped from the declared payload" |
|
|
143
151
|
| `UPGRADE` | Yes | Yes — only `managedFields` | `managedFields[]` (non-empty), optional `migrators.fromVersion[n]` | "Re-deploy the framework-owned subject line, keep user-edited body" |
|
|
144
152
|
| `SYNC` | Yes | Yes — controlled by `onOrphan` | `onOrphan` (`DELETE` / `DEPRECATE` / `REPORT`), `managedFields[]` | "Closed enum materialized as rows; declaration is the source of truth" |
|
|
@@ -149,7 +157,9 @@ re-applied `ADDITIVE` payload replaces each whole stored block — so every pass
|
|
|
149
157
|
administrator saved. Declare `existingRowTreatment: DataSeedExistingRowTreatment.FILL_MISSING_DEFAULTS`
|
|
150
158
|
on such a seed: it inserts when the row is absent and, on an existing row, assigns only the leaves the
|
|
151
159
|
row is missing. On a `RESOURCE_LIFECYCLE` seed it also repairs the rows it created earlier, once per
|
|
152
|
-
seed `version`, at application boot. The field is `ADDITIVE
|
|
160
|
+
seed `version`, at application boot. The field is valid on `ADDITIVE` and `LAZY`; the factory rejects
|
|
161
|
+
it elsewhere. A `LAZY` seed of a row another seed also creates needs it too: the lazy pass runs when
|
|
162
|
+
its own ledger has no completed run, which includes a row the other seed already wrote.
|
|
153
163
|
|
|
154
164
|
The §3.6 matrix rejects illegal cells at factory time:
|
|
155
165
|
|
|
@@ -298,8 +308,10 @@ ONLY — the factory auto-injects the matching trigger. Never declare
|
|
|
298
308
|
|
|
299
309
|
Walk Decision 2. Cross-check the §3.6 matrix cell. If the cell is
|
|
300
310
|
empty (e.g. UPGRADE × `RESOURCE_LIFECYCLE`), restructure the seed:
|
|
301
|
-
either change the level (move to Level A `ON_APP_VERSION_UPGRADE
|
|
302
|
-
|
|
311
|
+
either change the level (move to Level A `ON_APP_VERSION_UPGRADE`, which
|
|
312
|
+
is open to a `GLOBAL` or `APPLICATION` seed only; for a per-row seed use
|
|
313
|
+
`ON_SCHEDULED_REFRESH` with a `schedule`) or change the mode (use ADDITIVE
|
|
314
|
+
for the per-row case).
|
|
303
315
|
|
|
304
316
|
### Step 4: Declare the seed
|
|
305
317
|
|
|
@@ -648,6 +660,7 @@ What is **not** in this block (and shouldn't be):
|
|
|
648
660
|
- [ ] Seed file default-exports the result of `createDataSeedDefinition({...})`
|
|
649
661
|
- [ ] `seedKey` is stable across deploys (kebab-case segments joined by `:`)
|
|
650
662
|
- [ ] Mode × trigger cell is allowed by the §3.6 matrix
|
|
663
|
+
- [ ] An `ORGANIZATION` / `USER` / `CUSTOM` seed carries no `ON_APP_INIT` or `ON_APP_VERSION_UPGRADE` trigger
|
|
651
664
|
- [ ] LAZY seeds declare `lazyAccess` and OMIT `triggers`
|
|
652
665
|
- [ ] Non-LAZY seeds declare `triggers[]` (≥1) and OMIT `lazyAccess`
|
|
653
666
|
- [ ] UPGRADE seeds declare non-empty `managedFields[]`
|
|
@@ -656,6 +669,10 @@ What is **not** in this block (and shouldn't be):
|
|
|
656
669
|
- [ ] `renames[*].to` matches a declared `entries[*].businessKey[field]`
|
|
657
670
|
- [ ] A demonstration seed declares `allowedApplicationEnvironments` without `production`; a reference seed omits it
|
|
658
671
|
- [ ] A foreign key to another seed's row is a `referenceDataSeedRow(...)` (never unset or a placeholder) and that seed is in `dependsOn`
|
|
672
|
+
- [ ] Every entry carries every field the resource's schema requires and does not default, including a field the create
|
|
673
|
+
request keeps out (`.excludeFromCreate()`, `.isBackendOnly()`); a required object with no object-level default is
|
|
674
|
+
written as `{}` so its field defaults fill it. The write refuses an entry that leaves one out, on every adapter and
|
|
675
|
+
on an existing row too
|
|
659
676
|
- [ ] Seed surfaced on the module's `BackendDomainModule.seeds?: DataSeedDefinition[]` slot
|
|
660
677
|
(aggregated by `mergeBackendDomainModules` and threaded into the assembly's `dataSeeds`)
|
|
661
678
|
|
|
@@ -698,6 +715,7 @@ with an actionable error.
|
|
|
698
715
|
| "I'll rename the resource field directly without a `renames` entry" | Without the rename ledger, the next pass inserts a duplicate at the new business-key value and orphans the existing row (SYNC) or leaves it unowned (UPGRADE / ADDITIVE). Always ship the ledger entry in the same commit as the value change. |
|
|
699
716
|
| "The contact seed can't know the customer's `_id`, so I'll leave `customerId` unset" | Use `referenceDataSeedRow(customersSeed, { …businessKey })` and list the customer seed in `dependsOn`: the engine resolves it to the row's `_id`. An unset or placeholder foreign key is a demo that shows unlinked records. |
|
|
700
717
|
| "`dependsOn` resolves the link for me" | `dependsOn` only orders the seeds. Without a `referenceDataSeedRow` value nothing writes the foreign key. |
|
|
718
|
+
| "`data: {}` gets the schema's defaults, so I can leave the config blocks out" | Only a field that declares a default is filled. A required object with no object-level default must be written, as `{}`, for its field defaults to fill it; leave it out and the write refuses the row (it would be stored without the block). |
|
|
701
719
|
| "I don't need `version` to bump for this UPGRADE" | UPGRADE re-applies `managedFields` only when `seedVersion < declared` — without bumping, existing rows skip the upgrade. Bump per material change. |
|
|
702
720
|
|
|
703
721
|
## Red Flags
|
|
@@ -725,6 +743,8 @@ with an actionable error.
|
|
|
725
743
|
contract is "first access creates the row, never re-applied")
|
|
726
744
|
- A demo seed whose foreign key to another seeded row is unset, `null` or hard-coded (Decision 7)
|
|
727
745
|
- `referenceDataSeedRow` in a seed without `dependsOn` (catch with the references grep above)
|
|
746
|
+
- An entry whose `data` leaves out a required field with no default (a required config block included): the write
|
|
747
|
+
refuses it as `service_resource_validation_failed` naming the field (catch with the required-fields checklist item above)
|
|
728
748
|
|
|
729
749
|
## Related Skills
|
|
730
750
|
|
|
@@ -40,6 +40,18 @@ Nothing is ever written with a `null` or a placeholder foreign key.
|
|
|
40
40
|
- Directly as a field value, or inside nested objects and arrays (`tagIds: [ref, ref]`).
|
|
41
41
|
- In every mode (`ADDITIVE`, `UPGRADE`, `SYNC`, `LAZY`) and on every trigger level, including manual
|
|
42
42
|
reruns.
|
|
43
|
+
- Inside another reference's business key, for a row keyed under its parent. A site address keyed
|
|
44
|
+
`(organizationId, customerId, label)` is named by its customer's reference and its own label:
|
|
45
|
+
|
|
46
|
+
```ts
|
|
47
|
+
siteAddressId: referenceDataSeedRow(demoSiteAddressesSeed, {
|
|
48
|
+
customerId: referenceDataSeedRow(demoCustomersSeed, { email: 'ana.martin@example.com' }),
|
|
49
|
+
label: 'Main house',
|
|
50
|
+
})
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
The inner reference resolves first. Its seed must be in the referring seed's `dependsOn` too, under
|
|
54
|
+
the same rules as a direct reference. If it resolves to nothing, the failure names it.
|
|
43
55
|
|
|
44
56
|
## Reading a failure
|
|
45
57
|
|
|
@@ -31,7 +31,10 @@ import from there in seed files (NOT the package root).
|
|
|
31
31
|
* materialization, per-scope idempotency cache. Cannot combine with
|
|
32
32
|
* `schedule?` (periodic re-run contradicts the contract). Write path
|
|
33
33
|
* bypasses the operation pipeline (no hook re-entry from the seed's
|
|
34
|
-
* own write).
|
|
34
|
+
* own write). "Never again" is per scope, by the run ledger, not by the
|
|
35
|
+
* row: the first pass writes like ADDITIVE, so a row ANOTHER seed already
|
|
36
|
+
* created there is re-stamped with the payload unless the seed declares
|
|
37
|
+
* `existingRowTreatment: FILL_MISSING_DEFAULTS` (#3383).
|
|
35
38
|
* - **`ADDITIVE`** — "insert if business key absent; on present rows,
|
|
36
39
|
* re-apply the entry's `data` payload via `upsertByBusinessKey`'s
|
|
37
40
|
* `$set` semantics (no managed-fields gating, no version comparison)".
|
|
@@ -118,7 +121,7 @@ export enum DataSeedMode {
|
|
|
118
121
|
* omitted for LAZY (factory auto-injects from `lazyAccess`).
|
|
119
122
|
* - `lazyAccess` — required for LAZY, FORBIDDEN otherwise.
|
|
120
123
|
* - `onOrphan` — required for SYNC, forbidden otherwise.
|
|
121
|
-
* - `existingRowTreatment` — ADDITIVE only. Declare `FILL_MISSING_DEFAULTS`
|
|
124
|
+
* - `existingRowTreatment` — ADDITIVE and LAZY only. Declare `FILL_MISSING_DEFAULTS`
|
|
122
125
|
* when the seed CREATES a row a person owns afterwards (a config
|
|
123
126
|
* singleton): the default re-applies the declared payload on every pass,
|
|
124
127
|
* which replaces whole stored blocks.
|
|
@@ -288,7 +291,8 @@ export class DataSeedRowReference {
|
|
|
288
291
|
* @param businessKey The row's business key. Leave out the scope foreign key (`organizationId`, `userId`, …) when the
|
|
289
292
|
* target seed has the same scope kind as the referring seed: the engine fills it from the scope being seeded.
|
|
290
293
|
* @throws Error when `target` has no `seedKey`, when `businessKey` is not a plain object, or when a business-key value
|
|
291
|
-
* is `undefined
|
|
294
|
+
* is `undefined`. A business-key value may be another reference (a child keyed under its parent): it resolves first,
|
|
295
|
+
* and its seed must be in `dependsOn` too.
|
|
292
296
|
*
|
|
293
297
|
* @example
|
|
294
298
|
* ```ts
|
|
@@ -313,9 +317,6 @@ export function referenceDataSeedRow(
|
|
|
313
317
|
if (value === undefined) {
|
|
314
318
|
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.`);
|
|
315
319
|
}
|
|
316
|
-
if (containsDataSeedRowReference(value)) {
|
|
317
|
-
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.`);
|
|
318
|
-
}
|
|
319
320
|
}
|
|
320
321
|
return new DataSeedRowReference(
|
|
321
322
|
{
|
|
@@ -189,10 +189,14 @@ Run `wildo generate labels`.
|
|
|
189
189
|
- [ ] `defaultSectionRef`, if set, names a destination you placed.
|
|
190
190
|
- [ ] No two placements name the same destination.
|
|
191
191
|
- [ ] The app starts with no settings-hub or launcher verification errors.
|
|
192
|
+
- [ ] `frontend/src/modules-registry.frontend.ts` passes the rail to the runtime (`settingsHub: settingsHubConfig` in `frontendBaseConfig`).
|
|
192
193
|
|
|
193
194
|
### Grep invariants
|
|
194
195
|
|
|
195
196
|
```bash
|
|
197
|
+
# The rail reaches the runtime: prints exactly one line. Nothing printed means Settings opens as an empty dialog.
|
|
198
|
+
rg -n "settingsHub: settingsHubConfig" frontend/src/modules-registry.frontend.ts
|
|
199
|
+
|
|
196
200
|
# Every categoryRef a placement uses must be a declared category.
|
|
197
201
|
rg -o "categoryRef: '([a-z-]+)'" -r '$1' frontend/src/config/settings-hub.config.ts | sort -u
|
|
198
202
|
rg -o "^\s*\{ ref: '([a-z-]+)'" -r '$1' frontend/src/config/settings-hub.config.ts | sort -u
|
|
@@ -211,6 +215,7 @@ rg -U -o "ref: '([a-z-]+)',\s*target:" -r '$1' frontend/src/config/settings-hub.
|
|
|
211
215
|
|
|
212
216
|
| Rationalization | Reality |
|
|
213
217
|
|---|---|
|
|
218
|
+
| "Settings opens as an empty dialog, so the destinations must be broken" | The rail never reached the runtime. `settings-hub.config.ts` is read only where `modules-registry.frontend.ts` passes it as `settingsHub` in `frontendBaseConfig`; the startup verifier reports `SETTINGS_HUB_EMPTY`. |
|
|
214
219
|
| "I removed the section but it still shows" | You removed the LABEL, not the placement. Delete the placement entry. |
|
|
215
220
|
| "The framework will fill in the sections I did not place" | It will not. There is no default arrangement — absence is how you remove a section, so nothing re-adds one. |
|
|
216
221
|
| "The engine has no destination for my resource, so it cannot go in settings" | Declare your own destination with a `RESOURCE_OPERATION` target and place it. Step 3b. |
|
|
@@ -223,6 +228,7 @@ rg -U -o "ref: '([a-z-]+)',\s*target:" -r '$1' frontend/src/config/settings-hub.
|
|
|
223
228
|
|
|
224
229
|
## Red Flags
|
|
225
230
|
|
|
231
|
+
- Settings opens with a title and nothing else: `settingsHub` is not passed in `frontendBaseConfig` — catch with the `settingsHub: settingsHubConfig` grep above.
|
|
226
232
|
- A `categoryRef` that appears in no `categories` entry — catch with the categoryRef grep above.
|
|
227
233
|
- A `groupRef` its category does not declare: the section is drawn above the groups with no heading — catch with the groupRef grep above.
|
|
228
234
|
- The same `destinationRef` placed twice — catch with the duplicate grep above.
|
|
@@ -110,6 +110,11 @@ export enum EngineSettingsDestinationRef {
|
|
|
110
110
|
* (#2324): one row per task transition and webhook, with its attempts and outcome. Each person's own.
|
|
111
111
|
*/
|
|
112
112
|
MY_AGENT_PUSH_DELIVERIES = 'my-agent-push-deliveries',
|
|
113
|
+
/**
|
|
114
|
+
* The signed-in person's own data-subject requests (#2296): a request to exercise a data-protection right (today,
|
|
115
|
+
* erasure of their account), its grace window, the deadline it is answered by and what was done. Each person's own.
|
|
116
|
+
*/
|
|
117
|
+
MY_DATA_SUBJECT_REQUESTS = 'my-data-subject-requests',
|
|
113
118
|
/** Single sign-on configuration and connections. */
|
|
114
119
|
SSO = 'sso',
|
|
115
120
|
/** SCIM directory provisioning configuration and tokens. */
|
|
@@ -183,6 +188,12 @@ export enum EngineSettingsDestinationRef {
|
|
|
183
188
|
* and the provider's DNS records, verify, remove. Org owner/admin only, matching the resource's ORG_ADMIN verbs.
|
|
184
189
|
*/
|
|
185
190
|
EMAIL_DOMAINS = 'email-domains',
|
|
191
|
+
/**
|
|
192
|
+
* The domains on which the application answers for THIS organization (#2974): claim one, publish its ownership TXT
|
|
193
|
+
* record, prove ownership, remove. Org owner/admin only, matching the resource's ORG_ADMIN verbs; claiming and
|
|
194
|
+
* proving need the plan's custom branding, which the backend refuses by name when it is missing.
|
|
195
|
+
*/
|
|
196
|
+
CUSTOM_DOMAINS = 'custom-domains',
|
|
186
197
|
/**
|
|
187
198
|
* The addresses THIS organization — a representing organization — keeps on its own verified domain for the granting
|
|
188
199
|
* organizations it serves; each routes its mail into that granting organization (#1600). Org owner/admin only. Shown
|
|
@@ -282,6 +293,15 @@ export enum EngineSettingsDestinationRef {
|
|
|
282
293
|
* grant. So the destination shows nothing without an elevation, and says where to request one.
|
|
283
294
|
*/
|
|
284
295
|
APPLICATION_ORGANIZATIONS = 'application-organizations',
|
|
296
|
+
/**
|
|
297
|
+
* The data-subject request queue (#2296): every person's requests the controller still owes an answer to, or that
|
|
298
|
+
* need an operator, soonest deadline first.
|
|
299
|
+
*
|
|
300
|
+
* Lists through `dataSubjectRequests | operator_queue`, an application-wide read of personal data, so it needs an
|
|
301
|
+
* application-wide access grant a second platform administrator signed, and records every read, as the tenant
|
|
302
|
+
* directory does. So the destination shows nothing without an elevation, and says where to request one.
|
|
303
|
+
*/
|
|
304
|
+
APPLICATION_DATA_SUBJECT_REQUESTS = 'application-data-subject-requests',
|
|
285
305
|
/**
|
|
286
306
|
* The application-wide audit trail — every tenant's events plus the ones belonging to no tenant.
|
|
287
307
|
*
|
|
@@ -317,6 +337,16 @@ export enum EngineSettingsDestinationRef {
|
|
|
317
337
|
* a different entitlement and a different operator task.
|
|
318
338
|
*/
|
|
319
339
|
APPLICATION_INBOUND_DELIVERIES = 'application-inbound-deliveries',
|
|
340
|
+
/**
|
|
341
|
+
* Which of the application's SMS numbers belongs to which organization (#3394): the `smsNumberAssignments` rows that
|
|
342
|
+
* route a received text to its organization's SMS channel handler, with Assign (CREATE) and Withdraw (DELETE).
|
|
343
|
+
*
|
|
344
|
+
* Application-scope, super-admin, because every number sits in the APPLICATION's provider account: no organization can
|
|
345
|
+
* prove a number is its own, so the operator assigns, and an organization never claims (the email domain's
|
|
346
|
+
* organization-side {@link EMAIL_DOMAINS} has a DNS proof a number lacks). Shown only where the SMS capability is
|
|
347
|
+
* enabled, since a number assigned in an application that receives no texts routes nothing.
|
|
348
|
+
*/
|
|
349
|
+
APPLICATION_SMS_NUMBERS = 'application-sms-numbers',
|
|
320
350
|
/**
|
|
321
351
|
* Whether each declared retention period is being enforced (#1636): one record per retention-sweep run and
|
|
322
352
|
* bound resource — what it deleted under which period, what a hold kept, and how the run ended. Read-only;
|
|
@@ -346,6 +376,18 @@ export enum EngineSettingsDestinationRef {
|
|
|
346
376
|
* an organization's own suspensions are on {@link AGENT_POLICY}.
|
|
347
377
|
*/
|
|
348
378
|
APPLICATION_AGENT_POLICY = 'application-agent-policy',
|
|
379
|
+
/**
|
|
380
|
+
* The APPLICATION's OWN third-party accounts (#3398, #3579): the vendor account the whole deployment acts as toward a
|
|
381
|
+
* provider, which a super-administrator connects, sees the standing of, and disconnects.
|
|
382
|
+
*
|
|
383
|
+
* The third owner of the same feature, beside {@link PROVIDER_CREDENTIALS} (a tenant's) and
|
|
384
|
+
* {@link MY_PROVIDER_CREDENTIALS} (a person's), and never merged with either: the application's grant is spent by
|
|
385
|
+
* every tenant's call that the application makes as itself, so it is the operator's decision, and its rows have no
|
|
386
|
+
* resource route (`GET /connections/linked?ownerScope=application` lists them, `DELETE /connections/application/
|
|
387
|
+
* {connectionRef}` ends one). Super-admin, the role those routes and the connect start leg admit. The connection
|
|
388
|
+
* callback returns an application-owned connection here.
|
|
389
|
+
*/
|
|
390
|
+
APPLICATION_PROVIDER_CONNECTIONS = 'application-provider-connections',
|
|
349
391
|
/**
|
|
350
392
|
* The billing CATALOGUE the application sells — products, their prices, and promotions.
|
|
351
393
|
*
|
|
@@ -205,15 +205,12 @@ export interface SettingsDestination {
|
|
|
205
205
|
* destination the application does not place does not render, which is the whole
|
|
206
206
|
* point — "we should just place things", with no automatic inference.
|
|
207
207
|
*
|
|
208
|
-
* `label` is
|
|
209
|
-
*
|
|
210
|
-
*
|
|
211
|
-
*
|
|
212
|
-
*
|
|
213
|
-
*
|
|
214
|
-
* units: `LabellingTypes.SETTINGS_HUB` is declared with an empty pattern and the
|
|
215
|
-
* companion plans nothing for it, so today every rail label is the authored
|
|
216
|
-
* English string. R9 is a wiring job, not a new mechanism.
|
|
208
|
+
* `label` is the wording INTENT and the runtime fallback. The rail renders the
|
|
209
|
+
* `settings_hub.sections.<ref>.label` word when the bundle has one
|
|
210
|
+
* (`tSettingsHubSection`), and this string when it does not. The companion plans
|
|
211
|
+
* that key for every placed section (`collectSettingsHubLabelKeys`) and hands this
|
|
212
|
+
* string to label generation as the key's purpose, so a section is worded in every
|
|
213
|
+
* locale from what the application wrote here. Omitted, the fallback is the ref.
|
|
217
214
|
*/
|
|
218
215
|
export interface SettingsPlacement {
|
|
219
216
|
/** The {@link SettingsDestination.ref} being placed — an engine destination or one of `destinations`. Refused at DEV startup when unknown. */
|
|
@@ -293,6 +293,7 @@ export const specificationsCompanionExports: SpecificationsCompanionExports<
|
|
|
293
293
|
* reports a vendor-hosted provider a runtime selects that is not named here.
|
|
294
294
|
*/
|
|
295
295
|
processorRegister: applicationProcessorRegister,
|
|
296
|
+
translationGlossary,
|
|
296
297
|
};
|
|
297
298
|
```
|
|
298
299
|
|
|
@@ -125,6 +125,8 @@ export interface SpecificationsCompanionExports<
|
|
|
125
125
|
TBrandNameScreening = BrandNameScreening,
|
|
126
126
|
// Appended STRICTLY LAST: the firm's services and the method each case is worked by (#2305).
|
|
127
127
|
TServiceMethod = ServiceMethod,
|
|
128
|
+
// Appended STRICTLY LAST: the regimes research established for the product (#3362).
|
|
129
|
+
TCompliancePosture = CompliancePosture,
|
|
128
130
|
> {
|
|
129
131
|
resourceSpecifications: TResourceSpecifications;
|
|
130
132
|
applicationBusinessSemanticsSnapshot?: TBusinessSemanticsSnapshot;
|
|
@@ -629,8 +631,10 @@ export interface SpecificationsCompanionExports<
|
|
|
629
631
|
*/
|
|
630
632
|
documentationPlan?: TApplicationDocumentationPlan;
|
|
631
633
|
/**
|
|
632
|
-
* THE AUTHORED
|
|
633
|
-
*
|
|
634
|
+
* THE AUTHORED BODIES of chapters `documentationPlan` declares, written INLINE, keyed by `chapterRef` (#874), accepted
|
|
635
|
+
* by being committed. Optional: a chapter is normally written in its own file,
|
|
636
|
+
* `specifications/src/technical-documentation/chapters/<chapterRef>.ts`, which nothing wires here (#3204). The
|
|
637
|
+
* publication reads those files beside this set and merges them, refusing a chapter declared in both.
|
|
634
638
|
*
|
|
635
639
|
* Read by the documentation publication, which joins each body to its planned chapter and publishes
|
|
636
640
|
* it as a guide: a chapter the plan does not declare, and a `RESTRICTED` or unapproved one, is
|
|
@@ -641,6 +645,15 @@ export interface SpecificationsCompanionExports<
|
|
|
641
645
|
* positional parameter would only add a slot for every consumer to skip.
|
|
642
646
|
*/
|
|
643
647
|
documentationChapters?: ApplicationDocumentationChapterSet;
|
|
648
|
+
/**
|
|
649
|
+
* THE WORDS A PERSON CHOSE for this application's translations (#3105): glossary terms every translated string
|
|
650
|
+
* honours, and locked translations of single keys. Read by `wildo generate translate` on every run; parsed with
|
|
651
|
+
* `ApplicationTranslationGlossarySchema`, and a declaration that does not parse refuses the run rather than being
|
|
652
|
+
* ignored. Optional: absent means every word is the model's.
|
|
653
|
+
*
|
|
654
|
+
* Typed directly, like `documentationChapters`: no application narrows it.
|
|
655
|
+
*/
|
|
656
|
+
translationGlossary?: ApplicationTranslationGlossaryDeclaration;
|
|
644
657
|
/**
|
|
645
658
|
* WHAT RUNS BESIDE THE BACKEND — the application's workers and minions, what each is for, what a
|
|
646
659
|
* minion's tick may touch, and the providers this application binds (#1495). Read by
|
|
@@ -670,6 +683,12 @@ export interface SpecificationsCompanionExports<
|
|
|
670
683
|
* playbook `top_down.service-method`, or authored by hand; the domain plan and the build plan derive from it.
|
|
671
684
|
*/
|
|
672
685
|
serviceMethod?: TServiceMethod;
|
|
686
|
+
/**
|
|
687
|
+
* WHICH REGIMES research established for the product (#3362) — produced by `top_down.compliance-posture`, read by the
|
|
688
|
+
* compliance conception, the document facts, the compliance lane and the build decomposer. The vision keeps the
|
|
689
|
+
* creator's own compliance constraints; this carries the researched ones.
|
|
690
|
+
*/
|
|
691
|
+
compliancePosture?: TCompliancePosture;
|
|
673
692
|
/**
|
|
674
693
|
* Accepted application-declared semantic causality between whole
|
|
675
694
|
* specification-family states. This is not the registry's physical
|