@wildo-ai/framework-knowledge 1.1.11 → 1.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +4 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +25 -3
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +40 -12
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +3 -3
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +12 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +19 -2
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +33 -9
- package/dist/esm/framework-knowledge.definitions.d.ts +2 -3
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +170 -32
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +6 -4
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -1
- package/dist/esm/framework-knowledge.schemas.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.schemas.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +4 -12
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +12 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +7 -4
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +76 -14
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +0 -4
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +3 -15
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +35 -14
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +16 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +19 -8
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +29 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +80 -16
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +5 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +3 -2
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +45 -10
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +61 -21
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +4 -3
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +8 -5
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +3 -5
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js +3 -3
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +8 -6
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +5 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +8 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +6 -4
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +4 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +10 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +36 -13
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts +8 -2
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +7 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +34 -6
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +5 -2
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +4 -3
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +22 -10
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +39 -29
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +8 -3
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +16 -7
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +2 -2
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +13 -5
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +3 -7
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +12 -14
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +3 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +4 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +14 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +3 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +4 -2
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +34 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +35 -17
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -1
- package/dist/esm/source-anchor-grammar.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +4 -4
- package/dist/knowledge/playbooks/bottom_up.build/method.md +12 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +5 -3
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +439 -27
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +15 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +203 -7
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -5
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +104 -2
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +59 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +18 -6
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +121 -24
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +51 -7
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +15 -8
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +2 -1
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +10 -2
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +34 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +9 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +27 -12
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +11 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +4 -4
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +7 -2
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +1 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +6 -6
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +3 -4
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +56 -5
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +6 -4
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +5 -1
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +8 -1
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +11 -4
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +16 -6
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +43 -11
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +24 -8
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +49 -14
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +3 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +6 -2
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +20 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +69 -65
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +11 -7
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +3 -1
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +11 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +4 -2
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +4 -3
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +3 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +3 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -0
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +10 -6
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +7 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +5 -1
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +6 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +19 -1
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +16 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +9 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +17 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +59 -15
- package/dist/knowledge/references/application-documentation-chapters.config.md +45 -10
- package/dist/knowledge/references/application-documentation-plan.config.md +2 -2
- package/dist/knowledge/references/application-maturity.config.md +27 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +4 -2
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +52 -11
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +38 -1
- package/dist/knowledge/references/brand.name-screening.config.md +30 -3
- package/dist/knowledge/references/build-plan.task-graph.config.md +200 -4
- package/dist/knowledge/references/business-model.pricing-plan.config.md +12 -9
- package/dist/knowledge/references/business-model.snapshot.config.md +29 -2
- package/dist/knowledge/references/business-model.snapshot.validation.md +11 -8
- package/dist/knowledge/references/companion.introspection.behaviors.market.md +3 -0
- package/dist/knowledge/references/companion.market.generation-service.md +46 -5
- package/dist/knowledge/references/companion.market.prompt-renderer.md +1 -1
- package/dist/knowledge/references/companion.technical-doc.service.md +195 -63
- package/dist/knowledge/references/domain-plan.record-partition.md +105 -0
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +3 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +69 -15
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +10 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +6 -0
- package/dist/knowledge/references/example.backend.custom-operation.declared-refusal-code.md +41 -0
- package/dist/knowledge/references/example.backend.custom-operation.external-effect-reservation.md +107 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +4 -2
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +8 -5
- package/dist/knowledge/references/example.infra.environment-config.local.md +13 -66
- package/dist/knowledge/references/example.module.companion-exports.full.md +1 -0
- package/dist/knowledge/references/example.module.relationships.actor-edge-back-to-scope-owner.md +35 -35
- package/dist/knowledge/references/example.navigation.one-entry-per-concept.md +47 -0
- package/dist/knowledge/references/example.organization-identity.system-of-record-partitions.md +18 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +28 -4
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -4
- package/dist/knowledge/references/example.resource.custom-view.backend-refusal.md +75 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +8 -7
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +37 -2
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +0 -1
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +1 -1
- package/dist/knowledge/references/example.resource.ui-behavior.workflow-record-page.md +212 -0
- package/dist/knowledge/references/example.subject-export.portability-archive.md +42 -0
- package/dist/knowledge/references/example.views.app-level.workflow-home.md +238 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +3 -3
- package/dist/knowledge/references/example.website.pricing.audit-payloads.md +38 -0
- package/dist/knowledge/references/example.website.pricing.catalog-load.md +77 -0
- package/dist/knowledge/references/example.website.pricing.offers.md +43 -0
- package/dist/knowledge/references/example.website.pricing.plans-section.md +20 -0
- package/dist/knowledge/references/example.website.pricing.plans.md +88 -0
- package/dist/knowledge/references/example.website.section.stats.md +1 -1
- package/dist/knowledge/references/experience-plan.config.md +111 -1
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +2 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +8 -1
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +104 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +11 -6
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +165 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +1035 -19
- package/dist/knowledge/references/external-connectors.private.provider-compliance-state-collector.md +36 -0
- package/dist/knowledge/references/external-connectors.private.provider-configuration-check.md +69 -0
- package/dist/knowledge/references/integration-plan.config.md +7 -7
- package/dist/knowledge/references/placement-plan.config.md +19 -0
- package/dist/knowledge/references/platform.config.backing-services.md +9 -11
- package/dist/knowledge/references/platform.config.environment.deployment.md +133 -8
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +3 -3
- package/dist/knowledge/references/platform.config.infrastructure-host.md +0 -1
- package/dist/knowledge/references/platform.config.platform-key-management.md +84 -8
- package/dist/knowledge/references/platform.config.saas.md +20 -18
- package/dist/knowledge/references/presets.3d.frame-style-resolution.md +65 -0
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +1 -1
- package/dist/knowledge/references/presets.models.field-form-control-variant.md +32 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +39 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +3 -3
- package/dist/knowledge/references/presets.models.surface-variant.md +5 -4
- package/dist/knowledge/references/presets.themes.compose-theme.md +2 -1
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +4 -4
- package/dist/knowledge/references/requirements.snapshot.config.md +2 -3
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +29 -2
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +11 -4
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +21 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +5 -1
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +13 -1
- package/dist/knowledge/references/saas.backend.custom-operation.authoritative-fields.md +4 -1
- package/dist/knowledge/references/saas.backend.custom-operation.core-write-precondition.md +38 -0
- package/dist/knowledge/references/saas.backend.custom-operation.external-effect-reservation.md +109 -0
- package/dist/knowledge/references/saas.backend.custom-operation.hook-transaction-posture.md +43 -0
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +1 -1
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +62 -13
- package/dist/knowledge/references/saas.backend.domain-module.md +30 -1
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +26 -3
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +13 -1
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +363 -2
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +5 -3
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +1 -1
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +9 -4
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +2 -1
- package/dist/knowledge/references/saas.backend.privacy.subject-export-archive.md +26 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +21 -19
- package/dist/knowledge/references/saas.backend.system-access-service.md +159 -4
- package/dist/knowledge/references/saas.config.content-security-policy.md +26 -9
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +1 -1
- package/dist/knowledge/references/saas.data-seeding.modes.md +4 -1
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +2 -4
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +6 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +2 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard-view.md +43 -0
- package/dist/knowledge/references/saas.frontend.chart-dashboard.md +130 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +8 -4
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +76 -9
- package/dist/knowledge/references/saas.frontend.command-menu.search-resource.md +3 -3
- package/dist/knowledge/references/saas.frontend.errors.backend-refusal.md +96 -0
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +40 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +4 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +3 -5
- package/dist/knowledge/references/saas.frontend.record-page-parts.md +117 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +46 -16
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +6 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +1 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +43 -9
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +259 -15
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -2
- package/dist/knowledge/references/saas.frontend.section-stages.md +63 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +42 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +6 -9
- package/dist/knowledge/references/saas.frontend.viewer-may-perform-operation.md +52 -0
- package/dist/knowledge/references/saas.models.agent-suspension.md +8 -8
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +21 -0
- package/dist/knowledge/references/saas.models.auth.relationship-grantor-authentication.md +2 -2
- package/dist/knowledge/references/saas.models.config.declared-type-renames.md +246 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +20 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +39 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +10 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +2 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +39 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +7 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +0 -78
- package/dist/knowledge/references/saas.models.engine-capabilities.md +11 -2
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +3 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +15 -8
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +13 -9
- package/dist/knowledge/references/saas.models.flows-actors.agent-configuration.md +29 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +7 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +8 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +47 -12
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +31 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +3 -3
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +21 -2
- package/dist/knowledge/references/saas.models.guidance-flow.md +1 -1
- package/dist/knowledge/references/saas.models.http-api-binding.md +19 -8
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +1 -1
- package/dist/knowledge/references/saas.models.inbound-channels.md +71 -2
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +1 -1
- package/dist/knowledge/references/saas.models.notifications.targets.md +3 -1
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +201 -15
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +2 -1
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +5 -2
- package/dist/knowledge/references/saas.models.organizations.identity-declaration.md +201 -0
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +25 -3
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +6 -2
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +14 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +1 -0
- package/dist/knowledge/references/saas.models.privacy.data-residency.md +676 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +46 -2
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +6 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +84 -1
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +10 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +5 -3
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +2 -0
- package/dist/knowledge/references/saas.models.privacy.subject-export.md +134 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +5 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +12 -6
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +15 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-reach.md +132 -0
- package/dist/knowledge/references/saas.models.providers.processing-region-selection.md +139 -0
- package/dist/knowledge/references/saas.models.representative-activity.md +4 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +107 -42
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +35 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +4 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-condition-parameters.md +56 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +16 -6
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +38 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +14 -16
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +2 -2
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +21 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +32 -15
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +5 -4
- package/dist/knowledge/references/saas.models.roles.definition.md +12 -1
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +6 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -2
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +65 -1
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +3 -1
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +16 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +75 -14
- package/dist/knowledge/references/saas.public-runtime.contract.md +41 -23
- package/dist/knowledge/references/saas.rag.retrieval-refusals.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +12 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +21 -2
- package/dist/knowledge/references/saas.specifications.engine-resource-sub-domain.md +105 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +6 -2
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +20 -3
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +100 -71
- package/dist/knowledge/references/saas.specifications.translation-glossary.md +80 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +44 -10
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +3 -2
- package/dist/knowledge/references/saas.website.blog.collection-config.md +36 -32
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +1 -1
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +2 -2
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +2 -2
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +26 -19
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +1 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +3 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +6 -3
- package/dist/knowledge/references/saas.website.label-keys.format.md +3 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +3 -1
- package/dist/knowledge/references/service-method.config.md +35 -2
- package/dist/knowledge/references/vision.constraint.config.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +60 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +46 -46
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +24 -0
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +11 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +4 -3
- package/dist/knowledge/references/zod.decorators.rag-source.md +20 -20
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +2 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +30 -24
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +63 -0
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +63 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +4 -4
- package/dist/knowledge/references/zod.factories.code.md +4 -4
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +4 -4
- package/dist/knowledge/references/zod.factories.phone.md +4 -4
- package/dist/knowledge/references/zod.factories.year-month.md +79 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +415 -2
- package/dist/knowledge/registries/playbooks.json +51 -39
- package/dist/knowledge/registries/source-tags.json +2412 -1604
- package/dist/knowledge/rules/database-migration-obligation.md +6 -7
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +24 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +1 -1
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +47 -12
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +30 -19
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +48 -13
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +2 -2
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +10 -11
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-supported-surfaces.md +64 -0
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +13 -11
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +28 -3
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +18 -1
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +22 -1
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +46 -2
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +5 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-organization-identity-declaration-api.md +247 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +12 -5
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +31 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +51 -14
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +4 -1
- package/dist/knowledge/skills/backend-custom-operation/references/declared-refusal-codes.md +95 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +2 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-core-write-precondition-api.md +73 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-handling-api.md +5 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-external-effect-reservation-api.md +276 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-hook-transaction-posture-api.md +79 -0
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +13 -2
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +30 -3
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +3 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +13 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +45 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +17 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +859 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +6 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +2 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +5 -1
- package/dist/knowledge/skills/config-app-shell/references/framework-command-menu-omnibox-api.md +3 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +4 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -1
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +8 -7
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +44 -1
- package/dist/knowledge/skills/config-navigation/SKILL.md +2 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +5 -0
- package/dist/knowledge/skills/config-navigation/references/one-entry-per-concept.md +101 -0
- package/dist/knowledge/skills/config-saas/SKILL.md +2 -2
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +40 -3
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +20 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +75 -11
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +21 -19
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +26 -9
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +197 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +16 -2
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +116 -16
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +20 -18
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +1 -1
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +5 -1
- package/dist/knowledge/skills/config-saas-backend/references/framework-declared-type-renames-api.md +261 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +20 -0
- package/dist/knowledge/skills/config-saas-backend/references/renaming-organization-and-user-types.md +69 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +6 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +28 -4
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +2 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +4 -1
- package/dist/knowledge/skills/electronic-signature-deliverables/SKILL.md +131 -0
- package/dist/knowledge/skills/electronic-signature-deliverables/references/what-makes-a-request-signed.md +61 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +11 -8
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +3 -2
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +31 -9
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +11 -4
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +26 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +18 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +8 -5
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +13 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +44 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +11 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +21 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +3 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +7 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +375 -8
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +30 -1
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +36 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +8 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +21 -2
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +2 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +1 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +33 -1
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +5 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +3 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +37 -14
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +1 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +31 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +39 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-translation-glossary-api.md +87 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +31 -9
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +16 -4
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +169 -23
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +38 -1
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +43 -4
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +15 -3
- package/dist/knowledge/skills/inbound-channels/references/sms-channel.md +93 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +125 -77
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +12 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +133 -8
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +0 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +84 -8
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +1 -1
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +16 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +72 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +12 -9
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +3 -3
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +2 -2
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +18 -10
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +7 -7
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +24 -2
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +33 -2
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +47 -6
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +61 -8
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +3 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +1 -1
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +107 -42
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +21 -2
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +30 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +92 -91
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +31 -5
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +2 -2
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +34 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +1 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +4 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +31 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +255 -12
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +4 -5
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-compliance-state-collector-api.md +96 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-configuration-check-api.md +130 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +8 -1
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +124 -3
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +165 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-processing-region-api.md +340 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +11 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +2 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +5 -2
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +17 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +1035 -19
- package/dist/knowledge/skills/resource-add-field/SKILL.md +7 -0
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +322 -15
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +9 -5
- package/dist/knowledge/skills/resource-add-resource/references/framework-engine-api-reference-categories-api.md +119 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +107 -42
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +2 -1
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +71 -5
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +2 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +48 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +33 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +15 -11
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +66 -27
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +140 -58
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +7 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +34 -10
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +5 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +158 -138
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +52 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +205 -19
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +253 -25
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +126 -1
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +259 -15
- package/dist/knowledge/skills/resource-custom-view/references/framework-backend-refusal-api.md +110 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +46 -12
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +15 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +19 -8
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/local-test-doubles.md +121 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/partition-from-the-domain-plan.md +230 -0
- package/dist/knowledge/skills/resource-external-data/references/presenting-a-copy-and-a-read-through.md +73 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +26 -5
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +76 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +8 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +12 -9
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +11 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +29 -2
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +20 -20
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +18 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +46 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +84 -1
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +10 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +5 -3
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +21 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +14 -2
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +4 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +78 -17
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +26 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +46 -46
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +36 -24
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +63 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +104 -23
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +123 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +72 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +42 -2
- package/dist/knowledge/skills/resource-status-lifecycle/references/framework-operation-condition-parameters-api.md +67 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +16 -12
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +66 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +89 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +11 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +263 -17
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-record-page-parts-api.md +155 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +83 -16
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +44 -10
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-section-stages-api.md +102 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +9 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +33 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +19 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/workflow-record-page.md +264 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +24 -4
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +12 -0
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +7 -6
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +42 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +6 -9
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +21 -2
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +26 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +121 -75
- package/dist/knowledge/skills/spec-resource-update/references/workflow-record-page-specification.md +237 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +100 -71
- package/dist/knowledge/skills/subject-data-export/SKILL.md +176 -0
- package/dist/knowledge/skills/subject-data-export/references/file-content-exclusions.md +15 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-api.md +142 -0
- package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md +33 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/workflow-home.md +373 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +36 -5
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +9 -5
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-composite-authoring/references/framework-chart-dashboard-api.md +244 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +40 -0
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +8 -6
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +70 -59
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +1 -1
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +3 -3
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +4 -2
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +3 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +20 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +6 -3
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-contact/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-hero/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +142 -98
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +178 -66
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +3 -1
- package/dist/knowledge/skills/website-section-problem/SKILL.md +3 -3
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +4 -4
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +1 -1
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +2 -2
- package/dist/knowledge/skills/website-section-stats/SKILL.md +3 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +3 -2
- package/dist/knowledge/skills/worker-authoring/SKILL.md +4 -2
- package/dist/knowledge/topic-index.json +2275 -715
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +6 -6
- package/dist/tsconfig.tsbuildinfo +0 -1
package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md
CHANGED
|
@@ -102,83 +102,112 @@ export function resourceSpecification<
|
|
|
102
102
|
: getZodObjectShape(schema)
|
|
103
103
|
) as ObjectShape<TSchema>;
|
|
104
104
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
}
|
|
105
|
+
/*
|
|
106
|
+
* The AUTHORED callback runs OUTSIDE the capture, exactly as every `...FromDefinition` factory calls its draft
|
|
107
|
+
* factory outside it (#3210 re-review): a throw there is the author's module failing to evaluate — most often an
|
|
108
|
+
* enum read as `undefined` because a workspace package has not been re-emitted yet — which is a load error, never
|
|
109
|
+
* this specification being refused. Capturing it would blame the run's spec for a stale build.
|
|
110
|
+
*/
|
|
111
|
+
const authoredConfig = configFactory({ schema, schemaShape });
|
|
112
|
+
/*
|
|
113
|
+
* From the derived-field refusals to the last definition-time validator, ONE capture (#3210): a reader evaluating
|
|
114
|
+
* the whole specifications package (the development companion) must get every OTHER resource when this one is
|
|
115
|
+
* refused, so inside a fault-collection window a refusal returns this specification MARKED rather than throwing
|
|
116
|
+
* through the package's import graph. Outside a window `captureSpecificationDefinitionFault` is the bare call and
|
|
117
|
+
* every refusal below throws exactly as before. See `specification-definition-faults.ts`.
|
|
118
|
+
*/
|
|
119
|
+
const resourceTypeHint = extractResourceTypeHintFromFactory(_factory);
|
|
120
|
+
let resolvedScope: ReturnType<typeof resolveScopeAndValidatorConfig> | undefined;
|
|
121
|
+
const definitionFault = captureSpecificationDefinitionFault(SpecificationDefinitionKind.RESOURCE, resourceTypeHint, () => {
|
|
122
|
+
const config = authoredConfig;
|
|
123
|
+
if (config.externalDataPipeline !== undefined) {
|
|
124
|
+
throw new Error(
|
|
125
|
+
'resourceSpecification(): `externalDataPipeline` is DERIVED from the resource configuration\'s pipeline declaration and cannot be authored. '
|
|
126
|
+
+ 'Remove it from the specification; supply `resourceRelationships` in the options and the description is attached from the declaration itself.',
|
|
127
|
+
);
|
|
128
|
+
}
|
|
112
129
|
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
130
|
+
// Resolve scope and the runtime config used by the pdfTemplates validator
|
|
131
|
+
// from whichever signal the spec author supplied. `resourceRelationships`
|
|
132
|
+
// is the preferred path — it materializes the resource configuration once
|
|
133
|
+
// with the real registry rels, so scope derives from the same
|
|
134
|
+
// `isPrimaryScope: true` signal the runtime uses, AND the validator gets
|
|
135
|
+
// a pre-resolved config (avoiding the failing `_factory([])` call for
|
|
136
|
+
// resources whose primary scope comes from a parent rel).
|
|
137
|
+
if (config.recordLabelFields !== undefined) {
|
|
138
|
+
throw new Error(
|
|
139
|
+
'resourceSpecification(): `recordLabelFields` is DERIVED from the resource configuration and cannot be authored (#2779). '
|
|
140
|
+
+ 'Remove it from the specification; supply `resourceRelationships` in the options and it is attached from the configuration itself.',
|
|
141
|
+
);
|
|
142
|
+
}
|
|
126
143
|
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
options,
|
|
130
|
-
);
|
|
144
|
+
resolvedScope = resolveScopeAndValidatorConfig(_factory, options);
|
|
145
|
+
const { declaredScope } = resolvedScope;
|
|
131
146
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
147
|
+
validateResourceOperationsCommunications(
|
|
148
|
+
'operations.',
|
|
149
|
+
config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
|
|
150
|
+
declaredScope,
|
|
151
|
+
);
|
|
152
|
+
validateResourceOperationsCommunications(
|
|
153
|
+
'frontend.views.',
|
|
154
|
+
config.frontend?.views as Record<string, ResourceFrontendViewSpecification | undefined> | undefined,
|
|
155
|
+
declaredScope,
|
|
156
|
+
);
|
|
157
|
+
validateResourceOperationsScheduledExecution(
|
|
158
|
+
'operations.',
|
|
159
|
+
config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
|
|
160
|
+
);
|
|
161
|
+
validateResourceOperationsErrorScenarios(
|
|
162
|
+
'operations.',
|
|
163
|
+
config.operations as Record<string, ResourceOperationSpecification | undefined> | undefined,
|
|
164
|
+
);
|
|
165
|
+
validateResourceOperationsScheduledExecution(
|
|
166
|
+
'frontend.views.',
|
|
167
|
+
config.frontend?.views as Record<string, ResourceFrontendViewSpecification | undefined> | undefined,
|
|
168
|
+
);
|
|
169
|
+
validateResourcePdfTemplates('', config.pdfTemplates, schema, resolvedScope.validatorResourceConfig);
|
|
170
|
+
validateResourceCollectionExports('', config.collectionExports, Object.keys(config.operations ?? {}));
|
|
156
171
|
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
|
|
179
|
-
|
|
172
|
+
// Fail-closed shape validator for `fields` /
|
|
173
|
+
// `additionalFieldSpecs`. Runs at module-load time so authors see
|
|
174
|
+
// structural mistakes (`meaning` blank, `enumDeclaration` missing,
|
|
175
|
+
// `arraySpec.elementMeaning` blank, ENUM-element array missing
|
|
176
|
+
// `elementType.enumDeclaration`, etc.) at the call site rather than
|
|
177
|
+
// inside a downstream rendered prompt. Registry-presence for
|
|
178
|
+
// `foreignKeySpec` is intentionally NOT checked here — `_core` does
|
|
179
|
+
// not see `ResourceRelationship[]`; the companion-level completeness
|
|
180
|
+
// validator owns that cross-check.
|
|
181
|
+
//
|
|
182
|
+
// The resource-type hint in the prefix comes from `_factory` (either
|
|
183
|
+
// the function's `name` stripped of the `_ResourceConfiguration_
|
|
184
|
+
// InitializationFactory` suffix, or — for rare object-form factories —
|
|
185
|
+
// the `resourceType` slot directly). Best-effort: when the hint cannot
|
|
186
|
+
// be derived, the prefix falls back to the bare `resourceSpecification():`
|
|
187
|
+
// label, matching the pre-hint behaviour.
|
|
188
|
+
const fieldShapesPrefix = resourceTypeHint.length > 0
|
|
189
|
+
? `resourceSpecification(${resourceTypeHint}): `
|
|
190
|
+
: 'resourceSpecification(): ';
|
|
191
|
+
validateFieldShapes(fieldShapesPrefix, {
|
|
192
|
+
fields: config.fields as Record<string, z.ZodTypeAny> | undefined,
|
|
193
|
+
additionalFieldSpecs: config.additionalFieldSpecs,
|
|
194
|
+
});
|
|
180
195
|
});
|
|
181
196
|
|
|
197
|
+
if (definitionFault !== undefined || resolvedScope === undefined) {
|
|
198
|
+
/*
|
|
199
|
+
* Refused inside a collection window. The returned object is never served: the reader drops every marked
|
|
200
|
+
* specification and reports the fault. It still carries what the callback produced, so a sibling factory handed
|
|
201
|
+
* it as a `base` (`resourceSpecificationFromFrontendConfiguration`) has a value to spread rather than a crash.
|
|
202
|
+
*/
|
|
203
|
+
return markSpecificationDefinitionFault(
|
|
204
|
+
{ ...authoredConfig, resourcePrimaryScope: resolvedScope?.declaredScope } as ResourceSpecificationConfig<TCustomOp, TCoreOp, TSchema>,
|
|
205
|
+
definitionFault ?? { kind: SpecificationDefinitionKind.RESOURCE, key: resourceTypeHint, message: 'resourceSpecification(): the definition was refused.', authoredFrame: null },
|
|
206
|
+
);
|
|
207
|
+
}
|
|
208
|
+
const config = authoredConfig;
|
|
209
|
+
const { declaredScope, validatorResourceConfig } = resolvedScope;
|
|
210
|
+
|
|
182
211
|
// Attach the resolved scope so the frontend-config sibling
|
|
183
212
|
// (`resourceSpecificationFromFrontendConfiguration`) can read it from
|
|
184
213
|
// `base.resourcePrimaryScope` and thread it into its own re-validation
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: subject-data-export
|
|
3
|
+
description: Answer a person's right-of-access (GDPR Art. 15) or data-portability (Art. 20) request with the engine's subject export, and deliver a portability request as one archive carrying the files they uploaded. Use when the user says "export everything we hold about this user", "answer a data access request", "build the download-my-data feature", "give the user their data in a portable format", "include the user's uploaded files in their export", "zip the export", or "why is this file missing from the export".
|
|
4
|
+
user-invocable: false
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Subject Data Export
|
|
8
|
+
|
|
9
|
+
### Target Application Framing
|
|
10
|
+
|
|
11
|
+
This knowledge is for configuring behavior in the target application.
|
|
12
|
+
Wildo is the framework surface being used, not the product being built.
|
|
13
|
+
|
|
14
|
+
Read and apply these patterns from the application-developer point of view:
|
|
15
|
+
|
|
16
|
+
- how the application should configure the relevant app-level file
|
|
17
|
+
- how the application should use framework-provided factories, enums, and helpers
|
|
18
|
+
- how the application should avoid mixing frontend, backend, and infrastructure concerns
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
## Overview
|
|
22
|
+
|
|
23
|
+
The engine assembles what the application holds about one person, `exportSubjectAsSystem`, and refuses to
|
|
24
|
+
assemble a misleading bundle. It has no route on purpose: the right binds the application, so who may ask, how
|
|
25
|
+
their identity is proven and how the result reaches them are the application's decisions. This skill is the call
|
|
26
|
+
and what to do with its answer. Which of your resources take part is decided where they are declared
|
|
27
|
+
(`systemAccessPolicy.exportSubject`, field provenance), not here.
|
|
28
|
+
|
|
29
|
+
A portability bundle also carries the BYTES of the files the person uploaded, opened lazily from storage and
|
|
30
|
+
checked against what was recorded; `writeSubjectExportArchive` streams it as one zip.
|
|
31
|
+
|
|
32
|
+
**Every application already has the self-service lane.** The engine resource `dataSubjectRequests` (Settings Hub
|
|
33
|
+
destination `my-data-subject-requests`) takes a signed-in person's `ACCESS_EXPORT` or `PORTABILITY_ARCHIVE` request
|
|
34
|
+
behind a fresh re-authentication, records it with its one-month deadline, answers it at once, and lets the person
|
|
35
|
+
download it signed in for seven days (`GET /api/v1/privacy/data-subject-requests/:requestId/download`), each download
|
|
36
|
+
assembled afresh and audited. Do not build a second "download my data" feature beside it. Call the export yourself only
|
|
37
|
+
for what that lane does not do: a delivery the person cannot reach by signing in, or an operator's own fulfilment.
|
|
38
|
+
|
|
39
|
+
## App Paths
|
|
40
|
+
|
|
41
|
+
| Surface | Glob (relative to the application root) |
|
|
42
|
+
|---|---|
|
|
43
|
+
| The request workflow that calls the export | `backend-api/src/modules/*/resources/*/*.operation.ts` |
|
|
44
|
+
| A scheduled fulfilment | `backend-api/src/**/*.batch*.ts` |
|
|
45
|
+
| Which resources take part | `shared-lib/src/modules/*/resources/*/*.resources-config.ts` (`systemAccessPolicy.exportSubject`) |
|
|
46
|
+
| Which fields a portability export carries | `shared-lib/src/modules/*/resources/*/*.schemas.ts` (`.portabilityProvenance()`) |
|
|
47
|
+
|
|
48
|
+
## When to Use
|
|
49
|
+
|
|
50
|
+
- Explaining or extending how the engine's `dataSubjectRequests` lane answers a copy request.
|
|
51
|
+
- An operator's own fulfilment, or a delivery the person cannot reach by signing in.
|
|
52
|
+
- A portability export must include the files a person uploaded.
|
|
53
|
+
- Explaining why a row, a field or a file is missing from an export.
|
|
54
|
+
|
|
55
|
+
## When NOT to Use
|
|
56
|
+
|
|
57
|
+
- Deciding whether a resource takes part, or which fields are portable → `resource-config-wiring`
|
|
58
|
+
(`references/framework-personal-data-declaration-api.md`) and `resource-schema-authoring`.
|
|
59
|
+
- Erasing a person → the engine's `dataSubjectRequests` workflow; see `compliance-document-authoring`.
|
|
60
|
+
- Exporting a LIST a user sees on screen (CSV of tasks) → that is a collection export, not a subject's data.
|
|
61
|
+
- Writing the privacy notice's rights clause → `compliance-document-authoring`.
|
|
62
|
+
|
|
63
|
+
## Workflow
|
|
64
|
+
|
|
65
|
+
0. **Check the engine lane covers it.** A signed-in person asking for their own copy is answered by
|
|
66
|
+
`dataSubjectRequests` (`request` with `kind: ACCESS_EXPORT | PORTABILITY_ARCHIVE`); place its Settings Hub
|
|
67
|
+
destination and stop here.
|
|
68
|
+
1. **Pick the right.** `SubjectExportPurpose.ACCESS_ART_15` discloses everything held concerning the person,
|
|
69
|
+
others' data withheld; `PORTABILITY_ART_20` carries only what they provided or the service observed, and
|
|
70
|
+
their own uploads with bytes. They are different bundles; never answer one with the other.
|
|
71
|
+
2. **Verify the requester first**, in your workflow. The export trusts its caller: reaching it is the decision.
|
|
72
|
+
3. **Call it** from a backend operation or batch: `utils.systemAccessService.exportSubjectAsSystem(CoreResourceType.USERS, userId, purpose, options)`.
|
|
73
|
+
For portability, `options.fileContents.maxTotalBytes` bounds the file bytes (1 byte to 3 GiB, 2 GiB by default).
|
|
74
|
+
4. **Write the archive** for portability: `writeSubjectExportArchive(bundle, output)`. If it rejects, destroy the
|
|
75
|
+
output and delete what was written: a file whose bytes did not verify fails the whole archive.
|
|
76
|
+
5. **Read the report** (`bundle.report`): edges left out and why, fields withheld (derived, non-disclosable,
|
|
77
|
+
others' data) and, for portability, `fileContentsExcluded`. Answer each in your reply to the person; read
|
|
78
|
+
`references/file-content-exclusions.md`.
|
|
79
|
+
6. **Deliver through a protected channel** (a time-limited download behind sign-in). Log `bundle.report` only.
|
|
80
|
+
The `SUBJECT_DATA_EXPORT` audit row is written for you, counts included.
|
|
81
|
+
|
|
82
|
+
## Worked Example
|
|
83
|
+
|
|
84
|
+
A portability request answered with one archive on disk, the files not carried returned so the reply can explain
|
|
85
|
+
them. The bound is lowered to 500 MiB; the archive is deleted if any file fails its check:
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
## Usage Example
|
|
89
|
+
|
|
90
|
+
```typescript
|
|
91
|
+
import { createWriteStream } from 'node:fs';
|
|
92
|
+
import { rm } from 'node:fs/promises';
|
|
93
|
+
import { finished } from 'node:stream/promises';
|
|
94
|
+
import { writeSubjectExportArchive, type SystemAccessBackendService } from '@wildo-ai/saas-backend-lib';
|
|
95
|
+
import { CoreResourceType, SubjectExportFileContentExclusion, SubjectExportPurpose } from '@wildo-ai/saas-models';
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* Answer a person's PORTABILITY request (GDPR Art. 20) with one zip: `export.json` plus every file they uploaded.
|
|
99
|
+
* Call it only after your request workflow has verified who is asking; deliver `archivePath` through your own protected
|
|
100
|
+
* channel (a time-limited download, never an email attachment).
|
|
101
|
+
*/
|
|
102
|
+
export async function writePortabilityArchive(
|
|
103
|
+
systemAccess: Pick<SystemAccessBackendService, 'exportSubjectAsSystem'>,
|
|
104
|
+
userId: string,
|
|
105
|
+
archivePath: string,
|
|
106
|
+
): Promise<{ filesNotCarried: { fileId: string; reason: SubjectExportFileContentExclusion }[] }> {
|
|
107
|
+
// The bound is yours to set (1 byte to 3 GiB, 2 GiB by default). A file past it keeps its row and is reported.
|
|
108
|
+
const bundle = await systemAccess.exportSubjectAsSystem(CoreResourceType.USERS, userId, SubjectExportPurpose.PORTABILITY_ART_20, {
|
|
109
|
+
fileContents: { maxTotalBytes: 500 * 1024 ** 2 },
|
|
110
|
+
});
|
|
111
|
+
const output = createWriteStream(archivePath);
|
|
112
|
+
try {
|
|
113
|
+
await writeSubjectExportArchive(bundle, output);
|
|
114
|
+
output.end();
|
|
115
|
+
await finished(output);
|
|
116
|
+
} catch (error) {
|
|
117
|
+
// A file whose bytes did not verify fails the archive: never deliver a partial one.
|
|
118
|
+
output.destroy();
|
|
119
|
+
await rm(archivePath, { force: true });
|
|
120
|
+
throw error;
|
|
121
|
+
}
|
|
122
|
+
// What the person did not receive, and why: answer it in your reply (e.g. offer the file door for OVER_SIZE_LIMIT).
|
|
123
|
+
// Log `bundle.report` if you need to; never `bundle.slices` or `bundle.fileContents`.
|
|
124
|
+
return { filesNotCarried: (bundle.report.fileContentsExcluded ?? []).map(({ fileId, reason }) => ({ fileId, reason })) };
|
|
125
|
+
}
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## References
|
|
129
|
+
|
|
130
|
+
- `references/framework-subject-export-api.md` — source-backed rights, bundle, file parts and exclusion reasons.
|
|
131
|
+
- `references/framework-subject-export-archive-api.md` — source-backed archive contract and byte bounds.
|
|
132
|
+
- `references/file-content-exclusions.md` — each reason a file is not carried, and what to tell the person.
|
|
133
|
+
|
|
134
|
+
## Verification
|
|
135
|
+
|
|
136
|
+
- [ ] The call sits behind your own identity check, and no route exposes it directly.
|
|
137
|
+
- [ ] A portability answer writes the archive and deletes it on failure.
|
|
138
|
+
- [ ] Nothing logs `bundle.slices` or `bundle.fileContents`.
|
|
139
|
+
- [ ] The reply to the person explains every `fileContentsExcluded` entry and every excluded edge.
|
|
140
|
+
|
|
141
|
+
Grep invariants (from the application root):
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
# every caller of the export, to review its identity check
|
|
145
|
+
rg -n "exportSubjectAsSystem" backend-api/src
|
|
146
|
+
# a portability caller that never writes the archive
|
|
147
|
+
rg -l "PORTABILITY_ART_20" backend-api/src
|
|
148
|
+
rg -l "writeSubjectExportArchive" backend-api/src
|
|
149
|
+
# a log line carrying the bundle's personal data (must print nothing)
|
|
150
|
+
rg -n "log[A-Za-z]*\(.*(slices|fileContents)" backend-api/src
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
## Common Rationalizations
|
|
154
|
+
|
|
155
|
+
| Rationalization | Reality |
|
|
156
|
+
|---|---|
|
|
157
|
+
| "We need our own download-my-data page." | The engine's `dataSubjectRequests` lane already records the request and its deadline, re-verifies the person, and delivers the copy behind sign-in; a second feature splits the evidence in two. |
|
|
158
|
+
| "One export for both rights is simpler." | The rights cover different data; a portability answer built from an access bundle hands over the controller's derived data, and the reverse leaves data out. |
|
|
159
|
+
| "Missing resources are just left out." | An undeclared participating resource refuses the export; that refusal is the point. Declare it. |
|
|
160
|
+
| "Email the zip, it is the user's own data." | It is a copy of everything about them; deliver it behind sign-in, time-limited. |
|
|
161
|
+
| "Raise the bound so nothing is ever left out." | Above 3 GiB the archive cannot be written; a file past your bound keeps its row and is reported, so offer the file door instead. |
|
|
162
|
+
| "A partial archive is better than none." | A file whose bytes do not match the recorded hash fails the archive; shipping it would hand over bytes nobody recorded. |
|
|
163
|
+
|
|
164
|
+
## Red Flags
|
|
165
|
+
|
|
166
|
+
- An HTTP route that calls `exportSubjectAsSystem` with no identity check (catch with the first grep above).
|
|
167
|
+
- A portability caller with no archive writer (catch with the two `rg -l` lines above).
|
|
168
|
+
- A logger call carrying `slices` or `fileContents` (catch with the last grep above).
|
|
169
|
+
- A reply that ignores `fileContentsExcluded` (catch with the verification checklist above).
|
|
170
|
+
|
|
171
|
+
## Related Skills
|
|
172
|
+
|
|
173
|
+
- `resource-config-wiring` — `systemAccessPolicy.exportSubject` and the personal-data declarations.
|
|
174
|
+
- `resource-schema-authoring` — `.portabilityProvenance()` on fields.
|
|
175
|
+
- `backend-custom-operation` — the operation your request workflow runs in (`utils.systemAccessService`).
|
|
176
|
+
- `compliance-document-authoring` — the privacy notice's rights clause and the erasure workflow.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# Why a file is not in a portability export, and what to tell the person
|
|
2
|
+
|
|
3
|
+
A portability export carries the bytes of the files the person uploaded. `bundle.report.fileContentsExcluded` names
|
|
4
|
+
every other file of theirs, each with a `reason` (`SubjectExportFileContentExclusion`). Answer each one in your reply.
|
|
5
|
+
|
|
6
|
+
| `reason` | Row in the export? | What it means | What to tell the person |
|
|
7
|
+
|---|---|---|---|
|
|
8
|
+
| `not_provided_by_subject` | No | Someone else uploaded it for them, or the service produced it (no uploader recorded) | It is in their ACCESS export; portability covers what they provided |
|
|
9
|
+
| `derived_from_another_file` | No | The service derived it from one of their files (a copy, a rendition) | The original is in the export, if they uploaded it |
|
|
10
|
+
| `not_servable` | Yes | Its status keeps the bytes back: quarantined, infected, still being scanned, or never completed (`detail` names it) | It is withheld for safety or not yet available; offer to send it once it clears |
|
|
11
|
+
| `held_by_remote_provider` | Yes | The bytes are held by a vendor (`detail` names it), never by the application | They can take it from that vendor directly |
|
|
12
|
+
| `over_size_limit` | Yes | It did not fit in the bound you set | Offer it through the file download, or a second request |
|
|
13
|
+
|
|
14
|
+
The row of a file whose bytes are withheld is still carried, so the person sees that the file exists. A file
|
|
15
|
+
someone else uploaded is never carried, even though the person owns it: Art. 20(4) protects the uploader.
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
# Subject export API (source-backed)
|
|
2
|
+
|
|
3
|
+
The two rights an export answers, the bundle it returns, the file parts a portability export carries and the reasons
|
|
4
|
+
a file is not carried, from `@wildo-ai/saas-models`.
|
|
5
|
+
|
|
6
|
+
Read this when:
|
|
7
|
+
- choosing between an access and a portability answer;
|
|
8
|
+
- reading a bundle's file parts or `report.fileContentsExcluded`;
|
|
9
|
+
- explaining why a file is missing from a portability export.
|
|
10
|
+
|
|
11
|
+
## Import Origins
|
|
12
|
+
|
|
13
|
+
- `@wildo-ai/saas-models`
|
|
14
|
+
|
|
15
|
+
## Source Excerpts
|
|
16
|
+
|
|
17
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
18
|
+
|
|
19
|
+
```typescript
|
|
20
|
+
/**
|
|
21
|
+
* WHICH data-subject right an export is answering.
|
|
22
|
+
*
|
|
23
|
+
* ## Why this is an enum and not a boolean flag on one bundle
|
|
24
|
+
*
|
|
25
|
+
* GDPR Art. 15 (right of access) and Art. 20 (right to data portability) are DIFFERENT rights over
|
|
26
|
+
* DIFFERENT data, and conflating them is the defect this capability was built to correct: the four
|
|
27
|
+
* routed export operations removed on 2026-08-01 declared themselves "portability / GDPR" while
|
|
28
|
+
* their actual options (`includeActivityData`, `includeOrganizationData`) described an *access*
|
|
29
|
+
* bundle. One output with a flag would reproduce that merge.
|
|
30
|
+
*
|
|
31
|
+
* - **Access** is a disclosure obligation: everything the controller holds *concerning* the subject,
|
|
32
|
+
* including data the controller itself derived about them, in any readable form.
|
|
33
|
+
* - **Portability** is a transfer obligation: only the data the subject *provided* — actively, or by
|
|
34
|
+
* using the service — and it must be machine-readable and re-importable elsewhere. Data the
|
|
35
|
+
* controller inferred is deliberately OUT of scope; a competitor must not receive a rival's
|
|
36
|
+
* analytics through a subject's portability request.
|
|
37
|
+
*
|
|
38
|
+
* The two therefore diverge at BOTH levels this module classifies: per-edge (see
|
|
39
|
+
* {@link classifySubjectExportDisposition}) and per-field (see
|
|
40
|
+
* {@link resolveSubjectExportFieldScope}).
|
|
41
|
+
*
|
|
42
|
+
* assurance-control: WILDO.PRIVACY.SUBJECT_DATA_EXPORT
|
|
43
|
+
*/
|
|
44
|
+
export enum SubjectExportPurpose {
|
|
45
|
+
/**
|
|
46
|
+
* Art. 15 — right of access. The broadest bundle: every row concerning the subject, whoever
|
|
47
|
+
* produced it, including rows the subject does not own (an audit log about them, a membership an
|
|
48
|
+
* administrator created).
|
|
49
|
+
*/
|
|
50
|
+
ACCESS_ART_15 = 'access_art_15',
|
|
51
|
+
|
|
52
|
+
/**
|
|
53
|
+
* Art. 20 — right to data portability. Narrower on purpose: only data the subject supplied or
|
|
54
|
+
* generated by using the service, and only from rows the subject owns. Controller-derived data is
|
|
55
|
+
* excluded by {@link DataPortabilityProvenance.DERIVED}.
|
|
56
|
+
*/
|
|
57
|
+
PORTABILITY_ART_20 = 'portability_art_20',
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
62
|
+
|
|
63
|
+
```typescript
|
|
64
|
+
/**
|
|
65
|
+
* Why a PORTABILITY export does not carry one of the subject's files (#3561). A named vocabulary because each reason sends
|
|
66
|
+
* the subject somewhere different: nowhere (not theirs to port), the file door (too large), the vendor (held there).
|
|
67
|
+
*/
|
|
68
|
+
export enum SubjectExportFileContentExclusion {
|
|
69
|
+
/** Someone else uploaded it for them (Art. 20(4)), or no uploader is recorded: not data they provided. Row not carried. */
|
|
70
|
+
NOT_PROVIDED_BY_SUBJECT = 'not_provided_by_subject',
|
|
71
|
+
/** The service derived it from another file (a thumbnail, extracted text): derived data. Row not carried. */
|
|
72
|
+
DERIVED_FROM_ANOTHER_FILE = 'derived_from_another_file',
|
|
73
|
+
/**
|
|
74
|
+
* Its status is outside what a download may serve (`FILE_DOWNLOADABLE_STATUSES`): quarantined, infected, not yet scanned,
|
|
75
|
+
* pending or failed. Never handed out; the row is carried and `detail` names the status.
|
|
76
|
+
*/
|
|
77
|
+
NOT_SERVABLE = 'not_servable',
|
|
78
|
+
/** A reference to a file a vendor holds (the engine never received its bytes): ported from that vendor. `detail` names it. */
|
|
79
|
+
HELD_BY_REMOTE_PROVIDER = 'held_by_remote_provider',
|
|
80
|
+
/** Carrying it would pass the export's byte bound: the row is carried, the bytes are fetched through the file door or a second request. */
|
|
81
|
+
OVER_SIZE_LIMIT = 'over_size_limit',
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/** One file a portability export does not carry the bytes of (#3561). */
|
|
85
|
+
export interface SubjectExportFileContentExclusionEntry {
|
|
86
|
+
fileId: string;
|
|
87
|
+
reason: SubjectExportFileContentExclusion;
|
|
88
|
+
/** The status (NOT_SERVABLE) or the storage provider (HELD_BY_REMOTE_PROVIDER); absent otherwise. */
|
|
89
|
+
detail?: string;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* One file a PORTABILITY export carries the bytes of (#3561), beside the rows. The bytes are opened lazily, so nothing is
|
|
94
|
+
* read from storage until the application writes the archive, and they are checked as they stream: against `size`, and
|
|
95
|
+
* against `contentSha256` when the service recorded one, the stream failing rather than handing over different bytes.
|
|
96
|
+
*/
|
|
97
|
+
export interface SubjectExportFileContentPart {
|
|
98
|
+
readonly fileId: string;
|
|
99
|
+
/** Where the archive puts the bytes: `files/<fileId>/<the file's name, made safe>` (`subjectExportFileContentPath`). */
|
|
100
|
+
readonly path: string;
|
|
101
|
+
readonly filename: string;
|
|
102
|
+
readonly mimeType: string;
|
|
103
|
+
readonly size: number;
|
|
104
|
+
readonly contentSha256?: string;
|
|
105
|
+
open(): Promise<AsyncIterable<Uint8Array>>;
|
|
106
|
+
}
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
110
|
+
|
|
111
|
+
```typescript
|
|
112
|
+
/**
|
|
113
|
+
* What an export ACTUALLY produced — the data, paired with the report that justifies its shape.
|
|
114
|
+
*
|
|
115
|
+
* ## Why the data and the report are one return value but two types
|
|
116
|
+
*
|
|
117
|
+
* {@link SubjectExportReport} is the compliance artifact: it survives the request, is safe to log
|
|
118
|
+
* and persist, and contains NO personal data — only per-edge dispositions and counts. The slices
|
|
119
|
+
* are the personal data itself, which must NOT be logged and whose lifetime ends when the artifact
|
|
120
|
+
* is written.
|
|
121
|
+
*
|
|
122
|
+
* Returning them together keeps the caller from having to correlate two results, while the type
|
|
123
|
+
* split keeps "safe to record" and "must be handled carefully" visibly distinct — a caller writing
|
|
124
|
+
* `logger.info({ report })` is correct, and the same line with `bundle` would be a leak. Fusing
|
|
125
|
+
* them into one flat object would erase exactly that distinction.
|
|
126
|
+
*/
|
|
127
|
+
export interface SubjectExportBundle {
|
|
128
|
+
report: SubjectExportReport;
|
|
129
|
+
slices: SubjectExportResourceSlice[];
|
|
130
|
+
/**
|
|
131
|
+
* #2903: the public key records that verify the signed evidence in the slices (an approval seal's `jws` names its
|
|
132
|
+
* `kid`), as the application keeps them: so the subject can check a seal offline with what the export handed over.
|
|
133
|
+
* Public material, not personal data. Absent when no slice carries a signature.
|
|
134
|
+
*/
|
|
135
|
+
verificationKeys?: SubjectExportVerificationKey[];
|
|
136
|
+
/**
|
|
137
|
+
* PORTABILITY only (#3561): the bytes of the subject's own files that they uploaded, one part per file, opened lazily.
|
|
138
|
+
* Absent on an access export and when there is no such file. Not personal data a log may hold: never log the parts.
|
|
139
|
+
*/
|
|
140
|
+
fileContents?: SubjectExportFileContentPart[];
|
|
141
|
+
}
|
|
142
|
+
```
|
package/dist/knowledge/skills/subject-data-export/references/framework-subject-export-archive-api.md
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# Subject export archive API (source-backed)
|
|
2
|
+
|
|
3
|
+
`writeSubjectExportArchive` and the byte bounds a portability export accepts, from `@wildo-ai/saas-backend-lib`.
|
|
4
|
+
|
|
5
|
+
Read this when:
|
|
6
|
+
- writing a portability bundle as one zip;
|
|
7
|
+
- choosing `fileContents.maxTotalBytes`;
|
|
8
|
+
- handling an archive that failed.
|
|
9
|
+
|
|
10
|
+
## Import Origins
|
|
11
|
+
|
|
12
|
+
- `@wildo-ai/saas-backend-lib`
|
|
13
|
+
|
|
14
|
+
## Source Excerpts
|
|
15
|
+
|
|
16
|
+
### Origin Package: `@wildo-ai/saas-backend-lib`
|
|
17
|
+
|
|
18
|
+
```typescript
|
|
19
|
+
*
|
|
20
|
+
* The archive a PORTABILITY export is delivered as, from `@wildo-ai/saas-backend-lib`:
|
|
21
|
+
* `writeSubjectExportArchive(bundle, output: Writable): Promise<{ bytesWritten }>` streams `export.json` (the report,
|
|
22
|
+
* the rows, the verification keys and a manifest of the files) and then each `bundle.fileContents` part at its `path`.
|
|
23
|
+
* It rejects, leaving `output` unfinished, when a file's bytes do not verify or the archive would pass 4 GiB: the caller
|
|
24
|
+
* owns `output` and must discard it then. `exportSubjectAsSystem(…, { fileContents: { maxTotalBytes } })` takes a
|
|
25
|
+
* bound between 1 byte and the ceiling below.
|
|
26
|
+
*/
|
|
27
|
+
/** The archive's JSON entry: the report, the rows, the verification keys and the file manifest. */
|
|
28
|
+
export const SUBJECT_EXPORT_ARCHIVE_JSON_PATH = 'export.json';
|
|
29
|
+
/** The default bound on a portability export's file bytes: 2 GiB. */
|
|
30
|
+
export const SUBJECT_EXPORT_FILE_CONTENT_DEFAULT_MAX_BYTES = 2 * 1024 ** 3;
|
|
31
|
+
/** The highest bound a caller may set: 3 GiB, below the 4 GiB a ZIP without ZIP64 can address, leaving room for the JSON. */
|
|
32
|
+
export const SUBJECT_EXPORT_FILE_CONTENT_MAX_BYTES_CEILING = 3 * 1024 ** 3;
|
|
33
|
+
```
|
|
@@ -52,7 +52,8 @@ App-level views are routed differently than resource-owned views:
|
|
|
52
52
|
- Registering a full custom view reachable from the app shell
|
|
53
53
|
- Wiring cross-module view refs
|
|
54
54
|
- Creating a module overview dashboard
|
|
55
|
-
- Setting the application's home (`homeDefinitionFactory`) — see `references/application-home.md
|
|
55
|
+
- Setting the application's home (`homeDefinitionFactory`) — see `references/application-home.md`; for a workflow
|
|
56
|
+
tool (records others decide), its blocks are `references/workflow-home.md`
|
|
56
57
|
|
|
57
58
|
## When NOT to Use
|
|
58
59
|
|
|
@@ -151,6 +152,7 @@ What is **not** in this block (and shouldn't be):
|
|
|
151
152
|
|
|
152
153
|
- `references/app-level-views-routing.md`
|
|
153
154
|
- `references/application-home.md` — make a view or a resource operation what a person sees at `/` (`homeDefinitionFactory`)
|
|
155
|
+
- `references/workflow-home.md` — **a workflow tool's home**: awaiting-my-decision, my-records and key-figure blocks, each a pinned LIST drawn only for the people it is for
|
|
154
156
|
- `references/framework-view-scope-and-full-custom-api.md` — source-backed `FrontendView_Definition` + `FullCustomViewDefinition`
|
|
155
157
|
|
|
156
158
|
## Verification
|