@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
|
@@ -0,0 +1,67 @@
|
|
|
1
|
+
# What an `enabledCondition` receives
|
|
2
|
+
|
|
3
|
+
Read this when you write a transition's `enabledCondition`, and in particular when the transition is not only a matter
|
|
4
|
+
of the record's state but also of WHO is asking:
|
|
5
|
+
|
|
6
|
+
- only the person who raised the record may submit, edit or withdraw it;
|
|
7
|
+
- nobody may approve or decide a record they raised themselves;
|
|
8
|
+
- a condition reads a field that is not shown in the list (then declare it in `enabledConditionFields`).
|
|
9
|
+
|
|
10
|
+
The same function is called twice: by the frontend, to decide whether to offer the action on a list row or a record
|
|
11
|
+
page, and by the backend, before the operation runs. A transition whose handler refuses something its condition does
|
|
12
|
+
not say is offered and then refused.
|
|
13
|
+
|
|
14
|
+
## Import Origins
|
|
15
|
+
|
|
16
|
+
- `@wildo-ai/saas-models`
|
|
17
|
+
|
|
18
|
+
## Source Excerpts
|
|
19
|
+
|
|
20
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
21
|
+
|
|
22
|
+
```typescript
|
|
23
|
+
/**
|
|
24
|
+
* What an operation's `enabledCondition` (and a variant's other row functions) receives. Imported from
|
|
25
|
+
* `@wildo-ai/saas-models`; you write the function, the engine calls it.
|
|
26
|
+
*
|
|
27
|
+
* The engine calls `enabledCondition` in TWO places with these parameters, so one function decides both: in the frontend
|
|
28
|
+
* before it offers the action (a list judges each SUMMARY row, a record page the full row), and in the backend before the
|
|
29
|
+
* operation runs, where a `false` refuses the call with 403 `service_resource_operation_disabled` before any hook. So a
|
|
30
|
+
* condition must say EVERYTHING the operation's handler would refuse on the row's state or on who is asking, or the
|
|
31
|
+
* action is offered and then refused.
|
|
32
|
+
*
|
|
33
|
+
* - `currentObject` — the row as it stands. On a list row only its summary fields and the variant's
|
|
34
|
+
* `enabledConditionFields` are present.
|
|
35
|
+
* - `initiatorIds.userId` — the person asking (absent for a machine principal). Compare it with an owner field to offer an
|
|
36
|
+
* action only to the requester, or never to them (nobody approves their own request).
|
|
37
|
+
* - `inputDto` — the request body when the backend judges the call. When the frontend decides whether to offer the
|
|
38
|
+
* action there is no body yet, and it passes the ROW in its place, so never decide availability from `inputDto`.
|
|
39
|
+
*
|
|
40
|
+
* @example
|
|
41
|
+
* // Offered only to the person who raised the request, and only while it is a draft.
|
|
42
|
+
* enabledCondition: ({ currentObject, initiatorIds }) =>
|
|
43
|
+
* currentObject.status === RequestStatus.DRAFT && currentObject.createdByUserId === initiatorIds?.userId,
|
|
44
|
+
* enabledConditionFields: ['createdByUserId'],
|
|
45
|
+
*/
|
|
46
|
+
export type ResourceConfiguration_OperationVariant_CustomImplementation_FunctionParameters<TMainSchema extends z.ZodTypeAny = z.ZodAny> = {
|
|
47
|
+
inputDto: MainSchemaInfer<TMainSchema>,
|
|
48
|
+
currentObject: MainSchemaInfer<TMainSchema>,
|
|
49
|
+
/**
|
|
50
|
+
* The row as it stood BEFORE the write (the pre-image), when the framework captured one.
|
|
51
|
+
*
|
|
52
|
+
* Present only for a SINGLE-row UPDATE/DELETE (the framework fetches a pre-image only when
|
|
53
|
+
* exactly one id is selected); `undefined` for CREATE (nothing existed) and for bulk writes.
|
|
54
|
+
* It lets a consumer reason about what CHANGED rather than only the final state. Its wired
|
|
55
|
+
* consumers are the derived-badge recompute, which re-counts the scope a mutation moved a
|
|
56
|
+
* row OUT of (not just the one it moved it into) — see `dispatchDerivedBadgeRecomputes` — and a
|
|
57
|
+
* notification's `condition`, which receives it to tell a change from a write that left the row as
|
|
58
|
+
* it was (#2781). A `userIdsSelector` (e.g. notifying the PRIOR assignee a task was taken from them)
|
|
59
|
+
* would need the notification dispatcher to forward it into the selector call first; it is not
|
|
60
|
+
* plumbed there yet. Never assume it is populated; branch on its presence.
|
|
61
|
+
*/
|
|
62
|
+
previousObject?: MainSchemaInfer<TMainSchema>,
|
|
63
|
+
objectContext: any,
|
|
64
|
+
initiatorUserContext?: any,
|
|
65
|
+
initiatorIds?: { userId?: string; organizationId?: string; applicationId?: string },
|
|
66
|
+
}
|
|
67
|
+
```
|
package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md
CHANGED
|
@@ -41,11 +41,12 @@ moves the business does not allow.
|
|
|
41
41
|
* `authoritativeFields: ['total']` from the lines and `discountPercent` (see the computed-total recipe), never typed
|
|
42
42
|
* by a person.
|
|
43
43
|
*
|
|
44
|
-
* Concurrency: the
|
|
45
|
-
*
|
|
46
|
-
*
|
|
47
|
-
*
|
|
48
|
-
*
|
|
44
|
+
* Concurrency: the engine makes each transition's write conditional on what its `enabledCondition`
|
|
45
|
+
* read from the row. ACCEPT and DECLINE arriving at the same moment on one SENT quote both pass the
|
|
46
|
+
* condition, but only the first write finds the quote still SENT. The second matches no row and is
|
|
47
|
+
* refused with 409 `version_conflict` (re-read the quote and decide again). One after the other, the second is
|
|
48
|
+
* refused by the condition itself (403 `service_resource_operation_disabled`). Nothing is declared for
|
|
49
|
+
* this: the condition is the declaration.
|
|
49
50
|
*/
|
|
50
51
|
export enum Quote_Status {
|
|
51
52
|
DRAFT = 'DRAFT',
|
|
@@ -145,8 +146,8 @@ export const quote_ResourceConfiguration_InitializationFactory = (resourcesRelat
|
|
|
145
146
|
variantType: ResourceOperationVariantType.API_CALL,
|
|
146
147
|
isDefault: true,
|
|
147
148
|
roles: [CORE_ORG_ROLES.ORG_MEMBER],
|
|
148
|
-
// Starts from SENT like ACCEPT, so after either has run the other is refused
|
|
149
|
-
// same moment
|
|
149
|
+
// Starts from SENT like ACCEPT, so after either has run the other is refused, also when the two arrive
|
|
150
|
+
// at the same moment: see the concurrency note above.
|
|
150
151
|
riskLevel: ResourceOperationRiskLevel.HIGH,
|
|
151
152
|
resourceOperationLike: CoreResourceOperation.UPDATE,
|
|
152
153
|
requestDto: z.object({}),
|
|
@@ -191,8 +192,11 @@ What each part earns:
|
|
|
191
192
|
- **HIGH risk on transitions.** It puts every transition in the audit trail; MEDIUM and LOW sit below
|
|
192
193
|
the automatic audit floor.
|
|
193
194
|
|
|
194
|
-
**
|
|
195
|
-
|
|
196
|
-
both pass
|
|
197
|
-
|
|
198
|
-
|
|
195
|
+
**Two transitions at the same moment:** the engine makes a transition's write conditional on what its
|
|
196
|
+
`enabledCondition` read from the row (here `status`). ACCEPT and DECLINE arriving together on one SENT
|
|
197
|
+
quote both pass the condition, but only the first write finds the quote still SENT. The second matches no
|
|
198
|
+
row and is refused with 409 `version_conflict` (the answer an `If-Match` conflict gets: re-read the quote
|
|
199
|
+
and decide again), and nothing it would have written lands. One after the other, the second is refused by the condition (403
|
|
200
|
+
`service_resource_operation_disabled`). Nothing extra is declared for this, and nothing belongs in
|
|
201
|
+
application code: read the fields the decision depends on in the condition, and they become the write's
|
|
202
|
+
precondition. An edit to a field the condition never read (the title) does not block a transition.
|
|
@@ -82,6 +82,10 @@ from the resource itself (Step 7).
|
|
|
82
82
|
|-------------------------------------|---------------------------------------------------------------------------------|
|
|
83
83
|
| Layout / sections / chrome | Step 7 — decide each surface; `references/surface-decisions.md` |
|
|
84
84
|
| Filter pills above a list ("Overdue", "Mine") | `collectionDisplayConfig.presetFilters`; `references/framework-collection-filter-presets-api.md` |
|
|
85
|
+
| A list as a board (a column per status, cards dragged between them) | `collectionDisplayConfig.displayMode: BOARD` + `board`; `references/surface-decisions.md` |
|
|
86
|
+
| A list as a calendar (a month grid, each row on its date) | `collectionDisplayConfig.calendar: { dateField }`; `references/surface-decisions.md` |
|
|
87
|
+
| A list as a timeline (a bar per row from its start date to its end date) | `collectionDisplayConfig.timeline: { startField, endField }`; `references/surface-decisions.md` |
|
|
88
|
+
| Which stage of its lifecycle a record is at, on its read page | `SectionMode.STAGES` + `stageBinding`; `references/framework-section-stages-api.md` |
|
|
85
89
|
| Operation keys / `ResourceUIBehaviorConfig` / preset map | `references/framework-frontend-resource-ui-contracts-api.md` |
|
|
86
90
|
| Enum visuals + modes | `references/framework-enum-frontend-handling-api.md` |
|
|
87
91
|
| Display vs edit mode vocabulary | `references/framework-display-edit-modes-api.md` |
|
|
@@ -132,6 +136,14 @@ In development, an unconfigured operation logs a one-time
|
|
|
132
136
|
`[IconRegistry] Operation "<resource>:<op>" has no icon …` warning — treat any
|
|
133
137
|
such warning as a missing `iconOverride`.
|
|
134
138
|
|
|
139
|
+
**The icon is not the action's name.** Every direct action shows its WORDS beside
|
|
140
|
+
its icon by default, and a list row keeps ONE action in view with the rest in the
|
|
141
|
+
`…` menu (which shows words too); on a phone the row keeps them all in the menu. Do not set `layout.actionLabelDisplayMode` to
|
|
142
|
+
`TOOLTIP` to save room: an icon alone is understood only for the few glyphs
|
|
143
|
+
everybody knows, never for this application's own verbs ("Submit", "Place
|
|
144
|
+
order"), and a tooltip does not exist on a phone. Order the transitions with
|
|
145
|
+
`displayPriority` so the main verb of the record's state keeps the row's slot.
|
|
146
|
+
|
|
135
147
|
### Step 7: Decide each surface, and state the decision (always)
|
|
136
148
|
|
|
137
149
|
Every resource decides its **read**, **form**, **summary** and **header** surfaces,
|
|
@@ -187,6 +199,12 @@ JSX name, the `layout.refs` manifest, and a documented spec slot with `textSlots
|
|
|
187
199
|
Missing the spec slot throws at import time. See
|
|
188
200
|
`references/framework-resource-layout-templates-api.md` before adding one.
|
|
189
201
|
|
|
202
|
+
**A record OTHER people move after its author wrote it** (a request awaiting approvals, a claim being assessed) is a
|
|
203
|
+
workflow record: its page shows the status in the header, the route with the current step (the next step is the one
|
|
204
|
+
after it), then what was asked and what happened to it. `references/workflow-record-page.md` has the parts and a
|
|
205
|
+
worked example. When the stages ARE the page (each stage holds the facts that belong to it), the record's
|
|
206
|
+
`status` can drive them directly: `references/framework-section-stages-api.md`.
|
|
207
|
+
|
|
190
208
|
### Step 7b: Place related resources (when the default set or order is wrong)
|
|
191
209
|
|
|
192
210
|
A parent does NOT configure how its children appear inside its own view — there
|
|
@@ -322,7 +340,7 @@ removed:
|
|
|
322
340
|
header: () => (
|
|
323
341
|
<div className="flex min-w-0 flex-wrap items-center gap-field">
|
|
324
342
|
<ResourceHeaderTitle />
|
|
325
|
-
<DisplayField name="status"
|
|
343
|
+
<DisplayField name="status" labelPlacement="hidden" hideDescription className="w-auto" />
|
|
326
344
|
</div>
|
|
327
345
|
),
|
|
328
346
|
|
|
@@ -467,7 +485,10 @@ const CHANGE_STATUS_ACTION = {
|
|
|
467
485
|
// Explicit ORDER in the bar. Status is the verb reached for most often on a todo, so it leads; assignment follows.
|
|
468
486
|
// Without this the bar orders by registration, which is an artefact of how the config file was written rather than
|
|
469
487
|
// of how the actions are used — and `actionDisclosure` caps the bar at three, so ordering decides WHICH three survive.
|
|
470
|
-
|
|
488
|
+
// Lower comes first, and it must be BELOW 10: that is Edit's default, and every custom operation built on UPDATE
|
|
489
|
+
// (Make recurring, Unassign…) inherits it, so a 10 here ties them and loses to registration order. It did: the
|
|
490
|
+
// header read Edit, Make recurring, Change status, and a phone's one slot went to Edit (#3066 deep review).
|
|
491
|
+
displayPriority: 5,
|
|
471
492
|
// Changing status is what a person came to the todo to DO. Every other verb on the bar is incidental to that, so it
|
|
472
493
|
// carries the accent rather than sitting visually level with "unassign".
|
|
473
494
|
actionVariant: ButtonVariants_Variant.ACCENT,
|
|
@@ -481,7 +502,8 @@ const REOPEN_ACTION = {
|
|
|
481
502
|
surface: ResourceOperationFrontendSurface.EMBEDDED,
|
|
482
503
|
iconOverride: RotateCcw,
|
|
483
504
|
actionVisibility: ActionVisibility.WHEN_AVAILABLE,
|
|
484
|
-
|
|
505
|
+
// Right after Change status and ahead of the verbs tied at UPDATE's 10, so the slot it inherits is the first.
|
|
506
|
+
displayPriority: 6,
|
|
485
507
|
} as const;
|
|
486
508
|
```
|
|
487
509
|
|
|
@@ -541,6 +563,27 @@ const REOPEN_ACTION = {
|
|
|
541
563
|
collectionDisplayConfig: {
|
|
542
564
|
selectable: true,
|
|
543
565
|
cardActionPlacement: { vertical: VerticalPlacement.TOP, horizontal: HorizontalPlacement.END },
|
|
566
|
+
/*
|
|
567
|
+
* The same todos as a BOARD (#2298): one column per status, in the enum's declaration order, and moving a
|
|
568
|
+
* card (drag, or Left/Right on the focused card) calls Change status with the column's value. Naming the
|
|
569
|
+
* operation without a variant lets each card use the highest-rights variant the viewer holds and that admits
|
|
570
|
+
* the row: a member moves the todos assigned to them, an administrator any todo, and a completed todo moves
|
|
571
|
+
* for nobody (Reopen is its way back). The cards stay the default; the view toggle offers the board.
|
|
572
|
+
*/
|
|
573
|
+
userSwitchableDisplayMode: true,
|
|
574
|
+
board: { groupByField: 'status', transitionOperation: Todos_Operations.CHANGE_STATUS },
|
|
575
|
+
/*
|
|
576
|
+
* And as a CALENDAR (#2298): a month grid with each todo on its due date. The weeks shown are the fetch's
|
|
577
|
+
* window on `dueDate`, so another month asks the backend for that month's todos, and the status tabs and pills
|
|
578
|
+
* still narrow it ("Mine" in November). Todos with no due date are not on the calendar.
|
|
579
|
+
*/
|
|
580
|
+
calendar: { dateField: 'dueDate' },
|
|
581
|
+
/*
|
|
582
|
+
* And as a TIMELINE (#2298): one bar per todo from the day it was captured to the day it is due, so a month
|
|
583
|
+
* shows how long each piece of work has been open against its deadline. The month is the fetch's window (the
|
|
584
|
+
* todos open at some point of it); a todo with no due date has no span and is not on the timeline.
|
|
585
|
+
*/
|
|
586
|
+
timeline: { startField: 'createdAt', endField: 'dueDate' },
|
|
544
587
|
// Status is the axis a todo list is READ along — "what is still open?" is
|
|
545
588
|
// the first question. `quickFilterField` promotes it to a tab strip above
|
|
546
589
|
// the toolbar writing the same server-side filter the panel would.
|
|
@@ -602,6 +645,16 @@ const REOPEN_ACTION = {
|
|
|
602
645
|
actionPresentation: ResourceOperationActionPresentation.DROPDOWN,
|
|
603
646
|
displayPriority: 20,
|
|
604
647
|
}],
|
|
648
|
+
// DROPDOWN, for ASSIGN's reason: the operation's whole input is ONE reference (`targetTodoListId`, a
|
|
649
|
+
// foreign key declared to `todoLists`), so "Move to ▾" lists the lists and picking one moves the todo.
|
|
650
|
+
// It is named apart from the route's `todoListId`, the SOURCE list when the todo is opened inside it
|
|
651
|
+
// (see `Todos_MoveToListRequestDto`). It is how a capture leaves the Inbox for its week (#2622).
|
|
652
|
+
[Todos_Operations.MOVE_TO_LIST, {
|
|
653
|
+
surface: ResourceOperationFrontendSurface.EMBEDDED,
|
|
654
|
+
iconOverride: FolderInput,
|
|
655
|
+
actionPresentation: ResourceOperationActionPresentation.DROPDOWN,
|
|
656
|
+
displayPriority: 30,
|
|
657
|
+
}],
|
|
605
658
|
// These three pair off with ASSIGN and with each other: exactly one of
|
|
606
659
|
// ASSIGN/UNASSIGN applies to a todo, and exactly one of
|
|
607
660
|
// SET_AS_RECURRING/SET_AS_ONE_TIME. `WHEN_AVAILABLE` drops the inapplicable
|
|
@@ -651,6 +704,9 @@ const REOPEN_ACTION = {
|
|
|
651
704
|
- `references/framework-collection-filter-presets-api.md` — source-backed preset vocabulary: date windows (incl. overdue, next N days), the viewer's own id, numeric bounds
|
|
652
705
|
- `references/framework-resource-layout-templates-api.md` — source-backed `layout.{edit,display,summary,header}`, the `layout.refs` manifest, and `<ResourceHeaderTitle />`
|
|
653
706
|
- `references/framework-field-tiles-api.md` — source-backed `<FieldTiles>`: a record's facts as a grid of tiles, the host that gives its fields `DisplayChromeMode.TILE`
|
|
707
|
+
- `references/framework-record-page-parts-api.md` — source-backed `<RecordState>` (status first) and `<RecordKeepingFacts>` (who and when, last), and the order the generated read page follows with no template
|
|
708
|
+
- `references/framework-section-stages-api.md` — source-backed `SectionMode.STAGES` + `stageBinding`: a read page's stages bound to the record's enum field (reached / current / not reached, each stage's description, no buttons), and when to use STEPPER or TIMELINE instead
|
|
709
|
+
- `references/workflow-record-page.md` — a record other people move after its author wrote it: the status in the header, the route with its next step, what was asked and what happened to it
|
|
654
710
|
- `references/record-page-anatomy.md` — the order of a record's read page (identity, content, facts, working blocks, related, files) and which construct renders each part
|
|
655
711
|
- `references/visual-quality-rubric.md` — what a well-rendered read, card and form look like, each rule paired with the check that proves it
|
|
656
712
|
- `references/framework-related-resource-embeds-api.md` — source-backed `RelatedResourceSections`, the `EmbedRelated*` family, `viaForeignKey` edge disambiguation, preview, and descent bounding
|
|
@@ -672,6 +728,8 @@ const REOPEN_ACTION = {
|
|
|
672
728
|
- [ ] Every operation referenced by `views: [...]` exists in this resource's `*.resources-config.ts`
|
|
673
729
|
- [ ] The resource sets `icon` (a `lucide-react` component) on its `resourceUIBehavior(...)` config
|
|
674
730
|
- [ ] Every **custom** operation in `views: [...]` sets `iconOverride` (a component reference — not a `<JSX />` element); core operations may omit it (they inherit defaults)
|
|
731
|
+
- [ ] No view sets `ActionLabelDisplayMode.TOOLTIP` (actions keep their words); the main verb of each state has the lowest `displayPriority`
|
|
732
|
+
- [ ] An authored read page opens with the state (`<RecordState>`, or the header) and closes with `<RecordKeepingFacts>`; no tile repeats the record's name or names its organization
|
|
675
733
|
- [ ] If a foreign-key picker should show summary cards, the FK field sets `edit.optionDisplayMode: ForeignKeyDisplayMode.SUMMARY` via `.foreignKeyUI(...)` (default is the one-line `LABEL`)
|
|
676
734
|
- [ ] Every `RelatedResourceSections` / `EmbedRelated*` target whose host has TWO relationships to that same resource passes `viaForeignKey` (otherwise a silently wrong collection renders)
|
|
677
735
|
- [ ] No child is placed in a template AND expected to also appear automatically — placing one child means the template owns the whole child region
|
|
@@ -726,6 +784,7 @@ Icon invariants (same resource-path substitution):
|
|
|
726
784
|
|
|
727
785
|
- Custom op missing an `iconOverride` (should be empty): `rg -nP "[A-Za-z]+_Operations\.[A-Z_]+,\s*\{(?:(?!iconOverride)[^}])*\}\]" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
728
786
|
- `iconOverride` passed as JSX instead of a component reference (should be empty): `rg -n "iconOverride:\s*<" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
787
|
+
- No icon-only actions (should be empty): `rg -n "ActionLabelDisplayMode.TOOLTIP" frontend/src/modules/*/resources/<resource>/<resource>.ui-behavior.tsx`
|
|
729
788
|
|
|
730
789
|
## Common Rationalizations
|
|
731
790
|
|
|
@@ -740,6 +799,8 @@ Icon invariants (same resource-path substitution):
|
|
|
740
799
|
| "Adding `excludeFromUpdate` here is faster than touching the schema" | Lifecycle and DTO shape decorators are structural — they belong in the schema, not in UI behavior. Putting them here drifts the persisted contract.|
|
|
741
800
|
| "I'll set a flag on the relationship to hide this child from the parent view" | There is no such flag — per-edge composition config was deleted. Place the children you want; the ones you did not place do not render. |
|
|
742
801
|
| "I only want to reorder one child, so I'll place just that one" | Placing ANY child makes the template own the whole region. Place all the children that surface should show, in the order it should show them. |
|
|
802
|
+
| "An icon is enough, the tooltip names it" | Only for glyphs everybody knows. A paper plane does not say "Submit", and a phone has no hover. The default shows words; keep it. |
|
|
803
|
+
| "Schema order is a fine order for the read page" | Schema order is the order the fields were typed in, usually plumbing first. A record is read state, content, facts, then who made it and when. |
|
|
743
804
|
| "`resourceType` is enough to identify the child collection" | Not when the host has two relationships to that resource. The resolver picks an edge and renders a plausible-looking WRONG collection, silently. |
|
|
744
805
|
|
|
745
806
|
## Red Flags
|
|
@@ -758,6 +819,8 @@ Icon invariants (same resource-path substitution):
|
|
|
758
819
|
- A placed target whose host has two relationships to that resource has no `viaForeignKey` — a wrong collection renders with no error (catch with the "edge disambiguation" grep above)
|
|
759
820
|
- A template places some children and the author still expects the rest to appear automatically — placing one means owning all (catch by comparing the placed `targets` against the resource's owned relationships)
|
|
760
821
|
- A hand-wired named `<Section>` wraps children instead of using `RelatedResourceSections` — re-incurs the three-place obligation, and a missing spec slot throws at import (catch with the "no named Section" grep above)
|
|
822
|
+
- A view sets `ActionLabelDisplayMode.TOOLTIP`, so the application's verbs are bare icons (catch with the "no icon-only actions" grep below)
|
|
823
|
+
- `createdAt` / `updatedAt` / the creator sit in `<FieldTiles>` beside what the record says, instead of in `<RecordKeepingFacts>` (catch with the record-keeping grep in `references/visual-quality-rubric.md`)
|
|
761
824
|
- `iconOverride` is written as a JSX element (`<Icon />`) instead of a component reference (catch with the "iconOverride passed as JSX" grep above) — `IconLike` is `ComponentType | string`, so pass `Icon`, not `<Icon />`
|
|
762
825
|
|
|
763
826
|
## Related Skills
|
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
# Collection filter presets (one-click pills above a list)
|
|
2
2
|
|
|
3
3
|
The vocabulary a list's `collectionDisplayConfig.presetFilters` assigns: fixed values, numeric bounds, date windows
|
|
4
|
-
resolved as whole calendar days in the reader's resolved time zone (open on one side for "before today"),
|
|
4
|
+
resolved as whole calendar days in the reader's resolved time zone (open on one side for "before today"), ranges of
|
|
5
|
+
months on a year-month field (fixed, or relative to the current month), and values resolved from who is looking.
|
|
5
6
|
|
|
6
7
|
Read this when:
|
|
7
8
|
|
|
8
9
|
- a list needs "Overdue", "Due this week", "Created today", "Mine" or "Assigned to me" as one click;
|
|
10
|
+
- a list of monthly rows (budgets, periods) needs "This month", "This quarter" or "Year to date" as one click;
|
|
9
11
|
- you are tempted to build a custom component or a custom filter for a narrowing like that: you do not need one;
|
|
10
12
|
- a preset's pill reads as permanently off (every key it assigns must be a filter field of the operation).
|
|
11
13
|
|
|
@@ -29,9 +31,10 @@ Read this when:
|
|
|
29
31
|
* preset needs no filter grammar of its own and no backend change. A window may be open on one side:
|
|
30
32
|
* "before today" has no start, and the filter treats an absent bound as unbounded on every adapter.
|
|
31
33
|
*
|
|
32
|
-
* Every member is a span of WHOLE calendar days counted from today in the reader's resolved timezone
|
|
34
|
+
* Every member but one is a span of WHOLE calendar days counted from today in the reader's resolved timezone
|
|
33
35
|
* (member, then organization, then floor), which is the only one that makes "today" true for the person
|
|
34
|
-
* reading the screen, and the one the list's own date words use.
|
|
36
|
+
* reading the screen, and the one the list's own date words use. The exception is `BEFORE_NOW`, whose
|
|
37
|
+
* bound is the instant of the click (#2627); its own JSDoc says how it is read back. Over an instant field the window runs
|
|
35
38
|
* between that zone's midnights; over a calendar-day field (`isCalendarDate()`) it covers those calendar
|
|
36
39
|
* days, held as UTC midnights, so a due date is the same day for every reader. Both bounds are included,
|
|
37
40
|
* as the backend's range filter includes them, so the window ends one millisecond before the day after
|
|
@@ -57,12 +60,68 @@ export enum CollectionFilterPresetRelativeRange {
|
|
|
57
60
|
* same all day.
|
|
58
61
|
*/
|
|
59
62
|
BEFORE_TODAY = 'before_today',
|
|
63
|
+
/**
|
|
64
|
+
* Every instant BEFORE NOW: "overdue" for a deadline with a TIME of day (#2627). A callback promised for 10:00 is
|
|
65
|
+
* overdue at 10:01, which `BEFORE_TODAY` cannot say: its whole-day window ends at the last instant of yesterday.
|
|
66
|
+
*
|
|
67
|
+
* Resolved to a window with no start that ends at the instant the pill is clicked. Because that bound is not a day
|
|
68
|
+
* boundary, it cannot be read back by comparing bounds as the day-bound members are (the next render's `now` is a
|
|
69
|
+
* different instant): the pill instead reads as ON for any window of this KIND — no start, ending at an instant
|
|
70
|
+
* earlier today, no later than now. A window picked in the filters panel always ends at the last instant of a day,
|
|
71
|
+
* so the panel can never produce one, and "Overdue" by day and "Overdue" by the minute never read as each other.
|
|
72
|
+
* Like "created today", the pill goes off once the day it was clicked on has ended.
|
|
73
|
+
*
|
|
74
|
+
* Over a CALENDAR-DAY field (`isCalendarDate()`) it is `BEFORE_TODAY`: a date with no time is overdue only once
|
|
75
|
+
* its whole day has passed, so the last day before now that has ended is yesterday.
|
|
76
|
+
*/
|
|
77
|
+
BEFORE_NOW = 'before_now',
|
|
60
78
|
/** Today and the six calendar days after it, in the reader's calendar: "due this week" from today. */
|
|
61
79
|
NEXT_7_DAYS = 'next_7_days',
|
|
62
80
|
/** Today and the twenty-nine calendar days after it, in the reader's calendar. */
|
|
63
81
|
NEXT_30_DAYS = 'next_30_days',
|
|
64
82
|
}
|
|
65
83
|
|
|
84
|
+
/**
|
|
85
|
+
* A RANGE OF MONTHS named relative to the current month, for a preset on a year-month field (#3444): "This quarter" on a
|
|
86
|
+
* list of monthly budgets must still mean this quarter next month, so it cannot be an authored pair of months.
|
|
87
|
+
*
|
|
88
|
+
* It is the month-field counterpart of {@link CollectionFilterPresetRelativeRange} and resolves the same way: when the
|
|
89
|
+
* pill is clicked, counted from TODAY in the reader's resolved time zone (member, then organization, then floor), the
|
|
90
|
+
* today the list's own date words use. A year-month value (`z_yearMonth()`, `YYYY-MM`) is a calendar label rather than
|
|
91
|
+
* an instant, so the window is a pair of month labels, both included: exactly the `{ startMonth, endMonth }` value the
|
|
92
|
+
* filters panel's two month pickers write (`Resources_Filter_YearMonthRangeSchema`), so a pill and the same months
|
|
93
|
+
* picked by hand are one filter, and the backend needs no grammar of its own.
|
|
94
|
+
*
|
|
95
|
+
* A separate vocabulary rather than new members of the date one, because the two resolve to different VALUES for
|
|
96
|
+
* different field kinds: a date window is a pair of instants for a `z.date()` field, a month window is a pair of
|
|
97
|
+
* `YYYY-MM` labels for a year-month field, and a member meaning one cannot be applied to the other. Rejected: a
|
|
98
|
+
* parameterised `{ lastMonths: n }`. Each member below is a span a person asks for by name, and a closed set is the one
|
|
99
|
+
* place its words and its resolution can both be checked.
|
|
100
|
+
*
|
|
101
|
+
* Every member names BOTH bounds, so a window is never open: the rolling ones include the current month, as
|
|
102
|
+
* "the last 7 days" includes today.
|
|
103
|
+
*/
|
|
104
|
+
export enum CollectionFilterPresetRelativeMonthRange {
|
|
105
|
+
/** The current month. */
|
|
106
|
+
THIS_MONTH = 'this_month',
|
|
107
|
+
/** The month before the current one. */
|
|
108
|
+
LAST_MONTH = 'last_month',
|
|
109
|
+
/** The month after the current one: next month's budgets, planned ahead. */
|
|
110
|
+
NEXT_MONTH = 'next_month',
|
|
111
|
+
/** The calendar quarter holding the current month (January–March, April–June, July–September, October–December), all three months, the coming ones included. */
|
|
112
|
+
THIS_QUARTER = 'this_quarter',
|
|
113
|
+
/** The calendar quarter before the current one. */
|
|
114
|
+
LAST_QUARTER = 'last_quarter',
|
|
115
|
+
/** The current month and the two before it — a rolling quarter, including this month. */
|
|
116
|
+
LAST_3_MONTHS = 'last_3_months',
|
|
117
|
+
/** The current month and the eleven before it — a rolling year, including this month. */
|
|
118
|
+
LAST_12_MONTHS = 'last_12_months',
|
|
119
|
+
/** January of the current year through the current month. */
|
|
120
|
+
YEAR_TO_DATE = 'year_to_date',
|
|
121
|
+
/** January through December of the current year, the coming months included. */
|
|
122
|
+
THIS_YEAR = 'this_year',
|
|
123
|
+
}
|
|
124
|
+
|
|
66
125
|
/**
|
|
67
126
|
* A value a preset can only know once it is clicked, because it depends on WHO is looking. Resolved from the
|
|
68
127
|
* viewer's session at that moment, like a relative range is resolved from the clock, so "My jobs" means the person
|
|
@@ -79,25 +138,35 @@ export enum CollectionFilterPresetContextValue {
|
|
|
79
138
|
/**
|
|
80
139
|
* What a preset ASSIGNS to one filter field.
|
|
81
140
|
*
|
|
82
|
-
*
|
|
141
|
+
* Split by WHEN the value is known:
|
|
83
142
|
*
|
|
84
143
|
* - a LITERAL (string, number, boolean) is fixed at authoring time and covers every enum value, id, number and flag,
|
|
85
|
-
* which is the whole of "filter to HIGH priority"
|
|
86
|
-
*
|
|
87
|
-
*
|
|
144
|
+
* which is the whole of "filter to HIGH priority". On a year-month field one `YYYY-MM` month is the range that starts
|
|
145
|
+
* and ends with it, and reads as the same filter as that range picked in the panel;
|
|
146
|
+
* - a RELATIVE RANGE (`{ relativeRange }`) is the temporal case on a DATE field, resolved when the pill is clicked,
|
|
147
|
+
* because an authored answer would be wrong by tomorrow;
|
|
148
|
+
* - a RELATIVE MONTH RANGE (`{ relativeMonthRange }`) is the same case on a YEAR-MONTH field (#3444), resolved to the
|
|
149
|
+
* `{ startMonth, endMonth }` pair the panel's month pickers write;
|
|
88
150
|
* - a NUMERIC BOUND (`{ min?, max? }`) writes the same value the filter panel's own two number inputs do, and the
|
|
89
151
|
* backend applies it on every adapter. Both bounds are optional because "under 500" has no floor, and that is the
|
|
90
152
|
* commonest threshold anyone asks for;
|
|
153
|
+
* - a MONTH RANGE (`{ startMonth?, endMonth? }`) is a fixed range of months, such as one fiscal year, written as the
|
|
154
|
+
* panel writes it;
|
|
91
155
|
* - a CONTEXT VALUE (`{ contextValue }`) is known only from who is looking, such as "assigned to me", and is resolved
|
|
92
156
|
* when the pill is clicked, so the same authored preset shows each viewer their own rows.
|
|
157
|
+
*
|
|
158
|
+
* The object members are STRICT. A stripping parse turned an authored `{ startMonth, endMonth }` into the numeric
|
|
159
|
+
* bound `{}` (#3444): a month range silently became "no bound", and the pill filtered nothing under its name.
|
|
93
160
|
*/
|
|
94
161
|
export const CollectionFilterPresetValueSchema = z.union([
|
|
95
162
|
z.string(),
|
|
96
163
|
z.number(),
|
|
97
164
|
z.boolean(),
|
|
98
|
-
z.
|
|
99
|
-
z.
|
|
100
|
-
z.
|
|
165
|
+
z.strictObject({ relativeRange: z.enum(CollectionFilterPresetRelativeRange) }),
|
|
166
|
+
z.strictObject({ relativeMonthRange: z.enum(CollectionFilterPresetRelativeMonthRange) }),
|
|
167
|
+
z.strictObject({ min: z.number().optional(), max: z.number().optional() }),
|
|
168
|
+
Resources_Filter_YearMonthRangeSchema,
|
|
169
|
+
z.strictObject({ contextValue: z.enum(CollectionFilterPresetContextValue) }),
|
|
101
170
|
]);
|
|
102
171
|
export type CollectionFilterPresetValue = z.infer<typeof CollectionFilterPresetValueSchema>;
|
|
103
172
|
|
|
@@ -152,6 +221,16 @@ export type CollectionFilterPreset = z.infer<typeof CollectionFilterPresetSchema
|
|
|
152
221
|
|
|
153
222
|
- A window on a date field needs that field in the operation's `filterFields` as `z.date()` (it becomes a date range).
|
|
154
223
|
- `BEFORE_TODAY` is "overdue": every earlier date, and a date-only value due today is not in it.
|
|
224
|
+
- `BEFORE_NOW` is "overdue" for a deadline with a TIME of day (a callback promised for 10:00 is overdue at 10:01):
|
|
225
|
+
no start, ending at the instant the pill is clicked. Its pill stays on for the rest of that day and goes off when the
|
|
226
|
+
day ends. Over a date-only field (`isCalendarDate()`) it is exactly `BEFORE_TODAY`. Use `BEFORE_TODAY` for a due
|
|
227
|
+
DATE, and `BEFORE_NOW` only when the field's time of day is meaningful.
|
|
228
|
+
- A range of months needs a `z_yearMonth()` field declared in the operation's `filterFields` as
|
|
229
|
+
`Resources_Filter_YearMonthRangeSchema`. `{ relativeMonthRange: CollectionFilterPresetRelativeMonthRange.THIS_QUARTER }`
|
|
230
|
+
resolves to the `{ startMonth, endMonth }` the panel's month pickers write, both months included, so the pill reads
|
|
231
|
+
ON when the same months are picked by hand. `relativeRange` is for a date field and `relativeMonthRange` for a
|
|
232
|
+
year-month field; one cannot stand in for the other. One literal month (`period: '2026-11'`) and the range that
|
|
233
|
+
starts and ends with it are the same filter.
|
|
155
234
|
- `CURRENT_USER` resolves to the signed-in user's id when the pill is clicked; the pill is disabled for a viewer with no
|
|
156
235
|
user, never applied without the field.
|
|
157
236
|
- Presets combine with each other and with the status tabs. A preset assigning several fields is on only when all of
|
package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md
CHANGED
|
@@ -153,6 +153,12 @@ export const StringDisplayMode = {
|
|
|
153
153
|
* `edit.editMode: StringEditMode.ORGANIZATION_ROLE` so the field is picked the way it is read.
|
|
154
154
|
*/
|
|
155
155
|
ORGANIZATION_ROLE: 'organization_role',
|
|
156
|
+
/**
|
|
157
|
+
* The value is a calendar month, `YYYY-MM` — render it as the month and the year in the reader's locale
|
|
158
|
+
* ("October 2026", "octobre 2026"), never the raw string. A value that is not a year-month shows as typed. Declared
|
|
159
|
+
* by `z_yearMonth()`, which pairs it with `edit.editMode: StringEditMode.YEAR_MONTH`.
|
|
160
|
+
*/
|
|
161
|
+
YEAR_MONTH: 'year_month',
|
|
156
162
|
} as const;
|
|
157
163
|
export type StringDisplayMode = typeof StringDisplayMode[keyof typeof StringDisplayMode];
|
|
158
164
|
|
|
@@ -184,6 +190,11 @@ export const StringEditMode = {
|
|
|
184
190
|
* the operation's offer alone. The server remains the control: it decides what holding the role grants.
|
|
185
191
|
*/
|
|
186
192
|
ORGANIZATION_ROLE: 'organization_role',
|
|
193
|
+
/**
|
|
194
|
+
* A MONTH-AND-YEAR picker: a list of the twelve months, named in the reader's locale, and a year. It writes the value
|
|
195
|
+
* as `YYYY-MM` and nothing else, so the user never types the format. Declared by `z_yearMonth()`.
|
|
196
|
+
*/
|
|
197
|
+
YEAR_MONTH: 'year_month',
|
|
187
198
|
} as const;
|
|
188
199
|
export type StringEditMode = typeof StringEditMode[keyof typeof StringEditMode];
|
|
189
200
|
|