@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,373 @@
|
|
|
1
|
+
# A workflow application's home
|
|
2
|
+
|
|
3
|
+
Read this when the application is a WORKFLOW tool — records that one person writes and other people decide (requests,
|
|
4
|
+
claims, expense reports, approvals) — and you are setting its home (`homeDefinitionFactory`), or the experience plan
|
|
5
|
+
gives the home `blocks`.
|
|
6
|
+
|
|
7
|
+
- the home of such an application is never a welcome page: it is where people find what waits on them;
|
|
8
|
+
- each block is the resource's own LIST, pinned to what the block is about, and drawn only for the people it is for;
|
|
9
|
+
- a pinned LIST lists everything unless the LIST declares the field it is pinned to (`filterFields`).
|
|
10
|
+
|
|
11
|
+
## What the home shows
|
|
12
|
+
|
|
13
|
+
The experience plan names the home's blocks. Three kinds, and every block answers one question for the person looking:
|
|
14
|
+
|
|
15
|
+
| block | the question | what it lists | drawn for |
|
|
16
|
+
|---|---|---|---|
|
|
17
|
+
| `AWAITING_DECISION` | what waits on MY decision? | the records waiting at a step a person takes after the record left its author (a department head's approval, finance's) | who may take that step: the transition's roles |
|
|
18
|
+
| `MY_RECORDS` | where do MY records stand? | the records the person raised (or is assigned), each with its status | who may create the resource |
|
|
19
|
+
| `KEY_FIGURE` | what do I check before acting? | the figure a decision depends on (this month's budget per department, what is overdue) | who may read it |
|
|
20
|
+
|
|
21
|
+
One `AWAITING_DECISION` block per step a person takes: a request that waits for a department head and then for
|
|
22
|
+
finance gets two blocks, each for its own deciders. A step the system performs awaits nobody and gets no block.
|
|
23
|
+
|
|
24
|
+
## How each block is built
|
|
25
|
+
|
|
26
|
+
A block is the resource's LIST, embedded, with `pinnedFilters` set on its operation context. The pin is sent on every
|
|
27
|
+
fetch, is never offered to the reader as a filter, and narrows INSIDE what the reader may read: the backend applies the
|
|
28
|
+
own-rows and organization-unit confinement first, so a pin cannot widen a reach. The block therefore reads exactly as
|
|
29
|
+
the list does everywhere else: its rows open the record page, and its status badges are the same ones.
|
|
30
|
+
|
|
31
|
+
- **Pin only declared filter fields.** A LIST filters by the fields its variant declares in `filterFields`, and IGNORES
|
|
32
|
+
every other filter it is sent: a block pinned to an undeclared field lists everything under its heading. Declare the
|
|
33
|
+
fields the home pins (`status`, the requester's id, the period) on the LIST, and check one block against the API.
|
|
34
|
+
- **Draw the block as its rows, not as a second list page.** Set `collectionToolbar: CollectionToolbarPresence.HIDDEN`
|
|
35
|
+
on the block's operation context, beside `pinnedFilters`: the block shows its rows and its pagination, and no
|
|
36
|
+
filter, sort, pills or Create of its own; the reader refines on the whole list the block links to. A preset pill
|
|
37
|
+
that assigns a pinned field is never offered anyway (the pin wins on that key, so the pill could not act).
|
|
38
|
+
- **Say what an empty block is about, in the home's words.** Pass `emptyStateWords: { title }` on the same context,
|
|
39
|
+
resolved from one of the home's own labels ("Nothing awaits your decision"): without it an empty block shows the
|
|
40
|
+
resource's generic title, and an approver's queue reads as a list of requests to raise. A hidden toolbar already
|
|
41
|
+
withholds the empty state's Create.
|
|
42
|
+
- **Pin who is looking from the session.** `useAppScope().currentUserId` is the person's id for a `MY_RECORDS` block.
|
|
43
|
+
- **Leave out of an `AWAITING_DECISION` block what the viewer cannot decide.** When the decision is withheld from the
|
|
44
|
+
record's author (the separation of duties: nobody approves their own request), the author's own record waits for
|
|
45
|
+
SOMEONE ELSE, and a block listing it offers a decision the viewer cannot take. A pin cannot say "not mine": it is an
|
|
46
|
+
equality. So each step gets a QUEUE: a LIST-like collection operation (`resourceOperationLike: LIST`, no filters, the
|
|
47
|
+
step is the queue) whose implementation lists the core LIST AS THE CALLER (a sub-call, so the own-rows and unit
|
|
48
|
+
narrowing hold) with the step's statuses and `{ <author field>: { $ne: <caller's id> } }` added from the execution
|
|
49
|
+
context. Embed it with `operationIdentifier` instead of `operationLike`. State "may decide" once (a predicate the
|
|
50
|
+
decision's `enabledCondition` also reads) so the queue lists exactly the records the action is offered on.
|
|
51
|
+
- **Give each queue its decision's roles, one queue per step.** The engine decides a list's reach (own rows, units)
|
|
52
|
+
from the roles at its gate. A single queue gated on every decider's roles answers with the WIDEST reach any of them
|
|
53
|
+
grants: a finance controller who also heads one department would list every department's records at the
|
|
54
|
+
department-head step, of which they may decide one. Share one role constant between the decision and its queue.
|
|
55
|
+
- **Do not filter rows in the browser** to drop what the viewer cannot decide: a page would come back short and the
|
|
56
|
+
count would include rows nobody sees.
|
|
57
|
+
- **Gate each block on the operation it is about.** `useViewerMayPerformResourceOperation` asks the shell's own role
|
|
58
|
+
decision (unit-scoped grants included): the decide transition for an `AWAITING_DECISION` block, CREATE for
|
|
59
|
+
`MY_RECORDS`, the LIST that holds the figure for `KEY_FIGURE`. A block the viewer may not use is not drawn, rather
|
|
60
|
+
than drawn and refused.
|
|
61
|
+
- **Link each block to its whole list.** A button under the block navigates to the LIST (`useNavigationController`,
|
|
62
|
+
with a LIST context built by `useCompositeResourceOperationContextBuilder`). Its words are a `labels` entry of the
|
|
63
|
+
composite view, documented in its specification.
|
|
64
|
+
- **Name each block in the specification.** Each `<Section name>` is a `sectionRefs` entry and a documented section of
|
|
65
|
+
the composite view's specification; the title says what the person does with it ("waiting for your decision"), not
|
|
66
|
+
what resource it is.
|
|
67
|
+
|
|
68
|
+
## Worked example
|
|
69
|
+
|
|
70
|
+
Wonder Procurement's home: two awaiting-decision blocks (department head, finance) that list the approvers' queues
|
|
71
|
+
(`list_awaiting_department_head`, `list_awaiting_finance`, which leave out the viewer's own requests), the person's own requests, and this month's
|
|
72
|
+
department budgets. Each block is gated by the operation it is about, and each list declares the fields its blocks pin
|
|
73
|
+
to.
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
## Usage Example
|
|
77
|
+
|
|
78
|
+
```typescript
|
|
79
|
+
export function decisionQueueCustomImplementation(queue: PurchaseRequest_DecisionQueue): ResourceCustomServiceImplementationFactory {
|
|
80
|
+
return (resourcesRegistryService: ResourcesRegistryBackendService) => {
|
|
81
|
+
const { operationPath, requestDtoSchema, responseDtoSchema } = transitionDtos(resourcesRegistryService, queue);
|
|
82
|
+
|
|
83
|
+
return createResourceCustomServiceImplementation<typeof requestDtoSchema, typeof responseDtoSchema>({
|
|
84
|
+
operationPath,
|
|
85
|
+
requestDtoSchema,
|
|
86
|
+
responseDtoSchema,
|
|
87
|
+
handlers: {
|
|
88
|
+
overrideAll: async (_id, input, executionContext, _operationPath, utils) => {
|
|
89
|
+
const caller = actingUserId(executionContext);
|
|
90
|
+
if (caller === undefined) {
|
|
91
|
+
// A machine principal decides nothing, so it has no queue; refusing is clearer than an empty page that reads "none".
|
|
92
|
+
throw utils.errorBuilder.buildError(ErrorType.AUTHORIZATION, executionContext, {
|
|
93
|
+
customMessageReference: ErrorCustomMessageReference.AUTHORIZATIONS_ACCESS_DENIED,
|
|
94
|
+
context: { message: 'Only a signed-in approver has requests awaiting their decision.' },
|
|
95
|
+
});
|
|
96
|
+
}
|
|
97
|
+
const collection = (input ?? {}) as CollectionInput;
|
|
98
|
+
const subCall = await utils.executionContextCreator.createForSubCall(
|
|
99
|
+
executionContext,
|
|
100
|
+
PurchaseRequests_ResourceType.PURCHASE_REQUESTS,
|
|
101
|
+
CoreResourceOperation.LIST,
|
|
102
|
+
utils.serviceOptions,
|
|
103
|
+
);
|
|
104
|
+
return utils.servicesRegistry.list<PurchaseRequests>(
|
|
105
|
+
PurchaseRequests_ResourceType.PURCHASE_REQUESTS,
|
|
106
|
+
subCall,
|
|
107
|
+
purchaseRequestsAwaitingDecisionQuery(queue, caller),
|
|
108
|
+
{ page: collection.page ?? collection.pagination?.page ?? 1, limit: collection.limit ?? collection.pagination?.limit ?? 20 },
|
|
109
|
+
{ paginated: true, ...(utils.serviceOptions?.dataMode ? { dataMode: utils.serviceOptions.dataMode } : {}) },
|
|
110
|
+
);
|
|
111
|
+
},
|
|
112
|
+
},
|
|
113
|
+
});
|
|
114
|
+
};
|
|
115
|
+
}
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Usage Example
|
|
119
|
+
|
|
120
|
+
```tsx
|
|
121
|
+
/**
|
|
122
|
+
* One home block: a section holding a list of what the block is about (a pinned LIST, or a queue), and a way to the whole
|
|
123
|
+
* list.
|
|
124
|
+
*
|
|
125
|
+
* The block lists the resource's core LIST, or the collection operation named by `listing` when the block's question
|
|
126
|
+
* is one no filter can ask. The approvers' queues are that case: "not raised by me" is not an equality, so each is a
|
|
127
|
+
* LIST-like operation that applies it on the server (`list_awaiting_department_head`, `list_awaiting_finance`). Either
|
|
128
|
+
* way, "Open the full list" goes to the core LIST, with its status tabs.
|
|
129
|
+
*
|
|
130
|
+
* The pin is a `FrontendResourceOperationContext.pinnedFilters` entry: sent on every fetch, never offered to the reader
|
|
131
|
+
* as a filter, and applied INSIDE what the reader may read (the own-rows and unit confinement run first on the backend,
|
|
132
|
+
* so a pin can only narrow). The pinned fields are the LIST's declared `filterFields`; an undeclared one would be ignored
|
|
133
|
+
* and the block would list everything.
|
|
134
|
+
*
|
|
135
|
+
* `collectionToolbar: HIDDEN` makes the block its rows and its pagination: a home block is read, and refined on the
|
|
136
|
+
* collection's own page (the link below), so it draws no filter, sort, pills or Create of its own (#3070). Empty, it
|
|
137
|
+
* says what the block is about in the home's own words (`emptyStateWords`), never the resource's generic title, and
|
|
138
|
+
* offers no Create (#3078).
|
|
139
|
+
*/
|
|
140
|
+
function HomeListBlock({
|
|
141
|
+
name,
|
|
142
|
+
resourceType,
|
|
143
|
+
listing,
|
|
144
|
+
pinnedFilters,
|
|
145
|
+
emptyLabelRef,
|
|
146
|
+
}: {
|
|
147
|
+
name: string;
|
|
148
|
+
resourceType: string;
|
|
149
|
+
/** A LIST-like collection operation to list instead of the core LIST (embedded, not addressable). */
|
|
150
|
+
listing?: string;
|
|
151
|
+
pinnedFilters?: Record<string, string>;
|
|
152
|
+
/** The home's own label saying what the block holds when it is empty (#3078): the resource's words cannot. */
|
|
153
|
+
emptyLabelRef: string;
|
|
154
|
+
}): React.JSX.Element {
|
|
155
|
+
const { buildResourceOperationContext } = useCompositeResourceOperationContextBuilder();
|
|
156
|
+
const { navigateToResource } = useNavigationController();
|
|
157
|
+
const { tCompositeView } = useI18n();
|
|
158
|
+
const pinKey = JSON.stringify(pinnedFilters ?? {});
|
|
159
|
+
|
|
160
|
+
const listContext = useMemo(
|
|
161
|
+
() => buildResourceOperationContext({ resourceType, operationLike: CoreResourceOperation.LIST }),
|
|
162
|
+
[buildResourceOperationContext, resourceType],
|
|
163
|
+
);
|
|
164
|
+
const blockContext = useMemo(
|
|
165
|
+
() => (listing ? buildResourceOperationContext({ resourceType, operationIdentifier: listing }) : listContext),
|
|
166
|
+
[buildResourceOperationContext, resourceType, listing, listContext],
|
|
167
|
+
);
|
|
168
|
+
const emptyTitle = tCompositeView(HOME_TRANSLATION_REF, emptyLabelRef);
|
|
169
|
+
const pinnedContext = useMemo(
|
|
170
|
+
() => ({
|
|
171
|
+
...blockContext,
|
|
172
|
+
pinnedFilters: JSON.parse(pinKey) as Record<string, string>,
|
|
173
|
+
collectionToolbar: CollectionToolbarPresence.HIDDEN,
|
|
174
|
+
emptyStateWords: { title: emptyTitle },
|
|
175
|
+
}),
|
|
176
|
+
[blockContext, pinKey, emptyTitle],
|
|
177
|
+
);
|
|
178
|
+
|
|
179
|
+
return (
|
|
180
|
+
<Section name={name} appearance={SectionMode.CARD}>
|
|
181
|
+
<EmbedResourceOperation resourceContext={pinnedContext} />
|
|
182
|
+
<div className="flex justify-end">
|
|
183
|
+
<Button
|
|
184
|
+
variant={ButtonVariants_Variant.LINK}
|
|
185
|
+
onClick={() => navigateToResource(listContext, { sourceZone: NavigationZoneName.PRIMARY, sourceOperation: CoreResourceOperation.LIST })}
|
|
186
|
+
>
|
|
187
|
+
{tCompositeView(HOME_TRANSLATION_REF, 'open_full_list')}
|
|
188
|
+
</Button>
|
|
189
|
+
</div>
|
|
190
|
+
</Section>
|
|
191
|
+
);
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
/**
|
|
195
|
+
* Wonder Procurement — the application's home (#3066).
|
|
196
|
+
*
|
|
197
|
+
* A workflow tool's home answers three questions before anything else, and each block answers one of them for the
|
|
198
|
+
* person looking — and is drawn only for the people it is for (`useViewerMayPerformResourceOperation`, the shell's own
|
|
199
|
+
* role decision, so a block never appears to someone the backend would refuse):
|
|
200
|
+
*
|
|
201
|
+
* | block | for whom | what it lists |
|
|
202
|
+
* |---|---|---|
|
|
203
|
+
* | `awaitingDepartmentHead` | who may take the department head's decision | `list_awaiting_department_head`: requests waiting at that step, within the departments they head, that they did not raise |
|
|
204
|
+
* | `awaitingFinance` | who may take finance's decision | `list_awaiting_finance`: requests waiting for finance that they did not raise |
|
|
205
|
+
* | `myRequests` | everyone who raises requests | the requests they raised, with where each stands |
|
|
206
|
+
* | `budgets` | who may read department budgets | this month's budget of each department they reach: allocated and committed |
|
|
207
|
+
*
|
|
208
|
+
* Every block is a list of the resource, pinned or a queue (see `HomeListBlock`), so a row opens the record page, a badge reads as
|
|
209
|
+
* it does everywhere else, and "Open the full list" goes to the list with its status tabs. The two "awaiting" blocks list
|
|
210
|
+
* their step's approvers' queue rather than the core LIST: a request the viewer raised waits for SOMEONE ELSE's decision
|
|
211
|
+
* (the decision actions are withheld from its requester), so it is left out of their queue; and each queue reaches only
|
|
212
|
+
* what its decision reaches, its roles being the decision's. The sections' words come
|
|
213
|
+
* from `composite_views.app.procurement-home.*`, documented in the composite view's specification.
|
|
214
|
+
*/
|
|
215
|
+
export function ProcurementHomeCompositeView(): React.JSX.Element {
|
|
216
|
+
const { currentUserId } = useAppScope();
|
|
217
|
+
const decidesAsDepartmentHead = useViewerMayPerformResourceOperation({
|
|
218
|
+
resourceType: PurchaseRequests_ResourceType.PURCHASE_REQUESTS,
|
|
219
|
+
operationIdentifier: PurchaseRequest_Operations.DECIDE_AS_DEPARTMENT_HEAD,
|
|
220
|
+
});
|
|
221
|
+
const decidesAsFinance = useViewerMayPerformResourceOperation({
|
|
222
|
+
resourceType: PurchaseRequests_ResourceType.PURCHASE_REQUESTS,
|
|
223
|
+
operationIdentifier: PurchaseRequest_Operations.DECIDE_AS_FINANCE,
|
|
224
|
+
});
|
|
225
|
+
const raisesRequests = useViewerMayPerformResourceOperation({
|
|
226
|
+
resourceType: PurchaseRequests_ResourceType.PURCHASE_REQUESTS,
|
|
227
|
+
operationIdentifier: CoreResourceOperation.CREATE,
|
|
228
|
+
});
|
|
229
|
+
const readsBudgets = useViewerMayPerformResourceOperation({
|
|
230
|
+
resourceType: Budgets_ResourceType.DEPARTMENT_BUDGETS,
|
|
231
|
+
operationIdentifier: CoreResourceOperation.LIST,
|
|
232
|
+
});
|
|
233
|
+
// The month the budgets block shows, in UTC like every budget period. Read once per render: the home is not left open
|
|
234
|
+
// across a month boundary long enough for a stale month to matter, and a reload reads the new one.
|
|
235
|
+
const currentPeriod = budgetPeriodOf(new Date());
|
|
236
|
+
|
|
237
|
+
return (
|
|
238
|
+
<CompositeLayout>
|
|
239
|
+
{decidesAsDepartmentHead && (
|
|
240
|
+
<HomeListBlock
|
|
241
|
+
name="awaitingDepartmentHead"
|
|
242
|
+
resourceType={PurchaseRequests_ResourceType.PURCHASE_REQUESTS}
|
|
243
|
+
listing={PurchaseRequest_Operations.LIST_AWAITING_DEPARTMENT_HEAD}
|
|
244
|
+
emptyLabelRef="empty_awaiting_decision"
|
|
245
|
+
/>
|
|
246
|
+
)}
|
|
247
|
+
{decidesAsFinance && (
|
|
248
|
+
<HomeListBlock
|
|
249
|
+
name="awaitingFinance"
|
|
250
|
+
resourceType={PurchaseRequests_ResourceType.PURCHASE_REQUESTS}
|
|
251
|
+
listing={PurchaseRequest_Operations.LIST_AWAITING_FINANCE}
|
|
252
|
+
emptyLabelRef="empty_awaiting_decision"
|
|
253
|
+
/>
|
|
254
|
+
)}
|
|
255
|
+
{raisesRequests && currentUserId && (
|
|
256
|
+
<HomeListBlock
|
|
257
|
+
name="myRequests"
|
|
258
|
+
resourceType={PurchaseRequests_ResourceType.PURCHASE_REQUESTS}
|
|
259
|
+
pinnedFilters={{ createdByUserId: currentUserId }}
|
|
260
|
+
emptyLabelRef="empty_my_requests"
|
|
261
|
+
/>
|
|
262
|
+
)}
|
|
263
|
+
{readsBudgets && (
|
|
264
|
+
<HomeListBlock
|
|
265
|
+
name="budgets"
|
|
266
|
+
resourceType={Budgets_ResourceType.DEPARTMENT_BUDGETS}
|
|
267
|
+
pinnedFilters={{ period: currentPeriod }}
|
|
268
|
+
emptyLabelRef="empty_budgets"
|
|
269
|
+
/>
|
|
270
|
+
)}
|
|
271
|
+
</CompositeLayout>
|
|
272
|
+
);
|
|
273
|
+
}
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
## Usage Example
|
|
277
|
+
|
|
278
|
+
```typescript
|
|
279
|
+
/** An approvers' queue: LIST-like, gated on its decision's own roles, answered by its implementation (see `PurchaseRequest_DecisionQueue`). */
|
|
280
|
+
function decisionQueueVariant(queue: PurchaseRequest_DecisionQueue) {
|
|
281
|
+
return {
|
|
282
|
+
variantType: ResourceOperationVariantType.API_CALL as const,
|
|
283
|
+
isDefault: true,
|
|
284
|
+
roles: [...PURCHASE_REQUEST_DECISION_ROLES[PURCHASE_REQUEST_DECISION_OF_QUEUE[queue]]],
|
|
285
|
+
riskLevel: ResourceOperationRiskLevel.LOW,
|
|
286
|
+
resourceOperationLike: CoreResourceOperation.LIST as const,
|
|
287
|
+
customServiceImplementationModes: [ResourceOperation_CustomServiceImplementationMode.OVERRIDE_ALL],
|
|
288
|
+
};
|
|
289
|
+
}
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
## Usage Example
|
|
293
|
+
|
|
294
|
+
```typescript
|
|
295
|
+
filterFields: {
|
|
296
|
+
status: z.enum(RequestStatus),
|
|
297
|
+
createdByUserId: z.string(),
|
|
298
|
+
organizationUnitId: z.string(),
|
|
299
|
+
supplierDirectoryEntryId: z.string(),
|
|
300
|
+
// A date filter becomes a `{ startDate, endDate }` range: the list's "needed this week" pill.
|
|
301
|
+
neededBy: z.date(),
|
|
302
|
+
},
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
## Usage Example
|
|
306
|
+
|
|
307
|
+
```typescript
|
|
308
|
+
[PurchaseRequest_Operations.LIST_AWAITING_DEPARTMENT_HEAD]: { variants: [decisionQueueVariant(PurchaseRequest_Operations.LIST_AWAITING_DEPARTMENT_HEAD)] },
|
|
309
|
+
[PurchaseRequest_Operations.LIST_AWAITING_FINANCE]: { variants: [decisionQueueVariant(PurchaseRequest_Operations.LIST_AWAITING_FINANCE)] },
|
|
310
|
+
```
|
|
311
|
+
|
|
312
|
+
## The role decision
|
|
313
|
+
|
|
314
|
+
## Import Origins
|
|
315
|
+
|
|
316
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
317
|
+
|
|
318
|
+
## Source Excerpts
|
|
319
|
+
|
|
320
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
321
|
+
|
|
322
|
+
```typescript
|
|
323
|
+
export interface ViewerResourceOperationQuery {
|
|
324
|
+
/** The resource the operation belongs to. */
|
|
325
|
+
resourceType: string;
|
|
326
|
+
/** The operation: a core one (`CoreResourceOperation.LIST`) or a custom one's identifier (`'decide_as_finance'`). */
|
|
327
|
+
operationIdentifier: CoreResourceOperation | string;
|
|
328
|
+
/** Narrows the answer to one keyed variant; omitted, every variant of the operation is asked. */
|
|
329
|
+
variantKey?: string;
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
/**
|
|
333
|
+
* Whether the signed-in viewer may perform the operation `query` names — for drawing a block of an app-level view (a
|
|
334
|
+
* home, a dashboard) only for the people it is for. Imported from `@wildo-ai/saas-frontend-lib`.
|
|
335
|
+
*
|
|
336
|
+
* It asks the shell's own role decision (`viewerMayPerformOperation`: the roles through their hierarchy, plus the
|
|
337
|
+
* backend's unit-narrowing grants), so a block appears exactly when the backend would admit its operation. `true` when
|
|
338
|
+
* ANY callable (`API_CALL`) variant admits the viewer (an administrator's keyed variant counts); `false` while the roles
|
|
339
|
+
* have not loaded, for an unregistered resource or operation, and for an internal variant whatever its roles say.
|
|
340
|
+
* Presentation only — the backend still decides every request.
|
|
341
|
+
*
|
|
342
|
+
* @example
|
|
343
|
+
* const decidesAsFinance = useViewerMayPerformResourceOperation({ resourceType: 'purchaseRequests', operationIdentifier: 'decide_as_finance' });
|
|
344
|
+
* return decidesAsFinance ? <Section name="awaitingFinance">…</Section> : null;
|
|
345
|
+
*/
|
|
346
|
+
export function useViewerMayPerformResourceOperation(query: ViewerResourceOperationQuery): boolean {
|
|
347
|
+
const registry = useResourceRegistrySafe()?.registry;
|
|
348
|
+
const viewer = useViewerEffectiveRoles();
|
|
349
|
+
const { resourceType, operationIdentifier, variantKey } = query;
|
|
350
|
+
return useMemo(() => {
|
|
351
|
+
const operations = registry?.resourceConfigurations?.[resourceType]?.operations as
|
|
352
|
+
| ReadonlyArray<{ operationIdentifier: unknown; variantType?: ResourceOperationVariantType; variantKey?: string; roles?: readonly string[]; resourceOperationLike?: unknown; admitsCrossTenantPlatformAdministration?: boolean }>
|
|
353
|
+
| undefined;
|
|
354
|
+
if (!operations) return false;
|
|
355
|
+
return operations
|
|
356
|
+
.filter((operation) => String(operation.operationIdentifier) === String(operationIdentifier))
|
|
357
|
+
.filter((operation) => variantKey === undefined || operation.variantKey === variantKey)
|
|
358
|
+
// Only a variant a person can call: an INTERNAL or repository-only variant has no route, whatever its roles say.
|
|
359
|
+
.filter((operation) => operation.variantType === undefined || URL_BEARING_OPERATION_VARIANT_TYPES.includes(operation.variantType))
|
|
360
|
+
.some((operation) => viewerMayPerformOperation({ ...operation, resourceType }, viewer));
|
|
361
|
+
}, [registry, resourceType, operationIdentifier, variantKey, viewer]);
|
|
362
|
+
}
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
## Verify
|
|
366
|
+
|
|
367
|
+
- Open `/` signed in as each role the blocks are for: each sees its blocks and no other.
|
|
368
|
+
- Raise a record as a person who also decides it, and submit it: it is in their `MY_RECORDS` block and NOT in their
|
|
369
|
+
`AWAITING_DECISION` block.
|
|
370
|
+
- Call the LIST with the pinned value as a query parameter (`?status=…`): the total changes. If it does not, the field
|
|
371
|
+
is not in the LIST's `filterFields`.
|
|
372
|
+
- `rg -n "pinnedFilters" frontend/src/modules/*/app-level-views` lists every block, and each pinned key appears in its
|
|
373
|
+
LIST's `filterFields` (`rg -n "filterFields" shared-lib/src/modules -A8`).
|
|
@@ -78,6 +78,13 @@ Add `dimensions:[{ ref, field }]` (the grouping axis) and
|
|
|
78
78
|
`measures:[{ ref, field, aggregate }]` (the value axis). Use
|
|
79
79
|
`AggregateFunction.*` (typed enum); never string literals.
|
|
80
80
|
|
|
81
|
+
A dimension with `timeGranularity` (day, week, month, hour, …) is cut in the
|
|
82
|
+
zone the person reading the chart reads dates in, and its labels follow, so
|
|
83
|
+
leave `dataQuery.timezone` unset. Set it only when the chart must read the same
|
|
84
|
+
for everyone (a business-day chart for one office). A dimension over a
|
|
85
|
+
date-only field (`.isCalendarDate()`, a due date) is cut by its calendar day
|
|
86
|
+
whoever reads it.
|
|
87
|
+
|
|
81
88
|
### Step 3: Wire series
|
|
82
89
|
|
|
83
90
|
`series:[{ ref, name, measureRef, splitByDimension }]` — `measureRef`
|
|
@@ -112,6 +119,8 @@ const backendModule: BackendDomainModule = {
|
|
|
112
119
|
myWeekTasksByStatusChartDefinition, myWeekTasksByPriorityChartDefinition,
|
|
113
120
|
// Org-wide todo analytics — surfaced on the Todos LIST host and the home dashboard.
|
|
114
121
|
todosByStatusChartDefinition, todosByPriorityChartDefinition, todosCreatedTimelineChartDefinition,
|
|
122
|
+
// Org-wide todo FIGURES (KPI charts, #2299) — the home dashboard's KPI tiles.
|
|
123
|
+
todosInFlightChartDefinition, todosCompletedChartDefinition, todosCompletionRateChartDefinition,
|
|
115
124
|
],
|
|
116
125
|
// Singleton config rows auto-seeded on resource lifecycle:
|
|
117
126
|
// - M2M outbound webhook config (per ORG / per APP) — app-specific dev-listener
|
|
@@ -130,6 +139,10 @@ const backendModule: BackendDomainModule = {
|
|
|
130
139
|
// A signed webhook from a client's system that creates a todo (#1596) — `POST /webhooks/app/todo-intake`;
|
|
131
140
|
// and an email to an organization's address that creates one and answers on the thread (#1600, #1630).
|
|
132
141
|
inboundHandlers: [todoIntakeInboundHandler, todoEmailIntakeHandler, todoEmailScreenedHandler, todoEmailScreeningHandler],
|
|
142
|
+
// NOT listed: `todoSmsStatusHandler` (`./inbound/todos.sms-status.inbound-channel-handler`, #3394), a member's todo
|
|
143
|
+
// status by text. An SMS channel handler stops the backend at startup while the SMS channel does not receive, and
|
|
144
|
+
// Your Application keeps the SMS capability off (no vendor account, 2026-10-02). Enabling SMS with a provider whose
|
|
145
|
+
// notification endpoint is served is the change that adds it here.
|
|
133
146
|
};
|
|
134
147
|
|
|
135
148
|
// NB: this module intentionally does not populate `customLabels`. The dev
|
|
@@ -162,13 +175,24 @@ If the chart only makes sense when scoped to a parent (e.g. tasks of
|
|
|
162
175
|
QUERY to that parent's rows. Without it the chart counts every row the caller
|
|
163
176
|
can see, and the numbers look plausible.
|
|
164
177
|
|
|
165
|
-
### Step 6:
|
|
178
|
+
### Step 6: A single figure is a KPI chart
|
|
179
|
+
|
|
180
|
+
A KPI tile (a count, a sum, a rate) is a chart too: `chartType: ChartType.KPI`, `dataQuery.dimensions: []`
|
|
181
|
+
(the backend answers one row for the whole scope), and exactly one series naming the figure's measure. A
|
|
182
|
+
filtered count is a measure with a `filter`; a rate is a computed measure (`completed / total * 100`).
|
|
183
|
+
`chartTypeConfig: { valueFormat: ChartKpiValueFormat.PERCENT, showProgress: true }` writes a percentage
|
|
184
|
+
with a bar. Declare and register it like any chart, and place it on a `ChartDashboard` (see the
|
|
185
|
+
`views-composite-authoring` skill). The definition refuses a KPI with a dimension or two series, and any
|
|
186
|
+
other chart type with no dimension.
|
|
166
187
|
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
188
|
+
### Step 6b: Reading the numbers without the chart
|
|
189
|
+
|
|
190
|
+
When code needs a chart's values rather than a rendering of them (a count in a sentence, a decision in a
|
|
191
|
+
custom view), read them with `useResourceChartData({ resourceType, viewRef })` from
|
|
192
|
+
`@wildo-ai/saas-frontend-lib`. It resolves the declared chart view and its scope. Do not call
|
|
170
193
|
`useChartData` with the bare `ChartDefinition`: that transport sends no scope, and an organization-scoped
|
|
171
|
-
chart is refused with `aggregation_scope_unresolved`.
|
|
194
|
+
chart is refused with `aggregation_scope_unresolved`. For a figure shown on a page, prefer a KPI chart
|
|
195
|
+
(Step 6): the backend computes it and the dashboard hides it from a viewer who may not read it. See
|
|
172
196
|
`references/framework-resource-chart-data-api.md`.
|
|
173
197
|
|
|
174
198
|
### Step 7: Spec
|
|
@@ -177,6 +201,12 @@ Update or add the chart spec under
|
|
|
177
201
|
`specifications/src/modules/<slug>/resources/<resource>/<chart-ref>.chart-view.specification.ts`.
|
|
178
202
|
Re-export from the chart spec barrel.
|
|
179
203
|
|
|
204
|
+
The spec's `textSlots` MUST document both `title` and `description`. The chart's launcher and overlay
|
|
205
|
+
labels are generated from both, so `resourceChartViewSpecificationFromDefinition(...)` refuses a chart
|
|
206
|
+
missing either when the specifications load, and the type (`ChartViewSpecificationTextSlots`) makes
|
|
207
|
+
the omission a `tsc` error. A chart refused at load is dropped from the specifications the companion
|
|
208
|
+
serves and named as a finding, and the build task that wrote it fails `check:specification-exports`.
|
|
209
|
+
|
|
180
210
|
## Worked Example
|
|
181
211
|
|
|
182
212
|
An application's `todo-task-status` chart on the `tasks` resource is
|
|
@@ -440,6 +470,7 @@ What is **not** in this block (and shouldn't be):
|
|
|
440
470
|
- [ ] Every chart declared in `chartViews` names a shared `ChartDefinition` constant, registered in its backend module's `chartDefinitions` (`wildo charts audit` passes)
|
|
441
471
|
- [ ] A chart scoped to a parent has a `PARENT_RESOURCE` entry in `dataQuery.contextFilters`, not only a MANDATORY parent requirement
|
|
442
472
|
- [ ] Spec id matches the runtime ref
|
|
473
|
+
- [ ] The chart spec's `textSlots` documents both `title` and `description`
|
|
443
474
|
- [ ] A chart that a sidebar or command-menu item launches declares `icon`
|
|
444
475
|
- [ ] Chart numbers read outside a chart use `useResourceChartData`, never a bare `useChartData(definition, ref)`
|
|
445
476
|
|
package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md
CHANGED
|
@@ -5,7 +5,7 @@ scoped exactly as the rendered chart is.
|
|
|
5
5
|
|
|
6
6
|
Read this when:
|
|
7
7
|
|
|
8
|
-
-
|
|
8
|
+
- code needs numbers derived from a chart (a count in a sentence, a decision in a custom view). A figure SHOWN as a tile is a `ChartType.KPI` chart on a `ChartDashboard` instead;
|
|
9
9
|
- you are about to call `useChartData` yourself — for a declared chart view, you almost certainly want
|
|
10
10
|
this hook instead;
|
|
11
11
|
- a hand-built chart fetch is refused with `aggregation_scope_unresolved`.
|
|
@@ -22,11 +22,13 @@ Read this when:
|
|
|
22
22
|
/**
|
|
23
23
|
* Read the DATA of a resource's declared chart view, scoped exactly as the rendered chart is.
|
|
24
24
|
*
|
|
25
|
-
* Import from `@wildo-ai/saas-frontend-lib`. Use it when
|
|
26
|
-
* canvas:
|
|
25
|
+
* Import from `@wildo-ai/saas-frontend-lib`. Use it when code needs a chart's numbers without its
|
|
26
|
+
* canvas: a summary sentence, a count on a badge, a decision in a custom view. A figure SHOWN as a tile
|
|
27
|
+
* is a `ChartType.KPI` chart on a `ChartDashboard` instead (#2299): the backend computes it and the
|
|
28
|
+
* dashboard hides it from a viewer who may not read it. It resolves the chart the way an
|
|
27
29
|
* embedded chart does. It finds the resource's `chartViews` entry, turns the entry's declared
|
|
28
30
|
* `primaryScope` (for example the organization) into context from the signed-in session, then
|
|
29
|
-
* fetches.
|
|
31
|
+
* fetches. Time buckets are cut in the zone the reader reads every other date in, as a rendered chart's are.
|
|
30
32
|
*
|
|
31
33
|
* Do not call `useChartData` with a bare `ChartDefinition` for this. That hook is the transport and
|
|
32
34
|
* sends only the context you pass it, so a chart scoped to an organization is refused by the
|
|
@@ -39,7 +41,7 @@ Read this when:
|
|
|
39
41
|
* @param params.viewRef - that chart view's `ref`
|
|
40
42
|
* @param params.contextResourceIdentifiers - context you already hold (a parent record's id); merged
|
|
41
43
|
* with what the chart's scope resolves
|
|
42
|
-
* @param params.localErrorOnly - `true` when your view shows the failure itself
|
|
44
|
+
* @param params.localErrorOnly - `true` when your view shows the failure itself, so no
|
|
43
45
|
* page-level error toast is raised
|
|
44
46
|
* @returns `{ data, loading, error, refetch }`; `data.data` holds one row per dimension value, keyed by
|
|
45
47
|
* the query's dimension and measure refs
|
|
@@ -66,6 +68,7 @@ export function useResourceChartData(params: {
|
|
|
66
68
|
}): ChartDataState {
|
|
67
69
|
const { resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, localErrorOnly = false } = params;
|
|
68
70
|
const { registry } = useResourceRegistry();
|
|
71
|
+
const { resolvedRegionalPreferences } = useI18n();
|
|
69
72
|
const chartView = registry.resourceConfigurations[resourceType]
|
|
70
73
|
?.frontendConfiguration
|
|
71
74
|
?.chartViews
|
|
@@ -97,6 +100,7 @@ export function useResourceChartData(params: {
|
|
|
97
100
|
runtime?.contextResourceIdentifiers,
|
|
98
101
|
urlParamValues,
|
|
99
102
|
localErrorOnly,
|
|
103
|
+
resolvedRegionalPreferences.timezone,
|
|
100
104
|
);
|
|
101
105
|
}
|
|
102
106
|
```
|
|
@@ -56,6 +56,9 @@ Two embed families exist and they are not interchangeable:
|
|
|
56
56
|
changes ownership context
|
|
57
57
|
- Adding a new entry to a `ResourceCompositeViewsConfig` /
|
|
58
58
|
`AppCompositeViewsConfig` map
|
|
59
|
+
- A dashboard of charts that several resources own (a home, an overview):
|
|
60
|
+
`ChartDashboard` / `defineChartDashboardView`, see
|
|
61
|
+
`references/framework-chart-dashboard-api.md`
|
|
59
62
|
|
|
60
63
|
## When NOT to Use
|
|
61
64
|
|
|
@@ -257,6 +260,7 @@ What is **not** in either block (and shouldn't be):
|
|
|
257
260
|
- `references/composite-embedding-checklist.md`
|
|
258
261
|
- `references/framework-composite-view-contracts-api.md` — source-backed composite view types & `defineCompositeView`
|
|
259
262
|
- `references/framework-inserted-view-identity-api.md` — source-backed inserted-view refs for embedded surfaces
|
|
263
|
+
- `references/framework-chart-dashboard-api.md` — source-backed `ChartDashboard` tiles and `defineChartDashboardView`: charts of several resources on one responsive grid (column cap, two-column and two-row tiles), each tile hidden from a viewer the chart's backend gate would refuse
|
|
260
264
|
|
|
261
265
|
## Verification
|
|
262
266
|
|