@wildo-ai/framework-knowledge 1.1.11 → 1.1.13
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 +180 -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 +30 -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 +87 -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 +55 -8
- 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 +19 -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/method.md +14 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +11 -7
- 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 +70 -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.config-wiring.retention-policy-operations.md +21 -0
- 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 +1 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +89 -10
- 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.engine-substance.md +38 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +11 -0
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +15 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +49 -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 +435 -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 +133 -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.chart-dashboard-tile-sizes.md +40 -0
- 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-content-guardrails-environment.md +52 -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-dashboard-layout.md +61 -0
- 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 +455 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2505 -1627
- 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 +90 -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 +240 -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 +78 -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 +13 -3
- 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 +34 -11
- 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 +188 -10
- 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 +447 -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 +13 -3
- 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 +13 -3
- 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/SKILL.md +1 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +6 -5
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +50 -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 +149 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-agent-content-guardrails-environment-api.md +67 -0
- 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 +1 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +89 -10
- 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 +272 -15
- 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 +34 -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 +28 -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 +371 -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 +2422 -723
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
|
@@ -12,11 +12,13 @@
|
|
|
12
12
|
/**
|
|
13
13
|
* Read the DATA of a resource's declared chart view, scoped exactly as the rendered chart is.
|
|
14
14
|
*
|
|
15
|
-
* Import from `@wildo-ai/saas-frontend-lib`. Use it when
|
|
16
|
-
* canvas:
|
|
15
|
+
* Import from `@wildo-ai/saas-frontend-lib`. Use it when code needs a chart's numbers without its
|
|
16
|
+
* canvas: a summary sentence, a count on a badge, a decision in a custom view. A figure SHOWN as a tile
|
|
17
|
+
* is a `ChartType.KPI` chart on a `ChartDashboard` instead (#2299): the backend computes it and the
|
|
18
|
+
* dashboard hides it from a viewer who may not read it. It resolves the chart the way an
|
|
17
19
|
* embedded chart does. It finds the resource's `chartViews` entry, turns the entry's declared
|
|
18
20
|
* `primaryScope` (for example the organization) into context from the signed-in session, then
|
|
19
|
-
* fetches.
|
|
21
|
+
* fetches. Time buckets are cut in the zone the reader reads every other date in, as a rendered chart's are.
|
|
20
22
|
*
|
|
21
23
|
* Do not call `useChartData` with a bare `ChartDefinition` for this. That hook is the transport and
|
|
22
24
|
* sends only the context you pass it, so a chart scoped to an organization is refused by the
|
|
@@ -29,7 +31,7 @@
|
|
|
29
31
|
* @param params.viewRef - that chart view's `ref`
|
|
30
32
|
* @param params.contextResourceIdentifiers - context you already hold (a parent record's id); merged
|
|
31
33
|
* with what the chart's scope resolves
|
|
32
|
-
* @param params.localErrorOnly - `true` when your view shows the failure itself
|
|
34
|
+
* @param params.localErrorOnly - `true` when your view shows the failure itself, so no
|
|
33
35
|
* page-level error toast is raised
|
|
34
36
|
* @returns `{ data, loading, error, refetch }`; `data.data` holds one row per dimension value, keyed by
|
|
35
37
|
* the query's dimension and measure refs
|
|
@@ -56,6 +58,7 @@ export function useResourceChartData(params: {
|
|
|
56
58
|
}): ChartDataState {
|
|
57
59
|
const { resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, localErrorOnly = false } = params;
|
|
58
60
|
const { registry } = useResourceRegistry();
|
|
61
|
+
const { resolvedRegionalPreferences } = useI18n();
|
|
59
62
|
const chartView = registry.resourceConfigurations[resourceType]
|
|
60
63
|
?.frontendConfiguration
|
|
61
64
|
?.chartViews
|
|
@@ -87,6 +90,7 @@ export function useResourceChartData(params: {
|
|
|
87
90
|
runtime?.contextResourceIdentifiers,
|
|
88
91
|
urlParamValues,
|
|
89
92
|
localErrorOnly,
|
|
93
|
+
resolvedRegionalPreferences.timezone,
|
|
90
94
|
);
|
|
91
95
|
}
|
|
92
96
|
```
|
|
@@ -20,9 +20,10 @@
|
|
|
20
20
|
* preset needs no filter grammar of its own and no backend change. A window may be open on one side:
|
|
21
21
|
* "before today" has no start, and the filter treats an absent bound as unbounded on every adapter.
|
|
22
22
|
*
|
|
23
|
-
* Every member is a span of WHOLE calendar days counted from today in the reader's resolved timezone
|
|
23
|
+
* Every member but one is a span of WHOLE calendar days counted from today in the reader's resolved timezone
|
|
24
24
|
* (member, then organization, then floor), which is the only one that makes "today" true for the person
|
|
25
|
-
* reading the screen, and the one the list's own date words use.
|
|
25
|
+
* reading the screen, and the one the list's own date words use. The exception is `BEFORE_NOW`, whose
|
|
26
|
+
* bound is the instant of the click (#2627); its own JSDoc says how it is read back. Over an instant field the window runs
|
|
26
27
|
* between that zone's midnights; over a calendar-day field (`isCalendarDate()`) it covers those calendar
|
|
27
28
|
* days, held as UTC midnights, so a due date is the same day for every reader. Both bounds are included,
|
|
28
29
|
* as the backend's range filter includes them, so the window ends one millisecond before the day after
|
|
@@ -48,12 +49,68 @@ export enum CollectionFilterPresetRelativeRange {
|
|
|
48
49
|
* same all day.
|
|
49
50
|
*/
|
|
50
51
|
BEFORE_TODAY = 'before_today',
|
|
52
|
+
/**
|
|
53
|
+
* Every instant BEFORE NOW: "overdue" for a deadline with a TIME of day (#2627). A callback promised for 10:00 is
|
|
54
|
+
* overdue at 10:01, which `BEFORE_TODAY` cannot say: its whole-day window ends at the last instant of yesterday.
|
|
55
|
+
*
|
|
56
|
+
* Resolved to a window with no start that ends at the instant the pill is clicked. Because that bound is not a day
|
|
57
|
+
* boundary, it cannot be read back by comparing bounds as the day-bound members are (the next render's `now` is a
|
|
58
|
+
* different instant): the pill instead reads as ON for any window of this KIND — no start, ending at an instant
|
|
59
|
+
* earlier today, no later than now. A window picked in the filters panel always ends at the last instant of a day,
|
|
60
|
+
* so the panel can never produce one, and "Overdue" by day and "Overdue" by the minute never read as each other.
|
|
61
|
+
* Like "created today", the pill goes off once the day it was clicked on has ended.
|
|
62
|
+
*
|
|
63
|
+
* Over a CALENDAR-DAY field (`isCalendarDate()`) it is `BEFORE_TODAY`: a date with no time is overdue only once
|
|
64
|
+
* its whole day has passed, so the last day before now that has ended is yesterday.
|
|
65
|
+
*/
|
|
66
|
+
BEFORE_NOW = 'before_now',
|
|
51
67
|
/** Today and the six calendar days after it, in the reader's calendar: "due this week" from today. */
|
|
52
68
|
NEXT_7_DAYS = 'next_7_days',
|
|
53
69
|
/** Today and the twenty-nine calendar days after it, in the reader's calendar. */
|
|
54
70
|
NEXT_30_DAYS = 'next_30_days',
|
|
55
71
|
}
|
|
56
72
|
|
|
73
|
+
/**
|
|
74
|
+
* A RANGE OF MONTHS named relative to the current month, for a preset on a year-month field (#3444): "This quarter" on a
|
|
75
|
+
* list of monthly budgets must still mean this quarter next month, so it cannot be an authored pair of months.
|
|
76
|
+
*
|
|
77
|
+
* It is the month-field counterpart of {@link CollectionFilterPresetRelativeRange} and resolves the same way: when the
|
|
78
|
+
* pill is clicked, counted from TODAY in the reader's resolved time zone (member, then organization, then floor), the
|
|
79
|
+
* today the list's own date words use. A year-month value (`z_yearMonth()`, `YYYY-MM`) is a calendar label rather than
|
|
80
|
+
* an instant, so the window is a pair of month labels, both included: exactly the `{ startMonth, endMonth }` value the
|
|
81
|
+
* filters panel's two month pickers write (`Resources_Filter_YearMonthRangeSchema`), so a pill and the same months
|
|
82
|
+
* picked by hand are one filter, and the backend needs no grammar of its own.
|
|
83
|
+
*
|
|
84
|
+
* A separate vocabulary rather than new members of the date one, because the two resolve to different VALUES for
|
|
85
|
+
* different field kinds: a date window is a pair of instants for a `z.date()` field, a month window is a pair of
|
|
86
|
+
* `YYYY-MM` labels for a year-month field, and a member meaning one cannot be applied to the other. Rejected: a
|
|
87
|
+
* parameterised `{ lastMonths: n }`. Each member below is a span a person asks for by name, and a closed set is the one
|
|
88
|
+
* place its words and its resolution can both be checked.
|
|
89
|
+
*
|
|
90
|
+
* Every member names BOTH bounds, so a window is never open: the rolling ones include the current month, as
|
|
91
|
+
* "the last 7 days" includes today.
|
|
92
|
+
*/
|
|
93
|
+
export enum CollectionFilterPresetRelativeMonthRange {
|
|
94
|
+
/** The current month. */
|
|
95
|
+
THIS_MONTH = 'this_month',
|
|
96
|
+
/** The month before the current one. */
|
|
97
|
+
LAST_MONTH = 'last_month',
|
|
98
|
+
/** The month after the current one: next month's budgets, planned ahead. */
|
|
99
|
+
NEXT_MONTH = 'next_month',
|
|
100
|
+
/** The calendar quarter holding the current month (January–March, April–June, July–September, October–December), all three months, the coming ones included. */
|
|
101
|
+
THIS_QUARTER = 'this_quarter',
|
|
102
|
+
/** The calendar quarter before the current one. */
|
|
103
|
+
LAST_QUARTER = 'last_quarter',
|
|
104
|
+
/** The current month and the two before it — a rolling quarter, including this month. */
|
|
105
|
+
LAST_3_MONTHS = 'last_3_months',
|
|
106
|
+
/** The current month and the eleven before it — a rolling year, including this month. */
|
|
107
|
+
LAST_12_MONTHS = 'last_12_months',
|
|
108
|
+
/** January of the current year through the current month. */
|
|
109
|
+
YEAR_TO_DATE = 'year_to_date',
|
|
110
|
+
/** January through December of the current year, the coming months included. */
|
|
111
|
+
THIS_YEAR = 'this_year',
|
|
112
|
+
}
|
|
113
|
+
|
|
57
114
|
/**
|
|
58
115
|
* A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
|
|
59
116
|
* viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
|
|
@@ -70,25 +127,35 @@ export enum CollectionFilterPresetContextValue {
|
|
|
70
127
|
/**
|
|
71
128
|
* What a preset ASSIGNS to one filter field.
|
|
72
129
|
*
|
|
73
|
-
*
|
|
130
|
+
* Split by WHEN the value is known:
|
|
74
131
|
*
|
|
75
132
|
* - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
|
|
76
|
-
* which is the whole of "filter to HIGH priority"
|
|
77
|
-
*
|
|
78
|
-
*
|
|
133
|
+
* which is the whole of "filter to HIGH priority". On a year-month field one `YYYY-MM` month is the range that starts
|
|
134
|
+
* and ends with it, and reads as the same filter as that range picked in the panel;
|
|
135
|
+
* - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case on a DATE field, resolved when the pill is clicked,
|
|
136
|
+
* because an authored answer would be wrong by tomorrow;
|
|
137
|
+
* - a RELATIVE MONTH RANGE (`{ relativeMonthRange }`) is the same case on a YEAR-MONTH field (#3444), resolved to the
|
|
138
|
+
* `{ startMonth, endMonth }` pair the panel's month pickers write;
|
|
79
139
|
* - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
|
|
80
140
|
* backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
|
|
81
141
|
* commonest threshold anyone asks for;
|
|
142
|
+
* - a MONTH RANGE (`{ startMonth?, endMonth? }`) is a fixed range of months, such as one fiscal year, written as the
|
|
143
|
+
* panel writes it;
|
|
82
144
|
* - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
|
|
83
145
|
* when the pill is clicked, so the same authored preset shows each viewer their own rows.
|
|
146
|
+
*
|
|
147
|
+
* The object members are STRICT. A stripping parse turned an authored `{ startMonth, endMonth }` into the numeric
|
|
148
|
+
* bound `{}` (#3444): a month range silently became "no bound", and the pill filtered nothing under its name.
|
|
84
149
|
*/
|
|
85
150
|
export const CollectionFilterPresetValueSchema = z.union([
|
|
86
151
|
z.string(),
|
|
87
152
|
z.number(),
|
|
88
153
|
z.boolean(),
|
|
89
|
-
z.
|
|
90
|
-
z.
|
|
91
|
-
z.
|
|
154
|
+
z.strictObject({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
|
|
155
|
+
z.strictObject({ relativeMonthRange: z.enum(CollectionFilterPresetRelativeMonthRange) }),
|
|
156
|
+
z.strictObject({ min: z.number().optional(), max: z.number().optional() }),
|
|
157
|
+
Resources_Filter_YearMonthRangeSchema,
|
|
158
|
+
z.strictObject({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
|
|
92
159
|
]);
|
|
93
160
|
export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
|
|
94
161
|
|
|
@@ -38,9 +38,9 @@ export type CommandMenuSearchResource = {
|
|
|
38
38
|
/** Resource type whose SEARCH operation is queried (e.g. `'todos'`). */
|
|
39
39
|
resourceType: string;
|
|
40
40
|
/**
|
|
41
|
-
* Group/category ref the results are placed under in the palette
|
|
42
|
-
*
|
|
43
|
-
*
|
|
41
|
+
* Group/category ref the results are placed under in the palette, headed through the same words as a static
|
|
42
|
+
* command's category (`command_categories.<category>.label` for the application's own ref, #3122). When omitted
|
|
43
|
+
* the group is the resource's, and is headed by the resource's own title (`resources.<type>.header.title`).
|
|
44
44
|
*/
|
|
45
45
|
category?: string;
|
|
46
46
|
/** Max results fetched per resource per keystroke. Defaults to 5. */
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# saas.frontend.errors.backend-refusal
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* A refusal the backend authored, as a frontend `catch` receives it: the fields the HTTP client adds to a rejected
|
|
14
|
+
* request when the backend answered with its error envelope. Narrow a caught value to it with the predicates below,
|
|
15
|
+
* all imported from `@wildo-ai/saas-frontend-lib`. Never use `isWildoBackendError` (from `@wildo-ai/saas-models`) in
|
|
16
|
+
* frontend code: it recognises the backend's own error object, which never crosses HTTP, so it is false for every
|
|
17
|
+
* refusal a view can catch.
|
|
18
|
+
*/
|
|
19
|
+
export interface BackendRefusal {
|
|
20
|
+
/** The response's HTTP status. */
|
|
21
|
+
readonly httpStatus: number;
|
|
22
|
+
/** The envelope's `type`. Its presence is what says the backend authored the refusal. */
|
|
23
|
+
readonly errorType: ErrorType;
|
|
24
|
+
/** The envelope's `customMessageReference`: the refusal's words in `errors_messages`. Absent on a bare envelope. */
|
|
25
|
+
readonly customMessageReference?: string;
|
|
26
|
+
/** Whether the refused request took effect, when the server knows (#3004). */
|
|
27
|
+
readonly requestOutcome?: ErrorRequestOutcome;
|
|
28
|
+
/** The envelope's sanitized `details` (an allow-listed `code`, `versionConflict`, `inForceReleases`, …). */
|
|
29
|
+
readonly context?: Readonly<Record<string, unknown>>;
|
|
30
|
+
/** Field-level validation errors, when the envelope names fields. */
|
|
31
|
+
readonly validationErrors?: Readonly<Record<string, unknown>>;
|
|
32
|
+
/** The `WildoError_Frontend` `handleHttpError` built from it, once retries are exhausted. */
|
|
33
|
+
readonly wildoError?: WildoError_Frontend;
|
|
34
|
+
/** Whether `handleHttpError` emitted it to the global error handler. */
|
|
35
|
+
readonly wildoErrorEventEmitted?: boolean;
|
|
36
|
+
}
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
40
|
+
|
|
41
|
+
```typescript
|
|
42
|
+
/**
|
|
43
|
+
* Whether a caught value is a refusal the backend authored: a rejected request whose response carried the backend's
|
|
44
|
+
* error envelope. False for a network failure, a cancellation, a timeout, a client-side error, and a response that is
|
|
45
|
+
* not the backend's envelope (a proxy's HTML 502).
|
|
46
|
+
*/
|
|
47
|
+
export function isBackendRefusal(error: unknown): error is BackendRefusal {
|
|
48
|
+
if (error === null || typeof error !== 'object') return false;
|
|
49
|
+
const candidate = error as { httpStatus?: unknown; errorType?: unknown };
|
|
50
|
+
return typeof candidate.httpStatus === 'number' && typeof candidate.errorType === 'string' && ERROR_TYPES.has(candidate.errorType);
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* The statuses that say "send it again later" (RFC 9110 §15.5.9 408; RFC 8470 425; RFC 6585 §4 429). Every other 4xx
|
|
55
|
+
* is a refusal that sending the same request again cannot change.
|
|
56
|
+
*/
|
|
57
|
+
export const RETRYABLE_CLIENT_ERROR_STATUSES: ReadonlySet<number> = new Set([408, 425, 429]);
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Whether sending the same request again cannot change the answer: a backend refusal with a 4xx status other than
|
|
61
|
+
* {@link RETRYABLE_CLIENT_ERROR_STATUSES}. A 5xx is the server failing, and may clear on its own.
|
|
62
|
+
*/
|
|
63
|
+
export function isFinalBackendRefusal(error: unknown): error is BackendRefusal {
|
|
64
|
+
return isBackendRefusal(error)
|
|
65
|
+
&& error.httpStatus >= 400 && error.httpStatus < 500
|
|
66
|
+
&& !RETRYABLE_CLIENT_ERROR_STATUSES.has(error.httpStatus);
|
|
67
|
+
}
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
71
|
+
|
|
72
|
+
```typescript
|
|
73
|
+
/**
|
|
74
|
+
* Whether the global error handler shows this error to the person as a notification: not silenced by the request
|
|
75
|
+
* (`suppressUserDisplay`), not hidden by the HTTP behaviour matrix (`showToUser`), and asking for a notification. The
|
|
76
|
+
* ONE statement of that rule: `GlobalErrorHandler` decides its toast with it.
|
|
77
|
+
*/
|
|
78
|
+
export function wildoErrorIsShownToUser(wildoError: Pick<WildoError_Frontend, 'showToUser' | 'suppressUserDisplay' | 'frontendActions'>): boolean {
|
|
79
|
+
if (wildoError.suppressUserDisplay === true || wildoError.showToUser === false) return false;
|
|
80
|
+
const actions = (wildoError.frontendActions ?? []) as readonly ErrorActionFrontend[];
|
|
81
|
+
return actions.includes(ErrorActionFrontend.NOTIFY) || actions.includes(ErrorActionFrontend.SHOW_TOAST);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/**
|
|
85
|
+
* Whether the person has already been told about this refusal by the global error handler, so the catch should
|
|
86
|
+
* restore its state and add nothing. Two cases count as told without a toast of this request's own: an identical
|
|
87
|
+
* error the handler suppressed as a duplicate (the first one was shown), and a refusal that ended the session, which
|
|
88
|
+
* the sign-in page explains.
|
|
89
|
+
*/
|
|
90
|
+
export function isBackendRefusalShownToUser(error: unknown): error is BackendRefusal {
|
|
91
|
+
return isBackendRefusal(error)
|
|
92
|
+
&& error.wildoErrorEventEmitted === true
|
|
93
|
+
&& error.wildoError !== undefined
|
|
94
|
+
&& wildoErrorIsShownToUser(error.wildoError);
|
|
95
|
+
}
|
|
96
|
+
```
|
|
@@ -88,6 +88,14 @@ export const ExecutionViewDefinitionSchema = z.object({
|
|
|
88
88
|
* stripped wherever the definition is Zod-parsed.
|
|
89
89
|
*/
|
|
90
90
|
icon: z.custom<IconLike>().optional(),
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* Zone geometry this view asks for when it is the PRIMARY destination — see
|
|
94
|
+
* {@link ResourceExecutionViewAuthoringConfig.zoneContentFillsHeight}. Declared on the schema as
|
|
95
|
+
* well as the interface so a parse of the compiled definition cannot strip the authored value.
|
|
96
|
+
*/
|
|
97
|
+
zoneContentMaxWidth: z.enum(RESPONSIVE_MAX_WIDTH_VALUES).optional(),
|
|
98
|
+
zoneContentFillsHeight: z.boolean().optional(),
|
|
91
99
|
});
|
|
92
100
|
|
|
93
101
|
/**
|
|
@@ -127,6 +135,10 @@ export interface ExecutionViewDefinition {
|
|
|
127
135
|
requiredFeatures?: RequiredFeaturesConfig;
|
|
128
136
|
/** View icon (lucide component reference or StandardIconReference string) for launcher surfaces. */
|
|
129
137
|
icon?: IconLike;
|
|
138
|
+
/** See {@link ResourceExecutionViewAuthoringConfig.zoneContentMaxWidth}. Mirrored from authoring. */
|
|
139
|
+
zoneContentMaxWidth?: ResponsiveMaxWidth;
|
|
140
|
+
/** See {@link ResourceExecutionViewAuthoringConfig.zoneContentFillsHeight}. Mirrored from authoring. */
|
|
141
|
+
zoneContentFillsHeight?: boolean;
|
|
130
142
|
}
|
|
131
143
|
|
|
132
144
|
export const EXECUTION_ROUTE_CONTEXT_QUERY_PARAM_PREFIX = 'execution_ctx_';
|
|
@@ -162,6 +174,34 @@ export interface ResourceExecutionViewAuthoringConfig {
|
|
|
162
174
|
* resourceExecutionView(MyFlowView, { icon: ListChecks, surfaceInOperations: [Op.READ] });
|
|
163
175
|
*/
|
|
164
176
|
icon: IconLike;
|
|
177
|
+
/**
|
|
178
|
+
* How wide this view's content may grow when it occupies the PRIMARY zone, in the framework's
|
|
179
|
+
* shared width vocabulary — the same `ResponsiveMaxWidth` a composite view declares.
|
|
180
|
+
*
|
|
181
|
+
* Omitted is `'content'`: capped and centred at the page-content width. A canvas whose value is the
|
|
182
|
+
* space it occupies declares `'none'`.
|
|
183
|
+
*/
|
|
184
|
+
zoneContentMaxWidth?: ResponsiveMaxWidth;
|
|
185
|
+
/**
|
|
186
|
+
* Whether this view's content fills the PRIMARY zone's height as well.
|
|
187
|
+
*
|
|
188
|
+
* `true` makes the zone's content boundary a definite-height flex column, so the view's root can
|
|
189
|
+
* use `flex-1 min-h-0` and size a canvas against the zone instead of naming a pixel height. Ignored
|
|
190
|
+
* in an adjacent zone, which scrolls.
|
|
191
|
+
*
|
|
192
|
+
* It belongs HERE and not on the host operation: an execution view is its own destination, reached
|
|
193
|
+
* from a launcher on the record (and by deep link), so the host READ page never contains it and a
|
|
194
|
+
* declaration there cannot reach it (#1259).
|
|
195
|
+
*
|
|
196
|
+
* @example
|
|
197
|
+
* resourceExecutionView(MyFlowView, {
|
|
198
|
+
* icon: ListChecks,
|
|
199
|
+
* surfaceInOperations: [Op.READ],
|
|
200
|
+
* zoneContentMaxWidth: 'none',
|
|
201
|
+
* zoneContentFillsHeight: true,
|
|
202
|
+
* });
|
|
203
|
+
*/
|
|
204
|
+
zoneContentFillsHeight?: boolean;
|
|
165
205
|
}
|
|
166
206
|
|
|
167
207
|
export type ResourceExecutionViewsConfig = Record<string, ResourceExecutionViewAuthoringConfig>;
|
|
@@ -166,6 +166,10 @@ export type SidebarItem = LauncherItemRef & {
|
|
|
166
166
|
|
|
167
167
|
/** A command menu entry. */
|
|
168
168
|
export type CommandMenuCommand = LauncherItemRef & {
|
|
169
|
+
/**
|
|
170
|
+
* The group the command sits under. One of `CommandMenuEngineCategory`, headed by the engine's words, or the
|
|
171
|
+
* application's own ref, headed by `command_categories.<category>.label` (#3122).
|
|
172
|
+
*/
|
|
169
173
|
category?: string;
|
|
170
174
|
shortcut?: string;
|
|
171
175
|
/**
|
|
@@ -41,18 +41,16 @@ export function EmbedLinkedConversations({ className }: EmbedLinkedConversations
|
|
|
41
41
|
{ hostResourceType },
|
|
42
42
|
);
|
|
43
43
|
}
|
|
44
|
-
|
|
44
|
+
// Threads are linked by type and id, not by a relationship, so this embed confines them itself (#3072).
|
|
45
|
+
return compositeResourceContext.buildOperationContext({
|
|
45
46
|
resourceType: CoreResourceType.CONVERSATION_THREADS,
|
|
46
47
|
operationLike: CoreResourceOperation.LIST,
|
|
47
48
|
requireAddressable: false,
|
|
48
|
-
});
|
|
49
|
-
return {
|
|
50
|
-
...threads,
|
|
51
49
|
pinnedFilters: {
|
|
52
50
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
|
|
53
51
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
|
|
54
52
|
},
|
|
55
|
-
};
|
|
53
|
+
});
|
|
56
54
|
}, [compositeResourceContext, hostResourceType, hostResourceId]);
|
|
57
55
|
|
|
58
56
|
return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# saas.frontend.record-page-parts
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
export interface RecordKeepingFactsProps {
|
|
13
|
+
/** Additional CSS classes for the line (placement only). */
|
|
14
|
+
className?: string;
|
|
15
|
+
/** The record-keeping fields: `<DisplayField name="createdByUserId" />`, `<DisplayField name="createdAt" />`, … */
|
|
16
|
+
children?: ReactNode;
|
|
17
|
+
}
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* Who made the record and when — the facts the FRAMEWORK writes (the creator it stamps, `createdAt`,
|
|
21
|
+
* `updatedAt`) — as one quiet line of "Name: value" pairs beneath a hairline, closing the record page.
|
|
22
|
+
*
|
|
23
|
+
* They answer a question asked after the others, so they are not tiles beside what the record says: set as
|
|
24
|
+
* tiles, a request's "Created" and "Last updated" weighed exactly as much as what was being bought. Use it at
|
|
25
|
+
* the end of a `layout.display` template, or let the generated read view place it (it gathers exactly the
|
|
26
|
+
* fields the framework writes).
|
|
27
|
+
*
|
|
28
|
+
* @example
|
|
29
|
+
* ```tsx
|
|
30
|
+
* <RecordKeepingFacts>
|
|
31
|
+
* <DisplayField name="createdByUserId" />
|
|
32
|
+
* <DisplayField name="createdAt" />
|
|
33
|
+
* <DisplayField name="updatedAt" />
|
|
34
|
+
* </RecordKeepingFacts>
|
|
35
|
+
* ```
|
|
36
|
+
*/
|
|
37
|
+
export function RecordKeepingFacts({ className, children }: RecordKeepingFactsProps): ReactNode {
|
|
38
|
+
const { displayChromeMode } = useDisplayChromeContext();
|
|
39
|
+
return (
|
|
40
|
+
<DisplayChromeProvider displayChromeMode={displayChromeMode} sectionChromeMode={DisplayChromeMode.INLINE}>
|
|
41
|
+
<div
|
|
42
|
+
data-slot="record-keeping-facts"
|
|
43
|
+
// A hairline in the theme's border colour, then the pairs in a wrapping row. SECONDARY by size and ink, which
|
|
44
|
+
// the line imposes on everything inside it (`[&_*]:…`): the values' own voices (DATA at the body size, in the
|
|
45
|
+
// full ink) would otherwise weigh exactly as much as the record's facts above — a size set on this element
|
|
46
|
+
// alone changes nothing, every value sets its own. `[&>*]:w-auto` keeps the pairs on one line (a field
|
|
47
|
+
// chrome's root is `w-full`); `[&:not(:has(*))]:hidden` drops the line and its hairline when every pair is empty.
|
|
48
|
+
// The muted ink reaches EVERYTHING inside, a link or a pill included: right for a creator and dates, which is what
|
|
49
|
+
// this line is for; a value that must keep its own colour belongs among the facts instead.
|
|
50
|
+
className={cn(
|
|
51
|
+
'flex min-w-0 flex-wrap items-baseline gap-x-group gap-y-item border-t border-border pt-element text-xs text-foreground-subtle [&_*]:text-xs [&_*]:text-foreground-subtle [&>*]:w-auto [&:not(:has(*))]:hidden',
|
|
52
|
+
className,
|
|
53
|
+
)}
|
|
54
|
+
>
|
|
55
|
+
{children}
|
|
56
|
+
</div>
|
|
57
|
+
</DisplayChromeProvider>
|
|
58
|
+
);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
RecordKeepingFacts.displayName = 'RecordKeepingFacts';
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
65
|
+
|
|
66
|
+
```tsx
|
|
67
|
+
export interface RecordStateProps {
|
|
68
|
+
/** Additional CSS classes for the row (placement only — the markers' look is the theme's). */
|
|
69
|
+
className?: string;
|
|
70
|
+
/** The record's state marker: `<DisplayField name="status" labelPlacement="hidden" />`. */
|
|
71
|
+
children?: ReactNode;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
* Where a record STANDS, on one line at the top of its page: its status, shown as its pill (`EnumDisplayMode.BADGE`)
|
|
76
|
+
* without a "Status:" label.
|
|
77
|
+
*
|
|
78
|
+
* A status is the first thing anyone opening a record needs ("is it waiting for me?"), so it is not one tile
|
|
79
|
+
* among the facts. Give each field `labelPlacement="hidden"`: the name stays available to assistive technology
|
|
80
|
+
* and the pill speaks for itself on screen. Use it at the top of a `layout.display` template, or let the
|
|
81
|
+
* generated read view place it (the first enum the resource shows as a pill; any other enum keeps its name among the
|
|
82
|
+
* facts, where a bare "Manual" or "Retain" cannot mean anything on its own).
|
|
83
|
+
*
|
|
84
|
+
* If the resource authors a `layout.header`, put the state markers THERE instead (on the header's facts line),
|
|
85
|
+
* and keep them out of the body: every fact is shown once.
|
|
86
|
+
*
|
|
87
|
+
* @example
|
|
88
|
+
* ```tsx
|
|
89
|
+
* display: () => (
|
|
90
|
+
* <DisplayLayout>
|
|
91
|
+
* <RecordState>
|
|
92
|
+
* <DisplayField name="status" labelPlacement="hidden" />
|
|
93
|
+
* </RecordState>
|
|
94
|
+
* <FieldTiles>…</FieldTiles>
|
|
95
|
+
* <RecordKeepingFacts>…</RecordKeepingFacts>
|
|
96
|
+
* </DisplayLayout>
|
|
97
|
+
* ),
|
|
98
|
+
* ```
|
|
99
|
+
*/
|
|
100
|
+
export function RecordState({ className, children }: RecordStateProps): ReactNode {
|
|
101
|
+
const { displayChromeMode } = useDisplayChromeContext();
|
|
102
|
+
return (
|
|
103
|
+
<DisplayChromeProvider displayChromeMode={displayChromeMode} sectionChromeMode={DisplayChromeMode.HIDDEN}>
|
|
104
|
+
<div
|
|
105
|
+
data-slot="record-state"
|
|
106
|
+
// `[&>*]:w-auto`: a field chrome's root is `w-full`, which would stack the markers one per line.
|
|
107
|
+
// `empty:hidden`: a record whose markers are all empty leaves no gap.
|
|
108
|
+
className={cn('flex min-w-0 flex-wrap items-center gap-x-group gap-y-item [&>*]:w-auto empty:hidden', className)}
|
|
109
|
+
>
|
|
110
|
+
{children}
|
|
111
|
+
</div>
|
|
112
|
+
</DisplayChromeProvider>
|
|
113
|
+
);
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
RecordState.displayName = 'RecordState';
|
|
117
|
+
```
|
|
@@ -95,18 +95,16 @@ export function EmbedLinkedConversations({ className }: EmbedLinkedConversations
|
|
|
95
95
|
{ hostResourceType },
|
|
96
96
|
);
|
|
97
97
|
}
|
|
98
|
-
|
|
98
|
+
// Threads are linked by type and id, not by a relationship, so this embed confines them itself (#3072).
|
|
99
|
+
return compositeResourceContext.buildOperationContext({
|
|
99
100
|
resourceType: CoreResourceType.CONVERSATION_THREADS,
|
|
100
101
|
operationLike: CoreResourceOperation.LIST,
|
|
101
102
|
requireAddressable: false,
|
|
102
|
-
});
|
|
103
|
-
return {
|
|
104
|
-
...threads,
|
|
105
103
|
pinnedFilters: {
|
|
106
104
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
|
|
107
105
|
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
|
|
108
106
|
},
|
|
109
|
-
};
|
|
107
|
+
});
|
|
110
108
|
}, [compositeResourceContext, hostResourceType, hostResourceId]);
|
|
111
109
|
|
|
112
110
|
return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
|
|
@@ -151,37 +149,67 @@ export function EmbedExecutionDecisions({ executionId, className }: EmbedExecuti
|
|
|
151
149
|
{ hostResourceType },
|
|
152
150
|
);
|
|
153
151
|
}
|
|
154
|
-
|
|
152
|
+
// A decision names its run by reference, not by a relationship, so this embed confines them itself (#3072).
|
|
153
|
+
return compositeResourceContext.buildOperationContext({
|
|
155
154
|
resourceType: decisionsResourceType,
|
|
156
155
|
operationLike: CoreResourceOperation.LIST,
|
|
157
156
|
requireAddressable: false,
|
|
158
|
-
});
|
|
159
|
-
return {
|
|
160
|
-
...decisions,
|
|
161
157
|
pinnedFilters: {
|
|
162
158
|
[AGENT_WORK_DECISION_EXECUTION_FILTER.KIND]: ExecutionRefKind.CONVERSATIONAL_EXECUTION,
|
|
163
159
|
[AGENT_WORK_DECISION_EXECUTION_FILTER.ID]: executionId,
|
|
164
160
|
},
|
|
165
|
-
};
|
|
161
|
+
});
|
|
166
162
|
}, [compositeResourceContext, hostResourceType, executionId]);
|
|
167
163
|
|
|
168
164
|
return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
|
|
169
165
|
}
|
|
170
166
|
|
|
167
|
+
const warnedUnlistableRelatedResources = new Set<string>();
|
|
168
|
+
|
|
169
|
+
/** Loud, once per (host, target): the author asked about a LIST this host cannot embed, and its section will not draw. */
|
|
170
|
+
function warnUnlistableRelatedResource(hostResourceType: string, resourceType: string, reason: string | undefined): void {
|
|
171
|
+
const key = `${hostResourceType}::${resourceType}`;
|
|
172
|
+
if (warnedUnlistableRelatedResources.has(key)) return;
|
|
173
|
+
warnedUnlistableRelatedResources.add(key);
|
|
174
|
+
LoggerFrontendService.getLogger().warn(
|
|
175
|
+
`[related-resource-list] the "${resourceType}" LIST cannot be embedded on "${hostResourceType}", so a section `
|
|
176
|
+
+ `asking whether the viewer may read it is not drawn.${reason ? ` ${reason}` : ''}`,
|
|
177
|
+
);
|
|
178
|
+
}
|
|
179
|
+
|
|
171
180
|
/**
|
|
172
181
|
* May this viewer run the LIST of `resourceType` from the host record (#2589)? The roles the LIST declares, asked the way
|
|
173
182
|
* the shell asks of any operation it offers (`viewerMayPerformOperation`). For a host that draws a titled section around
|
|
174
183
|
* an embed: a section whose list the viewer may not read is not drawn at all, rather than as an empty heading or an
|
|
175
184
|
* error. Presentation only: the backend still decides every request.
|
|
176
185
|
*/
|
|
177
|
-
export function useViewerMayListRelatedResource(
|
|
186
|
+
export function useViewerMayListRelatedResource(
|
|
187
|
+
resourceType: string,
|
|
188
|
+
/**
|
|
189
|
+
* The filters the caller confines the list by itself, when no relationship does (see `pinnedFilters` on the target).
|
|
190
|
+
* `null` when they are not known yet (the record they come from is still loading): the answer is `false`, without
|
|
191
|
+
* asking, so a list that will be pinned is not judged — and warned about — unpinned in the meantime.
|
|
192
|
+
*/
|
|
193
|
+
pinnedFilters?: Readonly<Record<string, string>> | null,
|
|
194
|
+
): boolean {
|
|
178
195
|
const compositeResourceContext = useEmbeddedResourceContext();
|
|
179
196
|
const viewer = useViewerEffectiveRoles();
|
|
197
|
+
const pinKey = pinnedFilters ? JSON.stringify(pinnedFilters) : '';
|
|
180
198
|
return useMemo(() => {
|
|
181
|
-
|
|
199
|
+
if (pinnedFilters === null) return false;
|
|
200
|
+
// A LIST that cannot be embedded on this host — one nothing could confine to the host record (#3072) — is one the
|
|
201
|
+
// viewer cannot read HERE, whatever their roles: answered `false` rather than thrown from a hook that only asks.
|
|
202
|
+
let list: ReturnType<typeof compositeResourceContext.buildOperationContext>;
|
|
203
|
+
try {
|
|
204
|
+
list = compositeResourceContext.buildOperationContext({ resourceType, operationLike: CoreResourceOperation.LIST, requireAddressable: false, pinnedFilters: pinnedFilters ? JSON.parse(pinKey) as Record<string, string> : undefined });
|
|
205
|
+
} catch (error) {
|
|
206
|
+
warnUnlistableRelatedResource(compositeResourceContext.hostResourceType, resourceType, describeEmbedRefusal(error));
|
|
207
|
+
return false;
|
|
208
|
+
}
|
|
182
209
|
const operation = list.operation as unknown as { roles?: readonly string[]; operationIdentifier: unknown; resourceOperationLike?: unknown };
|
|
183
210
|
return viewerMayPerformOperation({ ...operation, resourceType }, viewer);
|
|
184
|
-
|
|
211
|
+
// eslint-disable-next-line react-hooks/exhaustive-deps -- the pins are keyed by value (`pinKey`)
|
|
212
|
+
}, [compositeResourceContext, resourceType, viewer, pinKey, pinnedFilters === null]);
|
|
185
213
|
}
|
|
186
214
|
|
|
187
215
|
/**
|
|
@@ -199,7 +227,7 @@ function useRepresentationPinnedList(params: {
|
|
|
199
227
|
const compositeResourceContext = useEmbeddedResourceContext();
|
|
200
228
|
const { hostResourceType } = compositeResourceContext;
|
|
201
229
|
const { embedName, resourceType, pinnedFilters } = params;
|
|
202
|
-
const viewerMayList = useViewerMayListRelatedResource(resourceType);
|
|
230
|
+
const viewerMayList = useViewerMayListRelatedResource(resourceType, pinnedFilters);
|
|
203
231
|
const pinKey = JSON.stringify(pinnedFilters);
|
|
204
232
|
return useMemo((): FrontendResourceOperationContext | null => {
|
|
205
233
|
if (hostResourceType !== CoreResourceType.ORGANIZATION_REPRESENTATIONS) {
|
|
@@ -209,8 +237,10 @@ function useRepresentationPinnedList(params: {
|
|
|
209
237
|
);
|
|
210
238
|
}
|
|
211
239
|
if (!viewerMayList) return null;
|
|
212
|
-
|
|
213
|
-
return
|
|
240
|
+
// The relationship's own filter, given by the caller: a mailbox names the relationship, not this representation.
|
|
241
|
+
return compositeResourceContext.buildOperationContext({
|
|
242
|
+
resourceType, operationLike: CoreResourceOperation.LIST, requireAddressable: false, pinnedFilters: JSON.parse(pinKey) as Record<string, string>,
|
|
243
|
+
});
|
|
214
244
|
}, [compositeResourceContext, hostResourceType, viewerMayList, embedName, resourceType, pinKey]);
|
|
215
245
|
}
|
|
216
246
|
|
|
@@ -26,6 +26,12 @@ export interface RelatedResourceSectionsProps {
|
|
|
26
26
|
* DISPLAYED row does not satisfy is omitted, silently, exactly as automatic composition omits it: a
|
|
27
27
|
* recurring todo's occurrences section appears only on a recurring todo. Inside a display template a
|
|
28
28
|
* constrained target waits for the row to load; with no display template there is no row to judge.
|
|
29
|
+
*
|
|
30
|
+
* Each collection lists the HOST RECORD's rows, never more (#3072): through a route naming the record (the runtime
|
|
31
|
+
* selects the route under the record when the page's context would not), else by pinning the edge's foreign key
|
|
32
|
+
* when the target's operation admits it as a filter. A target nothing can confine — no relationship to the host, a
|
|
33
|
+
* `viaForeignKey` naming no live edge, two edges and no choice — is omitted with a warning naming the
|
|
34
|
+
* cause, rather than listing every row the reader may read.
|
|
29
35
|
*/
|
|
30
36
|
targets: ReadonlyArray<RelatedResourceSectionTarget | string>;
|
|
31
37
|
/** How the sections arrange — the real section vocabulary, not a serializable subset. */
|
|
@@ -110,7 +110,7 @@ export function ResourceHeaderTitle({ className }: ResourceHeaderTitleProps): Re
|
|
|
110
110
|
* <div className="flex min-w-0 flex-wrap items-center gap-field">
|
|
111
111
|
* <ResourceHeaderLeading><span className="size-3 rounded-full" style={{ background: color }} /></ResourceHeaderLeading>
|
|
112
112
|
* <ResourceHeaderTitle />
|
|
113
|
-
* <DisplayField name="status"
|
|
113
|
+
* <DisplayField name="status" labelPlacement="hidden" hideDescription className="w-auto" />
|
|
114
114
|
* </div>
|
|
115
115
|
* ),
|
|
116
116
|
* ```
|