@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
|
@@ -38,23 +38,32 @@ import {
|
|
|
38
38
|
type OpenApiGenerationInput,
|
|
39
39
|
type OpenApiGenerationProjectorStats,
|
|
40
40
|
type OperationProjection,
|
|
41
|
+
type ApiReferenceResourceCategory,
|
|
41
42
|
type ResourceTag,
|
|
42
43
|
type TechnicalDocGenerateOpenApiResult,
|
|
43
44
|
type ApplicationConnectionServer,
|
|
44
45
|
type ApplicationAuthenticationDocumentationSource,
|
|
45
46
|
type ApplicationMcpToolSource,
|
|
46
47
|
type ApplicationWebhookEventSource,
|
|
48
|
+
OPENAPI_AUTHORED_EXAMPLE_ERROR_NAME,
|
|
47
49
|
} from '@wildo-ai/saas-technical-doc/companion';
|
|
48
50
|
import {
|
|
49
51
|
createApiReferenceLinkIndex,
|
|
50
52
|
getTechnicalDocumentationApiReferenceTargetAvailability,
|
|
51
53
|
resolveTechnicalDocumentationApiReferenceLink,
|
|
52
54
|
TechnicalDocumentationApiReferenceTargetAvailability,
|
|
55
|
+
isApiReferenceEngineCategoryAssignment,
|
|
53
56
|
type WildoTechnicalDocConfig,
|
|
54
57
|
} from '@wildo-ai/saas-technical-doc';
|
|
55
|
-
import
|
|
58
|
+
import { ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION, EngineResourceSubDomain } from '@wildo-ai/saas-specifications';
|
|
59
|
+
import {
|
|
60
|
+
ApplicationDocumentationChapterSetSchema,
|
|
61
|
+
mergeApplicationDocumentationChapters,
|
|
62
|
+
type TechnicalDocumentationApiReferenceTargetV1,
|
|
63
|
+
} from '@wildo-ai/saas-specifications/technical-documentation';
|
|
56
64
|
import { createConservedApiReferenceModel } from '@wildo-ai/saas-technical-doc/openapi-reference-model';
|
|
57
65
|
|
|
66
|
+
import { APPLICATION_DOCUMENTATION_CHAPTER_FILES_PATH, readApplicationDocumentationChapterFiles } from './technical-documentation-chapter-files.companion';
|
|
58
67
|
import { TechnicalDocumentationPilotCompanionService } from './technical-documentation-pilot.companion.service';
|
|
59
68
|
import { COMPANION_SERVICE_TYPES } from '../../core/inject/models/service-types';
|
|
60
69
|
import type { CompanionContext } from '../../core/context/companion-context';
|
|
@@ -67,8 +76,9 @@ import type {
|
|
|
67
76
|
TechnicalDocumentationEnvironmentIdentityInput,
|
|
68
77
|
} from './technical-documentation-environment-identity.companion.service';
|
|
69
78
|
import { getCompanionConfiguredPrimaryLanguage } from '../../core/config/primary-language.companion.utils';
|
|
70
|
-
import {
|
|
71
|
-
import {
|
|
79
|
+
import { assertSpecificationWritePermitted } from '@wildo-ai/application-creation-runtime';
|
|
80
|
+
import { readSpecificationsForRewrite } from '../../core/context/companion-package-loaders.companion';
|
|
81
|
+
import { BACKEND_I18N_TREE_RELATIVE_PATH, readPerUnitLabels, resolvePerUnitFilePath } from '../../i18n-labelling/utils/per-unit-file.utils';
|
|
72
82
|
import { ROLE_LABELLING_UNIT_FILE_PATH_HINT } from '../../i18n-labelling/utils/role-lifecycle-keys.utils';
|
|
73
83
|
|
|
74
84
|
/**
|
|
@@ -82,7 +92,7 @@ export type {
|
|
|
82
92
|
|
|
83
93
|
/**
|
|
84
94
|
* Conventional file name for the per-service technical-documentation
|
|
85
|
-
* configuration
|
|
95
|
+
* configuration. Authored
|
|
86
96
|
* at the docs service root next to `package.json` / `docusaurus.config.ts`.
|
|
87
97
|
*
|
|
88
98
|
* Discovery is "by convention, not by configuration":
|
|
@@ -236,7 +246,7 @@ export class TechnicalDocCompanionService {
|
|
|
236
246
|
* The application's documentation plan and its authored chapter bodies (#874), exactly as the
|
|
237
247
|
* specifications package exports them. Parsed by the engine projector, not here.
|
|
238
248
|
*
|
|
239
|
-
* Read from the WORKING TREE — `
|
|
249
|
+
* Read from the WORKING TREE — `loadSpecificationsCompanionData` evaluates what the developer is
|
|
240
250
|
* writing — exactly as every other specification-derived page is, so an uncommitted chapter can be
|
|
241
251
|
* previewed. Acceptance is git's, not this method's: a chapter is accepted when its source and the
|
|
242
252
|
* regenerated portal output are committed together.
|
|
@@ -250,10 +260,23 @@ export class TechnicalDocCompanionService {
|
|
|
250
260
|
readonly documentationChapters?: unknown;
|
|
251
261
|
}> {
|
|
252
262
|
if (!this.companionContext.resolvedSpecifications) return {};
|
|
253
|
-
|
|
263
|
+
// One evaluation, and refused on any fault (#3258): a short read publishes without chapters the application accepted.
|
|
264
|
+
const read = await readSpecificationsForRewrite(this.companionContext, (exports) => exports);
|
|
265
|
+
assertSpecificationWritePermitted(read.basis, { packageRelativePath: 'The published documentation', fileExists: true, dryRun: false });
|
|
266
|
+
const documentationPlan = read.value?.documentationPlan;
|
|
267
|
+
/*
|
|
268
|
+
* The chapter FILES beside the inline set (#3204): one file per chapter, which nothing imports, merged here and
|
|
269
|
+
* refused on a chapter declared twice. Merged only when a file exists, so an application that writes its chapters
|
|
270
|
+
* inline keeps passing them to the projector exactly as it wrote them.
|
|
271
|
+
*/
|
|
272
|
+
const inlineChapters = read.value?.documentationChapters;
|
|
273
|
+
const chapterFiles = await readApplicationDocumentationChapterFiles(this.companionContext.resolvedSpecifications.packageRoot);
|
|
274
|
+
const documentationChapters = chapterFiles.length === 0
|
|
275
|
+
? inlineChapters
|
|
276
|
+
: mergeApplicationDocumentationChapters(inlineChapters === undefined ? undefined : ApplicationDocumentationChapterSetSchema.parse(inlineChapters), chapterFiles);
|
|
254
277
|
return {
|
|
255
|
-
...(
|
|
256
|
-
...(
|
|
278
|
+
...(documentationPlan === undefined ? {} : { documentationPlan }),
|
|
279
|
+
...(documentationChapters === undefined ? {} : { documentationChapters }),
|
|
257
280
|
};
|
|
258
281
|
}
|
|
259
282
|
|
|
@@ -370,7 +393,7 @@ export class TechnicalDocCompanionService {
|
|
|
370
393
|
if (generated.derivation.plannedChapterRefsWithoutBody.length > 0) {
|
|
371
394
|
this.logger.warn('technical-documentation: planned chapters with no authored body are not published yet', {
|
|
372
395
|
chapterRefs: generated.derivation.plannedChapterRefsWithoutBody,
|
|
373
|
-
authoredIn:
|
|
396
|
+
authoredIn: `${APPLICATION_DOCUMENTATION_CHAPTER_FILES_PATH}/<chapterRef>.ts`,
|
|
374
397
|
});
|
|
375
398
|
}
|
|
376
399
|
if (generated.derivation.authoredChapterRefsWithoutPlan.length > 0) {
|
|
@@ -479,7 +502,7 @@ export class TechnicalDocCompanionService {
|
|
|
479
502
|
* can pass it straight through as JSON.
|
|
480
503
|
*
|
|
481
504
|
* The method does NOT short-circuit on a "disabled docs site" —
|
|
482
|
-
*
|
|
505
|
+
* there is no `enabled` flag anywhere
|
|
483
506
|
* (file presence under a TECH_DOC service IS the enable signal).
|
|
484
507
|
* If the docs service or its `wildo.tech-doc.config.ts` is missing,
|
|
485
508
|
* {@link loadTechnicalDocConfig} fails closed with a CONFIGURATION
|
|
@@ -549,6 +572,7 @@ export class TechnicalDocCompanionService {
|
|
|
549
572
|
}> {
|
|
550
573
|
const noProblems: ApiReferenceResourceCategoryProblems = {
|
|
551
574
|
duplicateCategoryIds: [], resourcesInSeveralCategories: [], repeatedAssignments: [], unavailableAssignments: [], uncategorisedResourceNames: [],
|
|
575
|
+
engineResourceAssignments: [], categoriesShadowingEngine: [], unknownEngineCategories: [],
|
|
552
576
|
};
|
|
553
577
|
const techDocService = Object.values(this.companionContext.saasConfig.services)
|
|
554
578
|
.find((service) => service.frontendType === AppFrontendType.TECH_DOC);
|
|
@@ -602,13 +626,22 @@ export class TechnicalDocCompanionService {
|
|
|
602
626
|
...(apiDocResources !== undefined ? { apiDocResources } : {}),
|
|
603
627
|
...(excludedCoreResourceTypes !== undefined ? { excludedCoreResourceTypes } : {}),
|
|
604
628
|
};
|
|
629
|
+
/*
|
|
630
|
+
* `verifyAgainstSource` (#1775): every caller of this door either writes a committed artifact
|
|
631
|
+
* (`publishOpenApiReference`, `publishManagedDocumentation`) or predicts one (`wildo docs check`,
|
|
632
|
+
* the bundle derivation publication shares). A held answer compiled against a tree that has since
|
|
633
|
+
* moved is therefore never acceptable here. Without the option, a failed recompile after an engine
|
|
634
|
+
* change serves the pre-change derivation, and a publish wrote a byte-identical `api.json` and
|
|
635
|
+
* reported it current (measured 2026-09-26). With it, that recompile's failure is what comes back,
|
|
636
|
+
* and the throw below names it.
|
|
637
|
+
*/
|
|
605
638
|
const introspection = await this.companionIntrospectionService.requestInfo({
|
|
606
639
|
serviceKey: this.pickProjectorCarrierServiceKey(),
|
|
607
640
|
behavior: 'openapi-generation-input',
|
|
608
641
|
// Thread both the authored core-resource selection and the canonical
|
|
609
642
|
// runtime feature exclusions across the JSON-safe subprocess boundary.
|
|
610
643
|
...(Object.keys(input).length > 0 ? { input } : {}),
|
|
611
|
-
});
|
|
644
|
+
}, { verifyAgainstSource: true });
|
|
612
645
|
|
|
613
646
|
if (introspection.success === false) {
|
|
614
647
|
const failure = introspection;
|
|
@@ -660,13 +693,12 @@ export class TechnicalDocCompanionService {
|
|
|
660
693
|
/**
|
|
661
694
|
* Compose the subprocess projection with the
|
|
662
695
|
* `WildoSaasConfig`-derived metadata the parent process owns +
|
|
663
|
-
* the per-service `wildo.tech-doc.config.ts` block
|
|
664
|
-
* refactor — `saas-technical-doc.md`).
|
|
696
|
+
* the per-service `wildo.tech-doc.config.ts` block.
|
|
665
697
|
*
|
|
666
698
|
* The `publicMarketingTitle` projected into `openapi.info.title`
|
|
667
699
|
* comes from the per-service config (NOT from
|
|
668
700
|
* `WildoSaasConfig.technicalDoc?.publicMarketingTitle` — that root-
|
|
669
|
-
* level field was removed in
|
|
701
|
+
* level field was removed in favor of co-locating the
|
|
670
702
|
* tech-doc-specific config with the engine package that owns it).
|
|
671
703
|
*
|
|
672
704
|
* Re-parses the result through `OpenApiGenerationInputSchema`
|
|
@@ -732,7 +764,7 @@ export class TechnicalDocCompanionService {
|
|
|
732
764
|
* (unique) `frontendType: TECH_DOC` service declared in
|
|
733
765
|
* `wildo.saas.config.ts`.
|
|
734
766
|
*
|
|
735
|
-
* Discovery contract
|
|
767
|
+
* Discovery contract:
|
|
736
768
|
*
|
|
737
769
|
* - The TECH_DOC service is identified by `frontendType === TECH_DOC`,
|
|
738
770
|
* NOT by service key. This decouples the companion from any
|
|
@@ -883,7 +915,7 @@ export class TechnicalDocCompanionService {
|
|
|
883
915
|
throw new Error(`technical-documentation role labels require a declared backend service key: ${backendServiceKey}`);
|
|
884
916
|
}
|
|
885
917
|
const primaryLocale = getCompanionConfiguredPrimaryLanguage(this.appConfigService.config);
|
|
886
|
-
const i18nRoot = path.resolve(this.companionContext.saasRoot, backendService.path,
|
|
918
|
+
const i18nRoot = path.resolve(this.companionContext.saasRoot, backendService.path, BACKEND_I18N_TREE_RELATIVE_PATH);
|
|
887
919
|
const roleLabelsPath = resolvePerUnitFilePath({
|
|
888
920
|
i18nRoot,
|
|
889
921
|
unit: { filePathHint: ROLE_LABELLING_UNIT_FILE_PATH_HINT },
|
|
@@ -927,10 +959,12 @@ export class TechnicalDocCompanionService {
|
|
|
927
959
|
* A resource with no public route is in it too (the generator drops its empty group only after categorisation), so it
|
|
928
960
|
* still needs a category.
|
|
929
961
|
*
|
|
930
|
-
* All
|
|
962
|
+
* All eight are the application's own configuration, never a fault of the companion: a category id declared twice, a
|
|
931
963
|
* resource placed in two different categories, a resource listed twice in one category (`<categoryId>:<resourceName>`),
|
|
932
|
-
* a category naming a resource the reference does not document (`<categoryId>:<resourceName>`),
|
|
933
|
-
*
|
|
964
|
+
* a category naming a resource the reference does not document (`<categoryId>:<resourceName>`), a documented resource
|
|
965
|
+
* with no category from the config or from the engine, and the three #1840 added: an entry naming a resource the
|
|
966
|
+
* ENGINE already categorises (`<categoryId>:<resourceName>`), an application category whose id or label is an engine
|
|
967
|
+
* category's (its id), and an `engineCategory` that is no engine category (the value).
|
|
934
968
|
*/
|
|
935
969
|
export interface ApiReferenceResourceCategoryProblems {
|
|
936
970
|
readonly duplicateCategoryIds: readonly string[];
|
|
@@ -938,6 +972,9 @@ export interface ApiReferenceResourceCategoryProblems {
|
|
|
938
972
|
readonly repeatedAssignments: readonly string[];
|
|
939
973
|
readonly unavailableAssignments: readonly string[];
|
|
940
974
|
readonly uncategorisedResourceNames: readonly string[];
|
|
975
|
+
readonly engineResourceAssignments: readonly string[];
|
|
976
|
+
readonly categoriesShadowingEngine: readonly string[];
|
|
977
|
+
readonly unknownEngineCategories: readonly string[];
|
|
941
978
|
}
|
|
942
979
|
|
|
943
980
|
export function hasApiReferenceResourceCategoryProblems(findings: ApiReferenceResourceCategoryProblems): boolean {
|
|
@@ -945,7 +982,10 @@ export function hasApiReferenceResourceCategoryProblems(findings: ApiReferenceRe
|
|
|
945
982
|
|| findings.resourcesInSeveralCategories.length > 0
|
|
946
983
|
|| findings.repeatedAssignments.length > 0
|
|
947
984
|
|| findings.unavailableAssignments.length > 0
|
|
948
|
-
|| findings.uncategorisedResourceNames.length > 0
|
|
985
|
+
|| findings.uncategorisedResourceNames.length > 0
|
|
986
|
+
|| findings.engineResourceAssignments.length > 0
|
|
987
|
+
|| findings.categoriesShadowingEngine.length > 0
|
|
988
|
+
|| findings.unknownEngineCategories.length > 0;
|
|
949
989
|
}
|
|
950
990
|
|
|
951
991
|
/** Every problem in one sentence per kind, so a refusal names all of them at once rather than the first. */
|
|
@@ -966,6 +1006,15 @@ export function describeApiReferenceResourceCategoryProblems(findings: ApiRefere
|
|
|
966
1006
|
if (findings.uncategorisedResourceNames.length > 0) {
|
|
967
1007
|
sentences.push(`API-reference resources have no category, from this config or from the engine: ${findings.uncategorisedResourceNames.join(', ')}`);
|
|
968
1008
|
}
|
|
1009
|
+
if (findings.engineResourceAssignments.length > 0) {
|
|
1010
|
+
sentences.push(`API-reference categories name engine resources, which the engine groups itself: ${findings.engineResourceAssignments.join(', ')}`);
|
|
1011
|
+
}
|
|
1012
|
+
if (findings.categoriesShadowingEngine.length > 0) {
|
|
1013
|
+
sentences.push(`API-reference categories repeat an engine category's id or label (file the resources with engineCategory instead): ${findings.categoriesShadowingEngine.join(', ')}`);
|
|
1014
|
+
}
|
|
1015
|
+
if (findings.unknownEngineCategories.length > 0) {
|
|
1016
|
+
sentences.push(`API-reference engineCategory values name no engine category (${ENGINE_API_REFERENCE_CATEGORY_IDS.join(', ')}): ${findings.unknownEngineCategories.join(', ')}`);
|
|
1017
|
+
}
|
|
969
1018
|
return sentences.join('. ');
|
|
970
1019
|
}
|
|
971
1020
|
|
|
@@ -983,35 +1032,121 @@ export class ApiReferenceResourceCategoryError extends Error {
|
|
|
983
1032
|
}
|
|
984
1033
|
}
|
|
985
1034
|
|
|
1035
|
+
/**
|
|
1036
|
+
* The sentence a caller is owed when the documentation lane REFUSES what the application declares, or `undefined` when
|
|
1037
|
+
* `error` is not such a refusal (a broken host, a full disk: left to the caller's internal path).
|
|
1038
|
+
*
|
|
1039
|
+
* The ONE predicate every door asks (#3462). A documentation refusal is raised by the documentation routes
|
|
1040
|
+
* (`answerTechnicalDocFailure`) and, through the build's DOCUMENTATION_PUBLICATION generation step, by every door that
|
|
1041
|
+
* dispatches a build synchronously: the companion's build routes (`forwardBuildDispatchError`) and the workbench
|
|
1042
|
+
* board's verbs (`translateCreationPlaneDispatchError`). Each door used to keep its own list, so #1838's example refusal
|
|
1043
|
+
* reached the build routes as a bare 500 and the board recognised neither refusal. Adding a documentation refusal here
|
|
1044
|
+
* is the whole change; no door can be left behind.
|
|
1045
|
+
*
|
|
1046
|
+
* Matched by NAME, the property that survives every boundary the error can cross (the generator lives in another
|
|
1047
|
+
* package, and a second copy of a class would defeat `instanceof`). Rejected: a marker interface or a common base class
|
|
1048
|
+
* across the two packages, which would make `saas-technical-doc` depend on a companion type for no gain over the name.
|
|
1049
|
+
*
|
|
1050
|
+
* - The category refusal (#1891) names resources to add to or remove from `apiReferenceResourceCategories`; the
|
|
1051
|
+
* sentence appends where that configuration lives and how to check it.
|
|
1052
|
+
* - The authored-example refusal (#1838) names each example untrue of its schema (operation, where it is attached, its
|
|
1053
|
+
* title, the offending path); its own message already says to correct the operation's `examples`.
|
|
1054
|
+
*/
|
|
1055
|
+
export function describeDocumentationLaneRefusal(error: unknown): string | undefined {
|
|
1056
|
+
const name = (error as { name?: unknown } | null | undefined)?.name;
|
|
1057
|
+
if (name === API_REFERENCE_RESOURCE_CATEGORY_ERROR_NAME) {
|
|
1058
|
+
return `${(error as Error).message}. Fix apiReferenceResourceCategories in the documentation service's wildo.tech-doc.config.ts, then run \`wildo docs check\`.`;
|
|
1059
|
+
}
|
|
1060
|
+
if (name === OPENAPI_AUTHORED_EXAMPLE_ERROR_NAME) return (error as Error).message;
|
|
1061
|
+
return undefined;
|
|
1062
|
+
}
|
|
1063
|
+
|
|
1064
|
+
/** The engine's API-reference categories, in declaration order: the values an `engineCategory` may name. */
|
|
1065
|
+
const ENGINE_API_REFERENCE_CATEGORY_IDS: readonly string[] = Object.values(EngineResourceSubDomain);
|
|
1066
|
+
|
|
1067
|
+
type ApiReferenceResourceCategoryAssignments = NonNullable<WildoTechnicalDocConfig['apiReferenceResourceCategories']>;
|
|
1068
|
+
|
|
1069
|
+
/**
|
|
1070
|
+
* The category an assignment puts its resources in. An engine reference takes the engine's own words, so the group
|
|
1071
|
+
* reads identically whichever side a resource came from; `undefined` when the reference names no engine category.
|
|
1072
|
+
*/
|
|
1073
|
+
function resolveAssignedCategory(assignment: ApiReferenceResourceCategoryAssignments[number]): ApiReferenceResourceCategory | undefined {
|
|
1074
|
+
if (isApiReferenceEngineCategoryAssignment(assignment)) {
|
|
1075
|
+
if (!ENGINE_API_REFERENCE_CATEGORY_IDS.includes(assignment.engineCategory)) return undefined;
|
|
1076
|
+
const documentation = ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION[assignment.engineCategory as EngineResourceSubDomain];
|
|
1077
|
+
return { id: assignment.engineCategory, label: documentation.label, description: documentation.description };
|
|
1078
|
+
}
|
|
1079
|
+
return {
|
|
1080
|
+
id: assignment.id,
|
|
1081
|
+
label: assignment.label,
|
|
1082
|
+
...(assignment.description === undefined ? {} : { description: assignment.description }),
|
|
1083
|
+
};
|
|
1084
|
+
}
|
|
1085
|
+
|
|
1086
|
+
/** The id an assignment groups under: an application category's own id, or the engine category it names. */
|
|
1087
|
+
function assignedCategoryId(assignment: ApiReferenceResourceCategoryAssignments[number]): string {
|
|
1088
|
+
return isApiReferenceEngineCategoryAssignment(assignment) ? assignment.engineCategory : assignment.id;
|
|
1089
|
+
}
|
|
1090
|
+
|
|
1091
|
+
/**
|
|
1092
|
+
* Case and spacing do not make a different word: "notifications " is the engine's "Notifications". Only the same word
|
|
1093
|
+
* is refused; a near-synonym ("Notifications and webhooks") is left to the author, as no rule can tell it from a
|
|
1094
|
+
* genuinely different part of the product.
|
|
1095
|
+
*/
|
|
1096
|
+
function normalizedCategoryLabel(label: string): string {
|
|
1097
|
+
return label.trim().replace(/\s+/g, ' ').toLowerCase();
|
|
1098
|
+
}
|
|
1099
|
+
|
|
986
1100
|
/**
|
|
987
1101
|
* Checks the application's categories against the resource tags the projector resolved, and reports every problem
|
|
988
1102
|
* instead of stopping at the first. See {@link applyApiReferenceResourceCategories} for the completeness rule.
|
|
989
1103
|
*/
|
|
990
1104
|
export function findApiReferenceResourceCategoryProblems(
|
|
991
1105
|
resourceTags: readonly ResourceTag[],
|
|
992
|
-
categories:
|
|
1106
|
+
categories: ApiReferenceResourceCategoryAssignments,
|
|
993
1107
|
): ApiReferenceResourceCategoryProblems {
|
|
994
1108
|
const tagsByName = new Map(resourceTags.map((tag) => [tag.name, tag]));
|
|
995
1109
|
// The projector's own invariant, not the application's configuration: it stays an internal error.
|
|
996
1110
|
if (tagsByName.size !== resourceTags.length) throw new Error('OpenAPI resource tags must be unique before category assignment');
|
|
997
1111
|
|
|
1112
|
+
const engineLabels = new Set(Object.values(ENGINE_RESOURCE_SUB_DOMAIN_DOCUMENTATION).map((documentation) => normalizedCategoryLabel(documentation.label)));
|
|
998
1113
|
const seenCategoryIds = new Set<string>();
|
|
999
1114
|
const duplicateCategoryIds = new Set<string>();
|
|
1115
|
+
const categoriesShadowingEngine = new Set<string>();
|
|
1116
|
+
const unknownEngineCategories = new Set<string>();
|
|
1000
1117
|
/** Per resource, the DISTINCT category ids naming it; a second listing under the same id is a repeated assignment. */
|
|
1001
1118
|
const categoryIdsByResourceName = new Map<string, Set<string>>();
|
|
1002
1119
|
const repeatedAssignments = new Set<string>();
|
|
1003
1120
|
const unavailableAssignments: string[] = [];
|
|
1121
|
+
const engineResourceAssignments: string[] = [];
|
|
1004
1122
|
for (const category of categories) {
|
|
1005
|
-
|
|
1006
|
-
seenCategoryIds.add(
|
|
1123
|
+
const categoryId = assignedCategoryId(category);
|
|
1124
|
+
if (seenCategoryIds.has(categoryId)) duplicateCategoryIds.add(categoryId);
|
|
1125
|
+
seenCategoryIds.add(categoryId);
|
|
1126
|
+
if (isApiReferenceEngineCategoryAssignment(category)) {
|
|
1127
|
+
if (!ENGINE_API_REFERENCE_CATEGORY_IDS.includes(category.engineCategory)) unknownEngineCategories.add(category.engineCategory);
|
|
1128
|
+
} else if (ENGINE_API_REFERENCE_CATEGORY_IDS.includes(category.id) || engineLabels.has(normalizedCategoryLabel(category.label))) {
|
|
1129
|
+
categoriesShadowingEngine.add(category.id);
|
|
1130
|
+
}
|
|
1007
1131
|
for (const resourceName of category.resourceNames) {
|
|
1008
|
-
|
|
1009
|
-
|
|
1132
|
+
const tag = tagsByName.get(resourceName);
|
|
1133
|
+
if (tag === undefined) {
|
|
1134
|
+
unavailableAssignments.push(`${categoryId}:${resourceName}`);
|
|
1135
|
+
continue;
|
|
1136
|
+
}
|
|
1137
|
+
/*
|
|
1138
|
+
* A tag reaching this join with a category already carries the ENGINE's (the projector sets one only for an
|
|
1139
|
+
* engine resource, from the engine's own specification; the manual route groups likewise). Moving it is what
|
|
1140
|
+
* #1840 measured: an application re-filing engine resources into its own taxonomy leaves every engine resource
|
|
1141
|
+
* added later in the engine's group, beside the application's twin of it.
|
|
1142
|
+
*/
|
|
1143
|
+
if (tag.category !== undefined) {
|
|
1144
|
+
engineResourceAssignments.push(`${categoryId}:${resourceName}`);
|
|
1010
1145
|
continue;
|
|
1011
1146
|
}
|
|
1012
1147
|
const categoryIds = categoryIdsByResourceName.get(resourceName) ?? new Set<string>();
|
|
1013
|
-
if (categoryIds.has(
|
|
1014
|
-
categoryIds.add(
|
|
1148
|
+
if (categoryIds.has(categoryId)) repeatedAssignments.add(`${categoryId}:${resourceName}`);
|
|
1149
|
+
categoryIds.add(categoryId);
|
|
1015
1150
|
categoryIdsByResourceName.set(resourceName, categoryIds);
|
|
1016
1151
|
}
|
|
1017
1152
|
}
|
|
@@ -1027,32 +1162,38 @@ export function findApiReferenceResourceCategoryProblems(
|
|
|
1027
1162
|
.filter((tag) => !categoryIdsByResourceName.has(tag.name) && tag.category === undefined)
|
|
1028
1163
|
.map((tag) => tag.name)
|
|
1029
1164
|
.sort(),
|
|
1165
|
+
engineResourceAssignments: engineResourceAssignments.sort(),
|
|
1166
|
+
categoriesShadowingEngine: [...categoriesShadowingEngine].sort(),
|
|
1167
|
+
unknownEngineCategories: [...unknownEngineCategories].sort(),
|
|
1030
1168
|
};
|
|
1031
1169
|
}
|
|
1032
1170
|
|
|
1033
1171
|
/**
|
|
1034
|
-
* Attaches the
|
|
1035
|
-
* resource tags before OpenAPI generation.
|
|
1172
|
+
* Attaches the application's API-reference categories to the resolved resource tags before OpenAPI generation.
|
|
1036
1173
|
*
|
|
1037
|
-
* The operation subprocess owns the resolved resource inventory and
|
|
1038
|
-
*
|
|
1039
|
-
*
|
|
1040
|
-
*
|
|
1041
|
-
*
|
|
1042
|
-
* required: an uncategorised new resource or a stale config name must stop
|
|
1043
|
-
* publication instead of quietly producing a misleading partial navigation.
|
|
1174
|
+
* The operation subprocess owns the resolved resource inventory and specification facts, and gives every ENGINE
|
|
1175
|
+
* resource its category from the engine's own vocabulary (`projectResourceTag`). The TECH_DOC config owns how the
|
|
1176
|
+
* APPLICATION's resources are grouped. Joining them here keeps both truths in their owners, then makes the OpenAPI
|
|
1177
|
+
* document the sole transport to the browser. Once an application declares categories, the join is exact: an
|
|
1178
|
+
* uncategorised new resource or a stale config name stops publication instead of producing a partial navigation.
|
|
1044
1179
|
*
|
|
1045
|
-
* The completeness rule is about the RESULT
|
|
1046
|
-
*
|
|
1047
|
-
*
|
|
1048
|
-
*
|
|
1049
|
-
*
|
|
1050
|
-
*
|
|
1051
|
-
*
|
|
1052
|
-
*
|
|
1053
|
-
*
|
|
1054
|
-
* engine's
|
|
1055
|
-
*
|
|
1180
|
+
* The completeness rule is about the RESULT: a resource satisfies it by being assigned here or by carrying the
|
|
1181
|
+
* engine's category. An application publishes roughly eight resources of its own beside fifty-two of the engine's, so
|
|
1182
|
+
* a rule demanding the config name every one of them would make it hand-classify the engine's catalogue. Wonder CRM
|
|
1183
|
+
* opted out entirely for that reason until the engine categorised its own (#1891).
|
|
1184
|
+
*
|
|
1185
|
+
* ## Why an application may no longer move an engine resource (#1840)
|
|
1186
|
+
*
|
|
1187
|
+
* It could, until #1840: an explicit assignment won over the engine's category. Your Application used that to re-file the
|
|
1188
|
+
* engine catalogue into a taxonomy of its own, written once, and every engine resource added afterwards fell into the
|
|
1189
|
+
* engine's group beside the application's twin of it. Measured on its reference: 21 groups, 8 of them single, and five
|
|
1190
|
+
* near-duplicate pairs ("Notifications and webhooks" / "Notifications", "Organization management" / "Organizations",
|
|
1191
|
+
* "Automation and agents" / "Automation"…). A taxonomy that overrides another can only stay whole while someone
|
|
1192
|
+
* re-reads the other one at every change, which nobody does; so there is one vocabulary for the engine's resources,
|
|
1193
|
+
* the engine's, and the application files its OWN resources either into an application category or, by
|
|
1194
|
+
* `engineCategory`, into the engine's. Rejected: keeping the override and refusing a PARTIAL one (a sub-domain must be
|
|
1195
|
+
* re-filed whole or not at all). It still breaks the day the engine adds a resource, turning drift into a refusal in an
|
|
1196
|
+
* application that did nothing, and it keeps two vocabularies for one thing.
|
|
1056
1197
|
*/
|
|
1057
1198
|
export function applyApiReferenceResourceCategories(
|
|
1058
1199
|
resourceTags: readonly ResourceTag[],
|
|
@@ -1061,24 +1202,15 @@ export function applyApiReferenceResourceCategories(
|
|
|
1061
1202
|
if (categories === undefined) return [...resourceTags];
|
|
1062
1203
|
const findings = findApiReferenceResourceCategoryProblems(resourceTags, categories);
|
|
1063
1204
|
if (hasApiReferenceResourceCategoryProblems(findings)) throw new ApiReferenceResourceCategoryError(findings);
|
|
1064
|
-
|
|
1065
|
-
|
|
1066
|
-
|
|
1067
|
-
|
|
1068
|
-
|
|
1069
|
-
|
|
1070
|
-
for (const category of categories) for (const resourceName of category.resourceNames) categoryByResourceName.set(resourceName, category);
|
|
1205
|
+
const categoryByResourceName = new Map<string, ApiReferenceResourceCategory>();
|
|
1206
|
+
for (const category of categories) {
|
|
1207
|
+
// Every engine reference resolves here: an unknown one is a finding, refused above.
|
|
1208
|
+
const resolved = resolveAssignedCategory(category)!;
|
|
1209
|
+
for (const resourceName of category.resourceNames) categoryByResourceName.set(resourceName, resolved);
|
|
1210
|
+
}
|
|
1071
1211
|
return resourceTags.map((tag) => {
|
|
1072
1212
|
const category = categoryByResourceName.get(tag.name);
|
|
1073
|
-
|
|
1074
|
-
return {
|
|
1075
|
-
...tag,
|
|
1076
|
-
category: {
|
|
1077
|
-
id: category.id,
|
|
1078
|
-
label: category.label,
|
|
1079
|
-
...(category.description === undefined ? {} : { description: category.description }),
|
|
1080
|
-
},
|
|
1081
|
-
};
|
|
1213
|
+
return category === undefined ? { ...tag } : { ...tag, category: { ...category } };
|
|
1082
1214
|
});
|
|
1083
1215
|
}
|
|
1084
1216
|
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
# domain-plan.record-partition
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-specifications`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Whether an outside system's records are SPLIT BY LEGAL ENTITY: an ERP holding several companies of one group
|
|
14
|
+
* (Odoo companies, NetSuite subsidiaries), whose requirements say each subsidiary sees only its own records ("each
|
|
15
|
+
* subsidiary sees its own suppliers").
|
|
16
|
+
*
|
|
17
|
+
* ## Two halves, and the plan decides only one of them
|
|
18
|
+
*
|
|
19
|
+
* WHETHER the records are split is a product fact the requirements state, and the model says it
|
|
20
|
+
* (`splitByLegalEntity` on the generation contract). HOW the system splits them (which field carries the entity) is a
|
|
21
|
+
* fact about the VENDOR, which its system-of-record facet declares (`partition`), and the model never states it:
|
|
22
|
+
* the generation normalizer LAYS IT DOWN from the facet ({@link layDownDomainPlanRecordPartition}). So the plan can say
|
|
23
|
+
* a split the system cannot make only as `CANNOT_BE_SPLIT`, never as a partition nobody declared.
|
|
24
|
+
*
|
|
25
|
+
* Which unit each entity maps to is not a plan decision either: it is the operator's assignment of each remote partition
|
|
26
|
+
* to an organization unit at runtime (`systemOfRecordPartitionAssignments`), and the confinements already say which
|
|
27
|
+
* resources follow units.
|
|
28
|
+
*
|
|
29
|
+
* ## What each member makes the build do
|
|
30
|
+
*
|
|
31
|
+
* The split is a property of the system's INSTANCE (`systemsOfRecord.<name>.partition: true`), so every resource read from
|
|
32
|
+
* one instance is split alike, and the validator refuses two entries of one system that disagree. The binding task
|
|
33
|
+
* declares the flag ({@link domainPlanRecordPartitionPartitionsInstance}), and a copied resource then stamps each row's
|
|
34
|
+
* unit and entity key on its pipeline (`partitionUnitLocalField`, `partitionKeyLocalField`).
|
|
35
|
+
*
|
|
36
|
+
* Exported from `@wildo-ai/saas-specifications/application-creation`, with the domain plan's other schemas.
|
|
37
|
+
*/
|
|
38
|
+
export enum DomainPlanRecordPartition {
|
|
39
|
+
/** The requirements do not split the records: every member who may read the resource sees every entity's records. */
|
|
40
|
+
NOT_SPLIT = 'NOT_SPLIT',
|
|
41
|
+
/**
|
|
42
|
+
* Split by legal entity on the field the system's EFFECTIVE facet declares (`partitionField`, laid down from the facet,
|
|
43
|
+
* a facet augmentation the instance opted into included): the instance is partitioned, and a member sees the entities assigned to the units they hold a role in.
|
|
44
|
+
*/
|
|
45
|
+
BY_LEGAL_ENTITY = 'BY_LEGAL_ENTITY',
|
|
46
|
+
/**
|
|
47
|
+
* The requirements split the records by legal entity, and the system's effective facet (its base facet and any
|
|
48
|
+
* augmentation its instance opted into) declares no partition the engine can confine on (none at all, a path-segment
|
|
49
|
+
* partition, or no facet of that kind). The records cannot be split: every
|
|
50
|
+
* member who may read the resource sees every entity's records. The plan says so rather than claiming a split, and the
|
|
51
|
+
* validator warns.
|
|
52
|
+
*/
|
|
53
|
+
CANNOT_BE_SPLIT = 'CANNOT_BE_SPLIT',
|
|
54
|
+
/**
|
|
55
|
+
* The requirements split the records by legal entity, and the facets could not be read when the plan was written (an
|
|
56
|
+
* application that has not installed the facet library yet), or the engine's resolution refused the system's facet. The plan records the request without a partition field;
|
|
57
|
+
* the build still partitions the instance, and the backend refuses `partition: true` at startup on a vendor whose facet
|
|
58
|
+
* declares none, so the split is confirmed there or refused by name. The validator warns.
|
|
59
|
+
*/
|
|
60
|
+
UNCONFIRMED = 'UNCONFIRMED',
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Whether a record partition makes the system's INSTANCE partitioned (`partition: true`): what the binding task declares
|
|
65
|
+
* and its landing probe compares. Total over {@link DomainPlanRecordPartition} (no default), so a member added tomorrow is
|
|
66
|
+
* a compile error here until somebody decides.
|
|
67
|
+
*/
|
|
68
|
+
export function domainPlanRecordPartitionPartitionsInstance(partition: DomainPlanRecordPartition): boolean {
|
|
69
|
+
switch (partition) {
|
|
70
|
+
case DomainPlanRecordPartition.BY_LEGAL_ENTITY:
|
|
71
|
+
case DomainPlanRecordPartition.UNCONFIRMED:
|
|
72
|
+
return true;
|
|
73
|
+
case DomainPlanRecordPartition.NOT_SPLIT:
|
|
74
|
+
case DomainPlanRecordPartition.CANNOT_BE_SPLIT:
|
|
75
|
+
return false;
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
```
|
|
79
|
+
|
|
80
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
81
|
+
|
|
82
|
+
```typescript
|
|
83
|
+
*
|
|
84
|
+
* LAYS DOWN one record location's partition from the facet, never from the model: the model says only whether
|
|
85
|
+
* the requirements split the records (`splitByLegalEntity`). A split on a kind whose facet declares a confinable partition
|
|
86
|
+
* is `BY_LEGAL_ENTITY` on that facet's field; on a kind whose facet declares none, or that has no facet, it is
|
|
87
|
+
* `CANNOT_BE_SPLIT`; with no facets read (`partitionFields` undefined), or a kind whose facet could not be resolved, it is
|
|
88
|
+
* `UNCONFIRMED`. The facets are the application's effective ones, a facet augmentation's partition included. Pure.
|
|
89
|
+
*/
|
|
90
|
+
export function layDownDomainPlanRecordPartition(input: {
|
|
91
|
+
readonly systemOfRecordKind: string;
|
|
92
|
+
readonly splitByLegalEntity: boolean;
|
|
93
|
+
readonly partitionFields: DomainPlanSystemOfRecordPartitionFields | undefined;
|
|
94
|
+
}): { readonly partition: DomainPlanRecordPartition; readonly partitionField?: string } {
|
|
95
|
+
if (!input.splitByLegalEntity) return { partition: DomainPlanRecordPartition.NOT_SPLIT };
|
|
96
|
+
if (input.partitionFields === undefined) return { partition: DomainPlanRecordPartition.UNCONFIRMED };
|
|
97
|
+
if (!Object.hasOwn(input.partitionFields, input.systemOfRecordKind)) return { partition: DomainPlanRecordPartition.CANNOT_BE_SPLIT };
|
|
98
|
+
const field = input.partitionFields[input.systemOfRecordKind];
|
|
99
|
+
if (typeof field === 'string') return { partition: DomainPlanRecordPartition.BY_LEGAL_ENTITY, partitionField: field };
|
|
100
|
+
// A refusal is a value (see `DomainPlanSystemOfRecordPartitionFields`); `null` is a facet with no partition.
|
|
101
|
+
return field !== null && typeof field === 'object'
|
|
102
|
+
? { partition: DomainPlanRecordPartition.UNCONFIRMED }
|
|
103
|
+
: { partition: DomainPlanRecordPartition.CANNOT_BE_SPLIT };
|
|
104
|
+
}
|
|
105
|
+
```
|
|
@@ -98,8 +98,10 @@ const ALLOWED_BARE_SPECIFIERS: ReadonlySet<string> = new Set([
|
|
|
98
98
|
'node:path',
|
|
99
99
|
/**
|
|
100
100
|
* `node:module` and `node:url` — the blog's React MDX integration (`blog-react-mdx.integration.ts`, on the
|
|
101
|
-
* `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/
|
|
101
|
+
* `astro.ts` sub-entry) resolves the MDX compiler through the site's own `@astrojs/markdown-remark` with `createRequire`,
|
|
102
102
|
* and names the site root in its refusal with `fileURLToPath`. It runs in `astro.config.ts`, never in an island.
|
|
103
|
+
* The blog-cover resolver's `own-dependency-specifier.ts` (#2997) uses both too, inside the site's prerender
|
|
104
|
+
* chunks: it resolves `sharp` from this package's installed copy where the bundled bare import cannot.
|
|
103
105
|
*/
|
|
104
106
|
'node:module',
|
|
105
107
|
'node:url',
|