@wildo-ai/framework-knowledge 1.1.4 → 1.1.6
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 +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md +110 -0
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +46 -0
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/references/specification-family-map.md +88 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +547 -17
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts +19 -0
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.loader.js +47 -1
- package/dist/esm/framework-knowledge.loader.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/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- 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 +1 -4
- 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 +135 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +208 -0
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +218 -9
- 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 +374 -11
- 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 +6 -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 +22 -20
- 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 +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 +1 -6
- 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 +57 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +62 -0
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +132 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +188 -0
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +74 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +80 -0
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +5 -4
- 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 +18 -8
- 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 +67 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +81 -0
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +31 -11
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +132 -10
- 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 +68 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +84 -0
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +69 -0
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +2 -2
- 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 +1 -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 +78 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +93 -0
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +104 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +184 -0
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +115 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +152 -0
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts +188 -8
- 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 +167 -9
- 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 +172 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +147 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js +248 -0
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +158 -5
- 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 +173 -5
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +6 -5
- 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 +9 -8
- 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 +3 -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 +23 -4
- 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 +6 -4
- 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 +22 -13
- 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 +193 -28
- 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 +173 -34
- 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 +3 -2
- 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 +7 -3
- 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 +183 -6
- 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 +192 -6
- 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 +3 -2
- 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 +4 -3
- 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 +173 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +264 -0
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +44 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +51 -0
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts +2 -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 +3 -2
- 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 +2 -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 +7 -3
- 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 +2 -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 +3 -2
- 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 +2 -2
- 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 +7 -4
- 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 +33 -5
- 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 +28 -4
- 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 -3
- 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 +5 -3
- 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 +199 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +227 -0
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +6 -4
- 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 +19 -5
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +156 -5
- 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 +187 -5
- 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 +7 -6
- 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 +28 -19
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.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 -0
- package/dist/knowledge/manifest.json +9 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/method.md +75 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +40 -0
- package/dist/knowledge/playbooks/bottom_up.build/method.md +81 -0
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +89 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +1234 -80
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +53 -14
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +743 -64
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +34 -49
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +10 -21
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +93 -0
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +61 -0
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +98 -0
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +98 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +109 -0
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +77 -0
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +9 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +16 -16
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +181 -0
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +73 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +222 -145
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +60 -24
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +152 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +70 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/method.md +87 -0
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +67 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +236 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +62 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +117 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +86 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/method.md +71 -0
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +92 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/method.md +83 -0
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +65 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +964 -15
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +19 -12
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +191 -21
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +12 -18
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +349 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +54 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +24 -11
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +15 -18
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +9 -18
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +26 -52
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +14 -18
- package/dist/knowledge/playbooks/top_down.compliance-analysis/method.md +41 -0
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +99 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +211 -0
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +66 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/method.md +61 -0
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +40 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +37 -14
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +19 -69
- package/dist/knowledge/playbooks/top_down.compliance-research/method.md +78 -0
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +41 -0
- package/dist/knowledge/playbooks/top_down.definition/method.md +106 -0
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +120 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +46 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/method.md +51 -165
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +25 -45
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/method.md +56 -0
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +42 -0
- package/dist/knowledge/playbooks/top_down.market-research/method.md +68 -0
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +44 -0
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +245 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +70 -0
- 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/method.md +36 -69
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +12 -13
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +28 -8
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +12 -19
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +46 -0
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +25 -10
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +16 -20
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-protocol.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/evaluation-treatment.json +1 -0
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +24 -17
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +12 -18
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +12 -4
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -20
- package/dist/knowledge/references/acp.execution-profile.md +266 -0
- package/dist/knowledge/references/acp.host-configuration-inheritance.md +29 -0
- package/dist/knowledge/references/acp.permission-ceiling.md +105 -0
- package/dist/knowledge/references/acp.permission-escalation.md +37 -0
- package/dist/knowledge/references/application-documentation-chapters.config.md +152 -0
- package/dist/knowledge/references/application-documentation-plan.config.md +136 -0
- package/dist/knowledge/references/application-maturity.config.md +319 -0
- package/dist/knowledge/references/assertions.authored-metadata.config.md +1 -1
- package/dist/knowledge/references/assertions.specification.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/brand.asset.config.md +8 -16
- package/dist/knowledge/references/brand.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/brand.logo-direction.config.md +9 -7
- package/dist/knowledge/references/brand.snapshot.config.md +16 -2
- package/dist/knowledge/references/brand.snapshot.validation.md +0 -7
- package/dist/knowledge/references/build-plan.task-graph.config.md +649 -10
- package/dist/knowledge/references/business-model.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/business-model.pricing-plan.config.md +1 -1
- package/dist/knowledge/references/business-model.snapshot.validation.md +15 -0
- package/dist/knowledge/references/capability-composition.config.md +174 -0
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/cli.market.utils.md +1 -0
- package/dist/knowledge/references/companion.technical-doc.service.md +453 -98
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +28 -22
- package/dist/knowledge/references/engine.client-bundle.external-connectors-public.discipline.md +20 -1
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +8 -4
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/engine.saas-website.config.md +22 -10
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +13 -12
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +53 -7
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +11 -0
- package/dist/knowledge/references/example.config.design-system.full.md +3 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.engine.product-definitions.feature-and-profiles.md +19 -7
- package/dist/knowledge/references/example.features.connected-feature.declaration.md +66 -0
- package/dist/knowledge/references/example.features.connected-feature.surface.md +42 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +30 -6
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +7 -11
- package/dist/knowledge/references/example.guidance.bound-survey-flow.md +82 -0
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +104 -43
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.milestones.module-definitions.md +73 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +79 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +46 -16
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-app.module.md +112 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +34 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +25 -3
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +30 -0
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +16 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +5 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +112 -10
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +90 -0
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.spec.frontend-component.prop-vocabulary.md +18 -0
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/example.worker.node-route.md +94 -0
- package/dist/knowledge/references/experience-plan.config.md +318 -0
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +152 -9
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.backend.provider-package-convention.md +36 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +290 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +217 -0
- package/dist/knowledge/references/market.alternative.config.md +2 -2
- package/dist/knowledge/references/market.authored-metadata.config.md +12 -9
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +4 -4
- package/dist/knowledge/references/market.feature-benefit.config.md +2 -2
- package/dist/knowledge/references/market.gain.config.md +2 -2
- package/dist/knowledge/references/market.icp.config.md +3 -3
- package/dist/knowledge/references/market.job.config.md +2 -2
- package/dist/knowledge/references/market.message-template.config.md +3 -3
- package/dist/knowledge/references/market.objection.config.md +2 -2
- package/dist/knowledge/references/market.pain.config.md +2 -2
- package/dist/knowledge/references/market.persona.config.md +3 -3
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +2 -2
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.snapshot.validation.md +15 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +2 -2
- package/dist/knowledge/references/market.trigger.config.md +2 -2
- package/dist/knowledge/references/minions.tick-contract.md +83 -0
- package/dist/knowledge/references/placement-plan.config.md +375 -0
- package/dist/knowledge/references/platform.config.application-database.md +5 -2
- package/dist/knowledge/references/platform.config.backing-services.md +15 -36
- package/dist/knowledge/references/platform.config.environment.deployment.md +206 -14
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +170 -0
- package/dist/knowledge/references/platform.config.infrastructure-host.md +87 -0
- package/dist/knowledge/references/platform.config.saas.md +261 -9
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +19 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/presets.models.surface-policy.md +19 -10
- package/dist/knowledge/references/requirements.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/requirements.snapshot.validation.md +15 -0
- package/dist/knowledge/references/roadmap.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/roadmap.snapshot.validation.md +15 -7
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +71 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.app-config.backend-authored.md +1 -2
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.auth.federated-identity-provider-private-networks.md +62 -0
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +87 -0
- package/dist/knowledge/references/saas.backend.billing.catalog-sync-result.md +37 -0
- package/dist/knowledge/references/saas.backend.billing.resolution-failure-reasons.md +24 -5
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +194 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +118 -16
- package/dist/knowledge/references/saas.backend.error-builder.user-guidance.md +82 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +206 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +22 -4
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +19 -4
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +84 -0
- package/dist/knowledge/references/saas.backend.health-readiness-contributor.md +73 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +224 -0
- package/dist/knowledge/references/saas.backend.providers.operation-executor.md +51 -0
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +71 -0
- package/dist/knowledge/references/saas.backend.queue.worker-topology.md +39 -0
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +148 -41
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.composition.scenario-apply.md +51 -0
- package/dist/knowledge/references/saas.config.content-security-policy.md +97 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.data-seeding.bootstrap-wiring.md +91 -21
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +4 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.external-providers.backend-provider-loader.md +38 -0
- package/dist/knowledge/references/saas.external-providers.backend-provider-registry.runtime-filter.md +27 -27
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +65 -16
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +43 -13
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +44 -8
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +131 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +38 -0
- package/dist/knowledge/references/saas.frontend.celebration-overlay-contract.md +41 -0
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.composite-view.authoring.md +64 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +34 -0
- package/dist/knowledge/references/saas.frontend.errors.user-facing-error-message.md +47 -0
- package/dist/knowledge/references/saas.frontend.execution-view.action-status-contract.per-action-retry-loop.md +7 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +3 -3
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +7 -4
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.form-fields.file-provider-constraints.md +30 -48
- package/dist/knowledge/references/saas.frontend.full-custom-view.definition.md +24 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +47 -0
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.onboarding-view.md +84 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +80 -0
- package/dist/knowledge/references/saas.frontend.public-shell.identity-mode.md +65 -0
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +28 -4
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +136 -1
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +422 -11
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +259 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +220 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +26 -10
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +132 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +161 -0
- package/dist/knowledge/references/saas.models.auth.methods.md +513 -0
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +90 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +130 -0
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +266 -0
- package/dist/knowledge/references/saas.models.config.registration.md +188 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +98 -0
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +173 -3
- package/dist/knowledge/references/saas.models.email.template-type.md +40 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.md +97 -7
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +65 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +710 -10
- package/dist/knowledge/references/saas.models.features.definition-builders.md +162 -0
- package/dist/knowledge/references/saas.models.file-upload-grant.md +222 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +54 -5
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.governed-document-acceptance-mode.md +116 -0
- package/dist/knowledge/references/saas.models.guidance-flow.md +160 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +884 -135
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.milestone-celebration.md +69 -0
- package/dist/knowledge/references/saas.models.milestone-definition.md +209 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +13 -9
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +133 -0
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +103 -0
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +152 -0
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +84 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +146 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +283 -0
- package/dist/knowledge/references/saas.models.onboarding-elements.md +375 -0
- package/dist/knowledge/references/saas.models.onboarding-trigger.md +52 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +59 -0
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +129 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.client-instance-id-scope.md +49 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +106 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.progression-tracker-variant.md +76 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +42 -5
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +133 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +50 -0
- package/dist/knowledge/references/saas.models.providers.capability-surface.md +58 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +196 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +156 -0
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +11 -1
- package/dist/knowledge/references/saas.models.relationship-handling-settings.md +23 -1
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +244 -32
- package/dist/knowledge/references/saas.models.resource-config.forwarded-label.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +69 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +15 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-auditable-event.md +66 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +24 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-cron-job.md +59 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-idempotency-key.md +55 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +5 -4
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +158 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-step-up.md +77 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +42 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-for-key.md +6 -1
- package/dist/knowledge/references/saas.models.resource-config.queue-policy.md +49 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +84 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +16 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +22 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.resource-config.system-access-policy.md +111 -4
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +39 -0
- package/dist/knowledge/references/saas.models.resource-operation-display-risk.md +48 -0
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +38 -0
- package/dist/knowledge/references/saas.models.resource-primary-scope.md +11 -2
- package/dist/knowledge/references/saas.models.scope-membership.md +3 -4
- package/dist/knowledge/references/saas.models.shared-saas-module.md +25 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +870 -0
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +268 -3
- package/dist/knowledge/references/saas.rag.retrieval-result.md +19 -8
- package/dist/knowledge/references/saas.specifications.application-authored-document-fact-specification.contract.md +29 -0
- package/dist/knowledge/references/saas.specifications.application-document-fact-specification.contract.md +15 -36
- package/dist/knowledge/references/saas.specifications.application-document-publication.contract.md +9 -5
- package/dist/knowledge/references/saas.specifications.application-document-publication.generation.md +63 -0
- package/dist/knowledge/references/saas.specifications.application-document-release-set.contract.md +74 -0
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +123 -0
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +108 -7
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +880 -66
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +217 -18
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.composite-view-specification.md +10 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +376 -0
- package/dist/knowledge/references/saas.specifications.playbook-approval-and-failure-policies.md +96 -0
- package/dist/knowledge/references/saas.specifications.processor-register.md +410 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +120 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +35 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +92 -7
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +33 -13
- package/dist/knowledge/references/saas.website.astro.label-loader.md +10 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +29 -16
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +34 -1
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +218 -0
- package/dist/knowledge/references/saas.website.consent.context.md +162 -0
- package/dist/knowledge/references/saas.website.consent.gate.md +38 -0
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +70 -1
- package/dist/knowledge/references/saas.website.page.context.md +4 -3
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +66 -11
- package/dist/knowledge/references/saas.website.section.context.md +3 -2
- package/dist/knowledge/references/saas.website.sections.category-enum.md +19 -20
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/vision.authored-metadata.config.md +2 -2
- package/dist/knowledge/references/website-plan.config.md +238 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +57 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +43 -2
- package/dist/knowledge/references/zod.decorators.data-categories.md +197 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +53 -5
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +75 -1
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +36 -2
- package/dist/knowledge/references/zod.decorators.field-spec-params.md +32 -5
- package/dist/knowledge/references/zod.decorators.file-nature-constraints.md +86 -0
- package/dist/knowledge/references/zod.decorators.file-readiness-metadata.md +67 -0
- package/dist/knowledge/references/zod.decorators.file-schema.md +95 -18
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +87 -0
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +148 -6
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +3 -0
- package/dist/knowledge/references/zod.decorators.rag-source.md +6 -2
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +24 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +35 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +50 -12
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +35 -12
- package/dist/knowledge/references/zod.factories.address.md +118 -0
- package/dist/knowledge/references/zod.factories.code.md +4 -2
- package/dist/knowledge/references/zod.factories.duration.md +6 -4
- package/dist/knowledge/references/zod.factories.money.md +5 -3
- package/dist/knowledge/references/zod.factories.phone.md +14 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -2
- package/dist/knowledge/registries/framework-topics.json +2602 -214
- package/dist/knowledge/registries/playbooks.json +468 -92
- package/dist/knowledge/registries/source-tags.json +6171 -1996
- package/dist/knowledge/rules/database-migration-obligation.md +110 -0
- package/dist/knowledge/rules/live-context-door.md +137 -0
- package/dist/knowledge/rules/resource-schema-awareness.md +75 -0
- package/dist/knowledge/skills/INDEX.md +67 -29
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +111 -37
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/framework-documentation-chapters-api.md +167 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/references/source-and-ownership-routing.md +6 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +11 -3
- package/dist/knowledge/skills/application-database-migrations/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/application-database-migrations/references/migration-refusals.md +32 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +95 -3
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +59 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +32 -19
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +119 -17
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-readiness-contributor-api.md +135 -0
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +96 -20
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +137 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-error-user-guidance-api.md +112 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +72 -1
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +214 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +39 -1
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-asset-api.md +8 -16
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +25 -9
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +162 -8
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +80 -17
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +518 -132
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +32 -10
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-fact-specification-contract.md +103 -58
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-application-document-publication-contract.md +19 -13
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +162 -26
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +734 -23
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +436 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +221 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +95 -11
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +87 -21
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +70 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-public-shell-identity-api.md +124 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +44 -3
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +19 -10
- package/dist/knowledge/skills/config-design-system/references/loading-placeholder-authoring.md +47 -0
- package/dist/knowledge/skills/config-design-system/references/surface-policy-authoring.md +19 -10
- package/dist/knowledge/skills/config-navigation/SKILL.md +200 -19
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +98 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +13 -9
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +78 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +245 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +174 -0
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +253 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +141 -0
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +88 -9
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +206 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +189 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +493 -0
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +157 -0
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +292 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +161 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +139 -12
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +1024 -0
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +172 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +261 -9
- package/dist/knowledge/skills/config-saas/references/saas-config-scope.md +9 -0
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +66 -3
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +151 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-auth-methods-api.md +579 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-backend-authored-config-api.md +8 -2
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +96 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +397 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-registration-config-api.md +221 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +143 -0
- package/dist/knowledge/skills/config-saas-backend/references/managed-startup-configuration.md +46 -0
- package/dist/knowledge/skills/configure-billing/SKILL.md +91 -46
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +62 -17
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +55 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +39 -17
- package/dist/knowledge/skills/configure-billing/references/framework-backend-provider-reachability-api.md +30 -28
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +192 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-resolution-failure-api.md +44 -11
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +259 -0
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +91 -0
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +289 -0
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +192 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +504 -0
- package/dist/knowledge/skills/email-add-template/SKILL.md +100 -91
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +15 -7
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +123 -0
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +20 -12
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +60 -31
- package/dist/knowledge/skills/engine-product-definitions/references/connected-feature-workflow.md +130 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-engine-product-definitions-api.md +25 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-feature-builders-api.md +215 -0
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +78 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +60 -27
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +4 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +41 -12
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +31 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +248 -9
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +127 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +236 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +8 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +54 -5
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +75 -21
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +259 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +480 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +3988 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +212 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-guidance-flow-api.md +165 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-elements-api.md +381 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-trigger-api.md +57 -0
- package/dist/knowledge/skills/guidance-onboarding-authoring/references/framework-onboarding-view-api.md +89 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +14 -1
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +11 -2
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +19 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +387 -81
- package/dist/knowledge/skills/infra-environment-config/references/framework-application-database-api.md +5 -2
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +198 -36
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +206 -14
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +95 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +184 -46
- package/dist/knowledge/skills/local-environment-bootstrap/references/framework-upgrade-and-dependency-alignment.md +119 -0
- package/dist/knowledge/skills/local-environment-bootstrap/references/initialization-recovery-recipe.md +7 -4
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +289 -37
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +3 -2
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +2 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +4 -3
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-snapshot-api.md +12 -9
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +5 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +233 -18
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +232 -18
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +77 -15
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +50 -12
- package/dist/knowledge/skills/market-icp/SKILL.md +4 -3
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +7 -6
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +18 -3
- package/dist/knowledge/skills/market-persona/SKILL.md +4 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +5 -4
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +16 -0
- package/dist/knowledge/skills/market-snapshot-validation/references/framework-snapshot-validation-api.md +15 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +3 -2
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +4 -3
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +199 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-celebration-overlay-contract.md +51 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-celebration-api.md +79 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-milestone-definition-api.md +220 -0
- package/dist/knowledge/skills/milestones-and-celebrations/references/framework-progression-tracker-api.md +86 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +144 -0
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +84 -0
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +91 -0
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +55 -19
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +217 -18
- package/dist/knowledge/skills/module-registration/SKILL.md +50 -32
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +143 -16
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +227 -0
- package/dist/knowledge/skills/module-registration/references/registry-files.md +14 -5
- package/dist/knowledge/skills/module-relationships/SKILL.md +65 -2
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +26 -5
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +518 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +80 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-loader-api.md +55 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-convention-api.md +48 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +165 -29
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-file-provider-constraints-api.md +99 -47
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +270 -9
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +247 -0
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +50 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +141 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +86 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +73 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +300 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +70 -11
- package/dist/knowledge/skills/rate-limit-authoring/references/fixed-window-and-environment-multiplier.md +27 -0
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +19 -6
- package/dist/knowledge/skills/resource-add-field/SKILL.md +13 -5
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +472 -23
- package/dist/knowledge/skills/resource-add-module/SKILL.md +117 -265
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +134 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-new-module-wiring-api.md +25 -0
- package/dist/knowledge/skills/resource-add-module/references/module-scaffold-layout.md +12 -12
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +244 -32
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +145 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +101 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +133 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-idempotency-key-api.md +141 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md +126 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +953 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +122 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +125 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +97 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +595 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +197 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +259 -45
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +486 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +422 -11
- package/dist/knowledge/skills/resource-custom-view/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1242 -31
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +739 -17
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +987 -140
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +175 -10
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +70 -26
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-file-upload-grant-contract.md +246 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +7 -6
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +5 -3
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +44 -48
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +108 -14
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-retrieval-api.md +47 -15
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-rag-source-decorator-api.md +6 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +34 -4
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/basic-resource-schema.example.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/decorator-layer-map.md +17 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +77 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +210 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +245 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +35 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +50 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +497 -28
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +67 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +78 -14
- package/dist/knowledge/skills/resource-schema-authoring/references/polymorphic-per-scope-resources.md +28 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/schema-variants-and-discriminators.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +1 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/special-factories.md +34 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +300 -23
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +75 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +36 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +447 -12
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +148 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +3 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +216 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +266 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +10 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +4 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +34 -29
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +13 -5
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-cron-scheduler.md +67 -74
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +97 -24
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +206 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +266 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +229 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +52 -19
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +217 -18
- package/dist/knowledge/skills/spec-component-update/SKILL.md +31 -11
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-composite-view-update/references/framework-composite-view-specification-api.md +10 -0
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +48 -9
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +16 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-field-spec-params-api.md +32 -5
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +188 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +14 -2
- package/dist/knowledge/skills/views-add-custom-view/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +3 -1
- package/dist/knowledge/skills/views-app-level/references/framework-view-scope-and-full-custom-api.md +24 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +44 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-composite-authoring/references/framework-composite-view-contracts-api.md +64 -0
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +4 -0
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +3 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-user-facing-error-message-api.md +50 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +72 -13
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +34 -1
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +44 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +48 -23
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +882 -211
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +117 -13
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +71 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +22 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +21 -6
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +206 -35
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +126 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +159 -180
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-cta/SKILL.md +51 -42
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-faq/SKILL.md +118 -83
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +46 -38
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +52 -42
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +50 -40
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-hero/SKILL.md +101 -69
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +236 -220
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +64 -54
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +38 -31
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +44 -26
- package/dist/knowledge/skills/worker-authoring/SKILL.md +165 -0
- package/dist/knowledge/skills/worker-authoring/examples/worker-route.example.md +98 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +65 -0
- package/dist/knowledge/topic-index.json +12659 -4142
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.provider.contribution.backend-billing.md +0 -12
- package/dist/knowledge/skills/configure-billing/references/example-provider-contribution-and-backend-config.md +0 -48
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -42
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -43
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -55
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -50
- /package/dist/knowledge/playbooks/{top_down.market-analysis → top_down.market-snapshot-produce}/structured-artifact-action.json +0 -0
|
@@ -176,10 +176,180 @@ export enum DataMode {
|
|
|
176
176
|
*
|
|
177
177
|
* If not specified at resource level, uses `appConfig.database.defaultAdapter`.
|
|
178
178
|
*/
|
|
179
|
+
/**
|
|
180
|
+
* What an INTROSPECTION-backed resource projects.
|
|
181
|
+
*
|
|
182
|
+
* Declared BY THE AUTHOR beside the resource, exactly as `httpApiBinding` is, and for the same
|
|
183
|
+
* reason: the adapter answers "how rows are reached", and everything specific to THIS resource's
|
|
184
|
+
* reach is a typed declaration rather than runtime inference.
|
|
185
|
+
*
|
|
186
|
+
* Keeping it here rather than in a companion-side lookup table matters. A table keyed by resource
|
|
187
|
+
* type would be a second enumeration of a population the resource configs already define — the
|
|
188
|
+
* shape that silently drifts when one side gains an entry.
|
|
189
|
+
*/
|
|
190
|
+
export enum IntrospectionTenancyStance {
|
|
191
|
+
/**
|
|
192
|
+
* The rows describe the APPLICATION'S OWN STRUCTURE — its modules, resource specifications,
|
|
193
|
+
* design system, compliance declarations — and carry no tenant dimension, so there is nothing for
|
|
194
|
+
* a contextual scope predicate to filter on.
|
|
195
|
+
*
|
|
196
|
+
* This is the only stance implemented, and it is DECLARED rather than inferred, because an
|
|
197
|
+
* unstated stance is indistinguishable from an overlooked one. Every other repository enforces
|
|
198
|
+
* scoping ITSELF — Mongo and PostgreSQL through `buildContextualFilter`, HTTP_API by STAMPING
|
|
199
|
+
* each projected row with the owner organization of the system of record it came from (#1055), so
|
|
200
|
+
* the ordinary per-row tenant gate decides it. A read-through adapter that simply returned
|
|
201
|
+
* whatever its source produced would be the one backing kind with no scoping story, and nobody
|
|
202
|
+
* would be asked to notice.
|
|
203
|
+
*
|
|
204
|
+
* (This paragraph cited `HttpApiTenancyStance` as the precedent until #1055 removed it. The
|
|
205
|
+
* argument it made — declare the stance, do not infer it — is why this enum still exists; what
|
|
206
|
+
* changed is that HTTP_API stopped needing a stance of its own, because the answer became the
|
|
207
|
+
* same for every system of record.)
|
|
208
|
+
*/
|
|
209
|
+
APPLICATION_STRUCTURE = 'application-structure',
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* The rows are the DEVELOPMENT COMPANION'S OWN RUNTIME PROJECTIONS for the one application it
|
|
213
|
+
* serves — the playbook eligibility board, the build plan, the run write-register, the execution
|
|
214
|
+
* traces. Like `APPLICATION_STRUCTURE` they carry no tenant dimension and no scope predicate can
|
|
215
|
+
* apply; UNLIKE it, they are not derived from the application's source, and the tenancy stance is
|
|
216
|
+
* where that difference must stay visible (added 2026-09-01, creation-board resources plan):
|
|
217
|
+
*
|
|
218
|
+
* - `APPLICATION_STRUCTURE`'s public-read posture (`APP_PUBLIC` variants on the workbench's
|
|
219
|
+
* structural projections) rests on the rows being the application's OWN source, which anyone
|
|
220
|
+
* with the working tree can already read. That argument does NOT extend to runtime state, so a
|
|
221
|
+
* resource declaring this stance is expected to gate its variants on an authenticated role —
|
|
222
|
+
* never `APP_PUBLIC`.
|
|
223
|
+
* - Row-level tenant-anchor checks are bypassed for this stance exactly as for
|
|
224
|
+
* `APPLICATION_STRUCTURE` (the rows carry no anchor BY CONTRACT); authorization comes from the
|
|
225
|
+
* session and the operation's role gate.
|
|
226
|
+
*
|
|
227
|
+
* Fusing this into `APPLICATION_STRUCTURE` was rejected for the enum's own founding reason: an
|
|
228
|
+
* unstated distinction is indistinguishable from an overlooked one, and the next decision site
|
|
229
|
+
* keyed off the stance would inherit a claim nobody checked.
|
|
230
|
+
*/
|
|
231
|
+
APPLICATION_RUNTIME = 'application-runtime',
|
|
232
|
+
|
|
233
|
+
/**
|
|
234
|
+
* The rows carry a tenant dimension and a scope predicate must be pushed into the source.
|
|
235
|
+
*
|
|
236
|
+
* REFUSED AT REGISTRATION today: no introspection behavior takes a scope argument, so the engine
|
|
237
|
+
* has nothing to push down. Declared as a member rather than omitted so the refusal is explicit
|
|
238
|
+
* and a future scoped behavior is a deliberate design step — the alternative is that the first
|
|
239
|
+
* author needing it discovers the gap by shipping unscoped rows.
|
|
240
|
+
*/
|
|
241
|
+
SCOPE_FILTER_PUSHDOWN = 'scope-filter-pushdown',
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
export interface IntrospectionResourceBinding {
|
|
245
|
+
/**
|
|
246
|
+
* The companion introspection behavior whose output becomes this resource's rows.
|
|
247
|
+
*
|
|
248
|
+
* A plain string on purpose: the behavior catalog lives in the companion (23 behaviors as of
|
|
249
|
+
* 2026-08-29) and the engine must not depend on it. An unknown id is refused by the companion at
|
|
250
|
+
* read time, naming the id and the supported set.
|
|
251
|
+
*/
|
|
252
|
+
readonly behavior: string;
|
|
253
|
+
|
|
254
|
+
/**
|
|
255
|
+
* Path into the behavior's result that holds the rows, dot-separated. Omitted means the result
|
|
256
|
+
* itself is the row collection.
|
|
257
|
+
*
|
|
258
|
+
* Behaviors answer their own natural shape — `{ frontendChartRegistrationRefs: [...] }` — and
|
|
259
|
+
* teaching each one to answer a uniform envelope would change 23 working behaviors to suit a
|
|
260
|
+
* consumer that arrived later.
|
|
261
|
+
*/
|
|
262
|
+
readonly rowsPath?: string;
|
|
263
|
+
|
|
264
|
+
/**
|
|
265
|
+
* REQUIRED. Why these rows need no contextual scope predicate, or that they do.
|
|
266
|
+
*
|
|
267
|
+
* Not optional and not defaulted: a default would make "nobody thought about tenancy" and
|
|
268
|
+
* "tenancy does not apply here" the same declaration.
|
|
269
|
+
*/
|
|
270
|
+
readonly tenancy: IntrospectionTenancyStance;
|
|
271
|
+
|
|
272
|
+
/**
|
|
273
|
+
* Fields whose values COMPOSE each row's primary key, in order, when the behavior's rows carry no
|
|
274
|
+
* identifier of their own.
|
|
275
|
+
*
|
|
276
|
+
* Most introspection behaviors answer structural projections rather than records: a module row
|
|
277
|
+
* carries `moduleId` and needs nothing here, while a relationship row carries only the two
|
|
278
|
+
* resource types it joins. Without a key such a resource can be LISTed and never READ, because
|
|
279
|
+
* there is no value to address a row by.
|
|
280
|
+
*
|
|
281
|
+
* Composition is DECLARED rather than derived because only the author knows which fields are
|
|
282
|
+
* jointly unique for a given behavior — and being wrong is not hypothetical. `resourceType1` +
|
|
283
|
+
* `resourceType2` is unique across all 16 relationships in the dogfood application and is still
|
|
284
|
+
* unsafe in general, since the framework permits several edges between the same pair (a junction
|
|
285
|
+
* with two roles, a self-relationship). So the source FAILS LOUDLY when two rows compose the same
|
|
286
|
+
* key rather than serving both under one id, which would make READ return an arbitrary one of
|
|
287
|
+
* them and give no sign anything was wrong.
|
|
288
|
+
*
|
|
289
|
+
* The composed value is written to the resource's own `resourceFieldIdentifier`, which is the one
|
|
290
|
+
* key name resolvable from the registry without introspecting the schema's decorators. A resource
|
|
291
|
+
* declaring `identityFields` must therefore name that field as its primary key.
|
|
292
|
+
*
|
|
293
|
+
* The values are joined verbatim, so the key stays READABLE — `workspace__users__createdByUserId`
|
|
294
|
+
* rather than an opaque hash. That is possible because an INTROSPECTION-backed resource resolves
|
|
295
|
+
* to `ResourceIdFormat.INTROSPECTION_SYNTHESIZED`, which admits a readable charset (URL-unreserved characters
|
|
296
|
+
* plus the element-ref separators `:` `/` `[` `]`) instead of the ObjectId-or-UUID rule platform rows follow.
|
|
297
|
+
*
|
|
298
|
+
* It was briefly a deterministic UUIDv5, before that format existed. Hashing worked and was the
|
|
299
|
+
* wrong trade: it made every id opaque, and it disguised the real property — a DERIVED id is only
|
|
300
|
+
* as stable as the fields it is derived from, and hiding that behind a hash removes the reader's
|
|
301
|
+
* ability to notice when a row's identity moves.
|
|
302
|
+
*
|
|
303
|
+
* The whole key must satisfy that format (`Resources_SharedUtils.isIntrospectionSynthesizedId`) and be at most
|
|
304
|
+
* 255 characters; the source refuses per row rather than emitting a key that lists and cannot be read.
|
|
305
|
+
*
|
|
306
|
+
* Omit when the behavior's rows already carry an identifier of their own.
|
|
307
|
+
*/
|
|
308
|
+
readonly identityFields?: readonly string[];
|
|
309
|
+
}
|
|
310
|
+
|
|
179
311
|
export enum PersistenceAdapter {
|
|
180
312
|
MONGODB = 'mongodb',
|
|
181
313
|
POSTGRESQL = 'postgresql',
|
|
182
314
|
|
|
315
|
+
/**
|
|
316
|
+
* Rows are DERIVED on demand by asking the running dev companion to introspect the application —
|
|
317
|
+
* its resource registry, specifications, design system, compliance facts, assertions, market and
|
|
318
|
+
* persona context. Nothing is stored: every read recomputes.
|
|
319
|
+
*
|
|
320
|
+
* ## Why this is an adapter and not a service call
|
|
321
|
+
*
|
|
322
|
+
* The companion already computes all of it — 23 named introspection behaviors — and today each is
|
|
323
|
+
* reachable only through a bespoke route. Making it an adapter is what turns those behaviors into
|
|
324
|
+
* ordinary RESOURCES: list, read, filter, search, labels, navigation, all generated, with no
|
|
325
|
+
* per-behavior UI. That is the same argument `HTTP_API` settled on 2026-08-26 — the adapter answers
|
|
326
|
+
* "how rows are reached", and the mechanism behind it is a binding an author declares.
|
|
327
|
+
*
|
|
328
|
+
* Distinct from `HTTP_API`, deliberately, and not merely because the transport differs. Retrieval
|
|
329
|
+
* is the COMPANION's decision per behavior (amended 2026-09-01): the app-import behaviors run a
|
|
330
|
+
* SUBPROCESS that imports the target application's built modules — seconds per read, requiring
|
|
331
|
+
* that application's `dist`, failing as a thrown behavior — while the creation-plane behaviors
|
|
332
|
+
* are IN-PROCESS projections of the companion's own runtime services (playbook eligibility,
|
|
333
|
+
* build plan, write register, traces). Both reach the engine through the same
|
|
334
|
+
* `IntrospectionResourceSourceBackendPort`; the adapter never encodes the mechanism, which is
|
|
335
|
+
* exactly why a behavior id is an engine-opaque string. Collapsing this into `HTTP_API` would
|
|
336
|
+
* still be wrong for the original reason: its failure mode is a source throwing rather than a
|
|
337
|
+
* row being absent, and nothing here is reached over a network API.
|
|
338
|
+
*
|
|
339
|
+
* ## What every adapter decision site must honor
|
|
340
|
+
*
|
|
341
|
+
* - **READ-ONLY, absolutely.** There is no writable target: a row is a projection of the
|
|
342
|
+
* application's own source. Every write method refuses, as `HTTP_API`'s twelve do.
|
|
343
|
+
* - **No provisioning, migration or schema surface.** Nothing is stored, so there is nothing to
|
|
344
|
+
* create, migrate or verify — the platform must never believe it owns a store here.
|
|
345
|
+
* - **Never a legal application-wide DEFAULT adapter.** It is a per-resource declaration only;
|
|
346
|
+
* an application whose default was introspection could persist nothing at all.
|
|
347
|
+
* - **It must DEGRADE, never fail closed at boot.** The companion is the only thing that can run
|
|
348
|
+
* an introspection behavior, so a boot path that refuses on an introspection failure would need
|
|
349
|
+
* the companion to fix the companion — see `continuity-drift-and-cas-basis.md` Rule 3.
|
|
350
|
+
*/
|
|
351
|
+
INTROSPECTION = 'introspection',
|
|
352
|
+
|
|
183
353
|
/**
|
|
184
354
|
* Rows live in a system reached over an authenticated HTTP API and are queried on demand
|
|
185
355
|
* (read-through). Decided 2026-08-26 (ETL workstream, D1): this IS a persistence-adapter answer
|
|
@@ -264,9 +434,9 @@ export const DEFAULT_PERSISTENCE_ADAPTER: PersistenceAdapter =
|
|
|
264
434
|
*
|
|
265
435
|
* The refusal is right as a DEFAULT and wrong as an absolute — some resources provably never
|
|
266
436
|
* participate in such a boundary, and for those the blanket refusal forbids a legitimate,
|
|
267
|
-
* safe deployment (a retrieval corpus
|
|
268
|
-
* no way past it.
|
|
269
|
-
*
|
|
437
|
+
* safe deployment (a retrieval corpus kept on PostgreSQL in an application whose MongoDB runs no `mongot`, say) with
|
|
438
|
+
* no way past it. A construct that refuses must ship the door in the same change, or a correct
|
|
439
|
+
* refusal becomes a permanent lockout: this enum IS that door. Declaring a member is a positive claim
|
|
270
440
|
* about the resource's write topology, made by its author, recorded in the config, and logged
|
|
271
441
|
* at registration — never an ambient tolerance and never a flag that merely silences an error.
|
|
272
442
|
*
|
|
@@ -465,6 +635,101 @@ export enum ResourceSystemAccessMode {
|
|
|
465
635
|
* framework infrastructure does NOT imply that an ACL bypass is acceptable
|
|
466
636
|
* for its data. Keep the two concepts separate.
|
|
467
637
|
*/
|
|
638
|
+
/**
|
|
639
|
+
* Declares that THIS resource is the application's subject-erasure request lane, and how to read it.
|
|
640
|
+
*
|
|
641
|
+
* ## Why the application declares it rather than the framework knowing it
|
|
642
|
+
*
|
|
643
|
+
* The erasure lane is application-owned — four of the five marked sites for
|
|
644
|
+
* `WILDO.PRIVACY.SUBJECT_ERASURE` are in an application, not the engine — and its evidence demand
|
|
645
|
+
* (`evidence-requirement:subject-erasure-execution-record`) says so in terms: *"the row's schema and
|
|
646
|
+
* status vocabulary are the application's, so a collector queries it against that application's
|
|
647
|
+
* specification"*, and its verification step adds *"do NOT assert a specific channel vocabulary:
|
|
648
|
+
* that is one application's modelling choice"*.
|
|
649
|
+
*
|
|
650
|
+
* So a collector may not know that a request is raised through a field called `channel` carrying a
|
|
651
|
+
* value called `SUBJECT`. It has to be TOLD, by the application, in a form it can read. Before this
|
|
652
|
+
* existed, three clauses of that demand had a durable row holding every fact they wanted and no way
|
|
653
|
+
* to find it (#1209): not a missing control, a control nobody could point at.
|
|
654
|
+
*
|
|
655
|
+
* ## It binds FIELDS, never values the framework invents
|
|
656
|
+
*
|
|
657
|
+
* Every member below names something the application already authored. The one value the
|
|
658
|
+
* declaration carries — {@link ResourceSubjectErasureLane.raisedBy}`.subjectValue` — is the
|
|
659
|
+
* application's OWN enum member, quoted back so a reader can tell the two populations apart. The
|
|
660
|
+
* framework supplies no vocabulary here and must never grow one.
|
|
661
|
+
*
|
|
662
|
+
* ## What is deliberately NOT declared
|
|
663
|
+
*
|
|
664
|
+
* The SCHEDULE. C3 asks that requests be executed on the declared schedule, and that schedule is
|
|
665
|
+
* already on the executing operation's `CRON_JOB` variant (`cronExpression`) — declaring it again
|
|
666
|
+
* here would be a second copy that can only ever disagree with the one the scheduler reads.
|
|
667
|
+
* `executionOperationIdentifier` names the operation; the schedule is read from it.
|
|
668
|
+
*/
|
|
669
|
+
export type ResourceSubjectErasureLane = {
|
|
670
|
+
/**
|
|
671
|
+
* How a row says WHO raised the request — the subject exercising their own right, or the
|
|
672
|
+
* controller acting on their behalf. C1's whole obligation is that the two are distinguishable.
|
|
673
|
+
*/
|
|
674
|
+
raisedBy: {
|
|
675
|
+
/** The field carrying it. Must be a persisted field of this resource. */
|
|
676
|
+
fieldName: string,
|
|
677
|
+
/**
|
|
678
|
+
* The value of that field meaning the SUBJECT raised it themselves. Every other value is read as
|
|
679
|
+
* controller-raised — stated this way round because a lane may grow a second controller channel
|
|
680
|
+
* without the declaration going stale, whereas enumerating the controller values could not.
|
|
681
|
+
*/
|
|
682
|
+
subjectValue: string,
|
|
683
|
+
},
|
|
684
|
+
/**
|
|
685
|
+
* The field carrying WHICH user raised a controller-raised request.
|
|
686
|
+
*
|
|
687
|
+
* Omitting it is a positive claim, not a gap: it says this lane admits no controller-raised
|
|
688
|
+
* request at all. A collector reads it that way and a row carrying a non-subject value then
|
|
689
|
+
* contradicts the declaration, which is a finding about the application rather than about the
|
|
690
|
+
* evidence.
|
|
691
|
+
*/
|
|
692
|
+
requesterFieldName?: string,
|
|
693
|
+
/** The field carrying the justification a controller-raised request was made on, where the lane records one. */
|
|
694
|
+
justificationFieldName?: string,
|
|
695
|
+
/** The field carrying the instant the request was executed or failed. C3 judges execution against it. */
|
|
696
|
+
completedAtFieldName: string,
|
|
697
|
+
/** The field carrying what the execution did. Its vocabulary is the application's. */
|
|
698
|
+
outcomeFieldName: string,
|
|
699
|
+
/**
|
|
700
|
+
* The operation a SUBJECT uses to withdraw their own pending request (C2). Named rather than
|
|
701
|
+
* inferred: "the operation that cancels" is not derivable from an operation vocabulary, and
|
|
702
|
+
* guessing it would make the evidence depend on a naming convention no application agreed to.
|
|
703
|
+
*/
|
|
704
|
+
withdrawalOperationIdentifier: string,
|
|
705
|
+
/**
|
|
706
|
+
* How a WITHDRAWN row is recognisable afterwards — the same shape as {@link raisedBy}, and for the
|
|
707
|
+
* same reason: the vocabulary is the application's.
|
|
708
|
+
*
|
|
709
|
+
* C2 asks for the withdrawal door AND for "any cancelled rows", and those are two different
|
|
710
|
+
* questions. The door is answered from {@link withdrawalOperationIdentifier} — is the operation
|
|
711
|
+
* reachable to a subject while the request is pending — and needs no data at all. The rows need a
|
|
712
|
+
* marker, and there is nothing to derive one from: withdrawal and execution both leave a request in
|
|
713
|
+
* a terminal state, so a reader that knows only `completedAtFieldName` cannot tell "the subject
|
|
714
|
+
* changed their mind" from "the sweep ran".
|
|
715
|
+
*
|
|
716
|
+
* OPTIONAL, because an application may not model withdrawal as a value at all — it may delete the
|
|
717
|
+
* row, or move it. Omitting it says the count is unavailable, and a collector reports that rather
|
|
718
|
+
* than guessing; it never turns into a zero, which would read as "nobody withdrew anything".
|
|
719
|
+
*
|
|
720
|
+
* Note an EMPTY withdrawal set is explicitly not a deficiency in the demand — people do not have
|
|
721
|
+
* to change their minds — so this exists to make the number REPORTABLE, never to make it a target.
|
|
722
|
+
*/
|
|
723
|
+
withdrawnMarker?: {
|
|
724
|
+
/** The field carrying it. Must be a persisted field of this resource. */
|
|
725
|
+
fieldName: string,
|
|
726
|
+
/** The value of that field meaning the SUBJECT withdrew the request before it executed. */
|
|
727
|
+
withdrawnValue: string,
|
|
728
|
+
},
|
|
729
|
+
/** The scheduled operation that executes due requests. Its `cronExpression` IS the declared schedule. */
|
|
730
|
+
executionOperationIdentifier: string,
|
|
731
|
+
};
|
|
732
|
+
|
|
468
733
|
export type ResourceSystemAccessPolicy = {
|
|
469
734
|
/** Governs `readAsSystem`. Omitted ⇒ FORBIDDEN. */
|
|
470
735
|
read?: ResourceSystemAccessMode,
|
|
@@ -488,10 +753,22 @@ export type ResourceSystemAccessPolicy = {
|
|
|
488
753
|
* Auto-derived to `ALLOWED` by the factory when a resource opts into
|
|
489
754
|
* `retentionPolicy`; never authored by hand in the common case.
|
|
490
755
|
*
|
|
491
|
-
* **LIVE.** `readRetainedAsSystem` / `listRetainedAsSystem` exist and are enforced:
|
|
492
|
-
* asserted fail-closed, a privileged human role is required, and every reveal emits a
|
|
493
|
-
* human-attributed `RETAINED_DATA_ACCESS` audit event.
|
|
494
|
-
*
|
|
756
|
+
* **LIVE, and REACHABLE.** `readRetainedAsSystem` / `listRetainedAsSystem` exist and are enforced:
|
|
757
|
+
* the verb is asserted fail-closed, a privileged human role is required, and every reveal emits a
|
|
758
|
+
* human-attributed `RETAINED_DATA_ACCESS` audit event.
|
|
759
|
+
*
|
|
760
|
+
* "Reachable" is the half that was missing until #490, and the distinction is worth keeping. The
|
|
761
|
+
* primitives were correct and enforced from the day M5b landed — and had **no caller**, so the only
|
|
762
|
+
* route an operator actually had to a retained record was a database console: the unaudited path
|
|
763
|
+
* they were built to replace. `users | read_retained` is the operator surface that closes it, an
|
|
764
|
+
* authenticated `APP_ADMIN_SUPER_ADMIN` operation carrying a mandatory justification.
|
|
765
|
+
*
|
|
766
|
+
* A resource that derives this grant and exposes no such operation is reachable by nothing. That
|
|
767
|
+
* is a defensible state — not every retention resource needs an operator door — but it should be a
|
|
768
|
+
* decision rather than an oversight, and `retained-see-through-operator-surface.test.ts` is what
|
|
769
|
+
* makes it one.
|
|
770
|
+
*
|
|
771
|
+
* (This block previously said the primitives were "wired in a later phase" — false since M5b.)
|
|
495
772
|
*/
|
|
496
773
|
seeRetained?: ResourceSystemAccessMode,
|
|
497
774
|
|
|
@@ -518,6 +795,42 @@ export type ResourceSystemAccessPolicy = {
|
|
|
518
795
|
};
|
|
519
796
|
|
|
520
797
|
/**
|
|
798
|
+
* WHO a row of this resource is with respect to an erasure, and where that person's session lives.
|
|
799
|
+
* The companion of {@link ResourceRetentionPolicy}: retention says what happens to the ROW and whether
|
|
800
|
+
* the row holds personal data at all; this says **whose SESSION an erasure of it must end**.
|
|
801
|
+
*
|
|
802
|
+
* The two are independent, and reading this one as "is the row about a person" is the mistake that
|
|
803
|
+
* cost `NO_PRINCIPAL` its previous name — see {@link ResourceDataSubjectKind}. A CRM contact holds
|
|
804
|
+
* personal data (`RETAIN_AND_IMPERSONALIZE`) and has no session (`NO_PRINCIPAL`); an invoice holds
|
|
805
|
+
* none (`RETAIN_ONLY`) and also has no session. Same value here, opposite compliance meaning, and the
|
|
806
|
+
* retention mode is what tells them apart.
|
|
807
|
+
*
|
|
808
|
+
* Required on every resource declaring a {@link ResourceRetentionPolicy}, because those are exactly
|
|
809
|
+
* the resources that can be passed to `eraseSubjectAsSystem` as a subject (the orchestrator refuses a
|
|
810
|
+
* subject with no retention policy). Undeclared fails at config build rather than defaulting: the safe
|
|
811
|
+
* default is unknowable — guessing `NO_PRINCIPAL` silently drops a real person's revocation, and
|
|
812
|
+
* guessing a linked principal revokes the wrong people. See {@link ResourceDataSubjectKind} for why
|
|
813
|
+
* the linkage can never be inferred from the presence of a user foreign key.
|
|
814
|
+
*/
|
|
815
|
+
export interface ResourceDataSubjectPolicy {
|
|
816
|
+
/** Whose login session an erasure of this row must end — never whether the row is about a person. */
|
|
817
|
+
kind: ResourceDataSubjectKind;
|
|
818
|
+
/**
|
|
819
|
+
* The field naming the `USERS` row whose session an erasure of this row must end.
|
|
820
|
+
*
|
|
821
|
+
* REQUIRED when {@link kind} is `LINKED_PRINCIPAL`, and FORBIDDEN otherwise — under
|
|
822
|
+
* `SELF_PRINCIPAL` the row's own id is the principal, and under `NO_PRINCIPAL` there is no
|
|
823
|
+
* principal at all, so a field there would be a contradiction rather than redundancy. Both
|
|
824
|
+
* directions are enforced at config build.
|
|
825
|
+
*/
|
|
826
|
+
sessionPrincipalField?: string;
|
|
827
|
+
}
|
|
828
|
+
|
|
829
|
+
/*
|
|
830
|
+
* `ResourceRetentionPolicy` — maintainer notes, kept OUTSIDE the anchored contract below because they cite
|
|
831
|
+
* repository test files an application cannot see. (This block used to sit orphaned above
|
|
832
|
+
* `ResourceDataSubjectPolicy`'s JSDoc, attached to nothing.)
|
|
833
|
+
*
|
|
521
834
|
* Resource-level opt-in to the **impersonalization-on-erasure** capability: on erasure the
|
|
522
835
|
* resource is impersonalized-and-retained (personal fields scrubbed, row kept for a legal/audit
|
|
523
836
|
* obligation) instead of hard-deleted. When set, the factory injects a `retentionStatus` marker
|
|
@@ -553,37 +866,22 @@ export type ResourceSystemAccessPolicy = {
|
|
|
553
866
|
* opposite direction). Reuse of that mechanism, never its name.
|
|
554
867
|
*/
|
|
555
868
|
/**
|
|
556
|
-
*
|
|
557
|
-
*
|
|
558
|
-
*
|
|
559
|
-
*
|
|
560
|
-
*
|
|
561
|
-
*
|
|
562
|
-
*
|
|
563
|
-
*
|
|
564
|
-
*
|
|
565
|
-
*
|
|
566
|
-
*
|
|
567
|
-
*
|
|
568
|
-
*
|
|
569
|
-
*
|
|
570
|
-
*
|
|
571
|
-
* the linkage can never be inferred from the presence of a user foreign key.
|
|
869
|
+
* `retentionPolicy` on a resource configuration — what a subject ERASURE does to this resource's rows, and,
|
|
870
|
+
* for a record a statute keeps, on what ground and for how long it survives one.
|
|
871
|
+
*
|
|
872
|
+
* Imported from `@wildo-ai/saas-models`. Declaring it requires a `dataSubjectPolicy` and a service-resolvable
|
|
873
|
+
* `UPDATE_MANY`, `READ` and `LIST`; the factory injects the `retentionStatus` marker every retained row carries.
|
|
874
|
+
*
|
|
875
|
+
* @example A statutory business record — kept through an erasure, restricted, until its period ends
|
|
876
|
+
* ```ts
|
|
877
|
+
* retentionPolicy: {
|
|
878
|
+
* mode: ErasureRetentionMode.RETAIN_ONLY,
|
|
879
|
+
* statutoryRetention: { ground: StatutoryRetentionGround.LEGAL_OBLIGATION, rationale: 'HGB §257(1) no. 4, AO §147(1)' },
|
|
880
|
+
* },
|
|
881
|
+
* dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
|
|
882
|
+
* retentionBinding: { retentionClass: DataRetentionClass.BUSINESS_RECORDS, startPoint: RetentionStartPoint.END_OF_CALENDAR_YEAR },
|
|
883
|
+
* ```
|
|
572
884
|
*/
|
|
573
|
-
export interface ResourceDataSubjectPolicy {
|
|
574
|
-
/** Whose login session an erasure of this row must end — never whether the row is about a person. */
|
|
575
|
-
kind: ResourceDataSubjectKind;
|
|
576
|
-
/**
|
|
577
|
-
* The field naming the `USERS` row whose session an erasure of this row must end.
|
|
578
|
-
*
|
|
579
|
-
* REQUIRED when {@link kind} is `LINKED_PRINCIPAL`, and FORBIDDEN otherwise — under
|
|
580
|
-
* `SELF_PRINCIPAL` the row's own id is the principal, and under `NO_PRINCIPAL` there is no
|
|
581
|
-
* principal at all, so a field there would be a contradiction rather than redundancy. Both
|
|
582
|
-
* directions are enforced at config build.
|
|
583
|
-
*/
|
|
584
|
-
sessionPrincipalField?: string;
|
|
585
|
-
}
|
|
586
|
-
|
|
587
885
|
export interface ResourceRetentionPolicy {
|
|
588
886
|
/**
|
|
589
887
|
* WHAT happens to a row of this resource when its subject is erased.
|
|
@@ -596,6 +894,46 @@ export interface ResourceRetentionPolicy {
|
|
|
596
894
|
* retention entirely; keeping them distinct is what makes "retain, nothing to scrub" expressible.
|
|
597
895
|
*/
|
|
598
896
|
mode: ErasureRetentionMode;
|
|
897
|
+
/**
|
|
898
|
+
* WHY an erasure may not delete these rows yet: the law requires them kept (#1635).
|
|
899
|
+
*
|
|
900
|
+
* Declared by a resource bound to `DataRetentionClass.BUSINESS_RECORDS` — and REQUIRED there: the factory
|
|
901
|
+
* refuses that binding without it, and refuses this member on any other class. A subject erasure then
|
|
902
|
+
* RESTRICTS each row still inside its statutory period instead of treating it as the author's choice:
|
|
903
|
+
* the row is kept with {@link mode}'s treatment (flipped to `RETAINED`, so hidden from every ordinary
|
|
904
|
+
* read and refused every ordinary write — the GDPR Art. 18(2) effect), listed in the erasure report
|
|
905
|
+
* with this ground and the instant its period ends, and deleted by the retention-class sweep when it
|
|
906
|
+
* does. Every other row of the request is erased as usual; the request is never refused for these.
|
|
907
|
+
*
|
|
908
|
+
* ## The PERIOD is not here, on purpose
|
|
909
|
+
*
|
|
910
|
+
* How long the rows are kept is `dataRetention[BUSINESS_RECORDS].retentionDays`, counted from the
|
|
911
|
+
* resource's `retentionBinding.startPoint`. A second number on this declaration would be a second
|
|
912
|
+
* authority for one period, and the two would drift.
|
|
913
|
+
*
|
|
914
|
+
* ## One erasure authority
|
|
915
|
+
*
|
|
916
|
+
* This lives INSIDE `retentionPolicy` rather than beside it: `retentionPolicy` is the declaration whose
|
|
917
|
+
* whole subject is what an erasure does to a row, and a separate "erasure exemption" beside it would give
|
|
918
|
+
* one row two erasure authorities.
|
|
919
|
+
*/
|
|
920
|
+
statutoryRetention?: ResourceStatutoryRetention;
|
|
921
|
+
}
|
|
922
|
+
|
|
923
|
+
/**
|
|
924
|
+
* The legal ground on which a {@link ResourceRetentionPolicy} keeps its rows through an erasure, and the
|
|
925
|
+
* operator's words for it (#1635).
|
|
926
|
+
*/
|
|
927
|
+
export interface ResourceStatutoryRetention {
|
|
928
|
+
/** The GDPR Art. 17(3) exemption relied on. One member today — see {@link StatutoryRetentionGround}. */
|
|
929
|
+
ground: StatutoryRetentionGround;
|
|
930
|
+
/**
|
|
931
|
+
* WHICH statute, in the operator's words — "HGB §257(1) no. 4 and AO §147(1): accounting source documents,
|
|
932
|
+
* 8 years from the end of the calendar year". Required and non-empty: an operator telling a data subject
|
|
933
|
+
* why a record was kept (Art. 12(4)) has to be able to name the law, and a ground with no law named is a
|
|
934
|
+
* claim nobody can check.
|
|
935
|
+
*/
|
|
936
|
+
rationale: string;
|
|
599
937
|
}
|
|
600
938
|
|
|
601
939
|
/**
|
|
@@ -695,6 +1033,9 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
695
1033
|
*/
|
|
696
1034
|
httpApiBinding?: HttpApiResourceBindingAuthored,
|
|
697
1035
|
|
|
1036
|
+
/** REQUIRED when `persistenceAdapter` is INTROSPECTION; meaningless otherwise. */
|
|
1037
|
+
introspectionBinding?: IntrospectionResourceBinding,
|
|
1038
|
+
|
|
698
1039
|
/**
|
|
699
1040
|
* OPTIONAL inbound ETL pipeline on an ordinary LOCAL resource — "some resources local, some
|
|
700
1041
|
* remote, ETL between them" (partial-resource coverage, model v3; PR-3). FORBIDDEN on an
|
|
@@ -753,6 +1094,14 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
753
1094
|
* explicit alternative authorization.
|
|
754
1095
|
*/
|
|
755
1096
|
systemAccessPolicy?: ResourceSystemAccessPolicy,
|
|
1097
|
+
|
|
1098
|
+
/**
|
|
1099
|
+
* Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
|
|
1100
|
+
* evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
|
|
1101
|
+
* most resources are not, and an application that never built an erasure lane has declared none
|
|
1102
|
+
* rather than failed a control. See {@link ResourceSubjectErasureLane}.
|
|
1103
|
+
*/
|
|
1104
|
+
subjectErasureLane?: ResourceSubjectErasureLane,
|
|
756
1105
|
coreOperations: TCoreOperationEnum[],
|
|
757
1106
|
customOperation?: TCustomOperationEnum, // default undefined
|
|
758
1107
|
operationsConfiguration : { [K in ValidOperationKeys<TCustomOperationEnum, TCoreOperationEnum>]: OperationConfig_ForKey<K, TMainSchema> }
|
|
@@ -805,6 +1154,24 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
805
1154
|
*/
|
|
806
1155
|
dataSubjectPolicy?: ResourceDataSubjectPolicy,
|
|
807
1156
|
|
|
1157
|
+
/**
|
|
1158
|
+
* How long this resource's rows are KEPT: a binding to one of the application's declared retention
|
|
1159
|
+
* classes, and the moment each row's clock starts. An engine sweep deletes a bound row once its
|
|
1160
|
+
* class's `retentionDays` have passed since that start point, through the service layer, on both
|
|
1161
|
+
* persistence adapters.
|
|
1162
|
+
*
|
|
1163
|
+
* ⚠️ NOT {@link retentionPolicy}. That is what an ERASURE does to a row (delete, or retain and
|
|
1164
|
+
* scrub); this is how long a row lives at all. The two compose: a row an erasure retained is still
|
|
1165
|
+
* deleted when its class period ends.
|
|
1166
|
+
*
|
|
1167
|
+
* Optional. An unbound resource is kept until it is erased, and is reported as unbound
|
|
1168
|
+
* (`unboundRetentionResources`) so the undecided period stays visible. A resource that binds a class
|
|
1169
|
+
* may not also declare a `.ttl()` field — one row, one retention authority.
|
|
1170
|
+
*
|
|
1171
|
+
* {@link RetentionStartPoint.SCOPE_DELETED} injects a server-owned `retentionStartedAt` field.
|
|
1172
|
+
*/
|
|
1173
|
+
retentionBinding?: ResourceRetentionBinding,
|
|
1174
|
+
|
|
808
1175
|
/**
|
|
809
1176
|
* Resource-level DEFAULT provenance for GDPR Art. 20 (portability) scoping; per-field overrides
|
|
810
1177
|
* are `.portabilityProvenance()`. Optional — Art. 15 (access) never consults provenance, so an
|
|
@@ -812,6 +1179,21 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
812
1179
|
* {@link ResourcePortabilityPolicy}.
|
|
813
1180
|
*/
|
|
814
1181
|
portabilityPolicy?: ResourcePortabilityPolicy,
|
|
1182
|
+
|
|
1183
|
+
/**
|
|
1184
|
+
* Declares every row of this resource a CASE: the unit of work an application sells an outcome for (a
|
|
1185
|
+
* matter, a file, a claim, a ticket). Model calls made while working on a row are attributed to it, so the
|
|
1186
|
+
* application can compute its cost per case (#1598), and expert decisions on agent work name it (#1599).
|
|
1187
|
+
*
|
|
1188
|
+
* A reference to a case is a `WorkUnitRef` (`{ resourceType, resourceId }`), and the engine accepts one at a
|
|
1189
|
+
* service boundary only when `resourceType` names a resource declaring `workUnit: true` and the caller can
|
|
1190
|
+
* READ that row. Several resources of one application may be work units. Default `false`.
|
|
1191
|
+
*
|
|
1192
|
+
* The engine opens the case frame by itself around every single-row operation on a work-unit resource (and
|
|
1193
|
+
* around a CREATE once the new row's id is assigned, before its after-create hooks), so a model call made
|
|
1194
|
+
* by a hook, a tool or a queued job started there is attributed without the application passing anything.
|
|
1195
|
+
*/
|
|
1196
|
+
workUnit?: boolean,
|
|
815
1197
|
}
|
|
816
1198
|
```
|
|
817
1199
|
## Import Origins
|
|
@@ -847,6 +1229,8 @@ export type ResourceConfiguration_Operation_Base<
|
|
|
847
1229
|
operationIdentifier : TCustomOperationEnum | TCoreOperationEnum,
|
|
848
1230
|
isOperationDefault : boolean, // default true
|
|
849
1231
|
serviceRuntimeMode: ResourceOperation_ServiceRuntimeMode; //default ResourceOperation_ServiceRuntimeMode.INLINE
|
|
1232
|
+
/** Validated operation policy, shared by authored and generated variants. */
|
|
1233
|
+
queueConfig?: ResourceConfiguration_QueueConfig;
|
|
850
1234
|
generatedOperation?: ResourceConfiguration_GeneratedOperationMetadata;
|
|
851
1235
|
|
|
852
1236
|
requestDto?: z.ZodSchema<any>;
|
|
@@ -886,11 +1270,80 @@ export type ResourceConfiguration_Operation_Base<
|
|
|
886
1270
|
*/
|
|
887
1271
|
repositoryDto?: z.ZodSchema<any>;
|
|
888
1272
|
|
|
889
|
-
|
|
1273
|
+
/**
|
|
1274
|
+
* `EVENT_COUNTER` badge writes this operation performs after it succeeds.
|
|
1275
|
+
*
|
|
1276
|
+
* `badgeRef` is a badge KEY (`<scope>:<identifier>`), NOT a bare identifier, and it is what
|
|
1277
|
+
* decides which badge is written — including at WHICH SCOPE. The scope used to be inferred from
|
|
1278
|
+
* this operation's own `resourcePrimaryScope`, which meant an operation on a user-scoped
|
|
1279
|
+
* resource wrote a user-scoped counter even when the definition it named lived at organization
|
|
1280
|
+
* scope: a row no definition declared, that no screen could render, reported nowhere.
|
|
1281
|
+
*
|
|
1282
|
+
* Every `badgeRef` is resolved against the registered `notificationBadgeDefinitions` at
|
|
1283
|
+
* CONFIGURATION time and the application refuses to start when one does not resolve. Only the
|
|
1284
|
+
* scopeId — whose badge — is left to the request.
|
|
1285
|
+
*/
|
|
1286
|
+
notificationBadgeOperations: { badgeRef: NotificationBadgeKey, operation: NotificationBadgeOperation }[];
|
|
890
1287
|
userNotifications: UserNotificationDefinition[];
|
|
891
1288
|
m2mNotifications: M2MNotificationDefinitionWithoutIdentifier[];
|
|
1289
|
+
/** Authored metered-usage recording for this operation; `undefined` when it consumes nothing. */
|
|
1290
|
+
recordsUsage?: MeteredUsageRecordingDefinition;
|
|
1291
|
+
/**
|
|
1292
|
+
* The purpose this operation's own processing rests on, and what a missing grant costs (#1258
|
|
1293
|
+
* Step 3). `undefined` means this operation declares nothing beyond whatever
|
|
1294
|
+
* `serviceConsentRequirement` already requires application-wide.
|
|
1295
|
+
*/
|
|
1296
|
+
consentGate?: ResourceOperationConsentGateDeclaration;
|
|
892
1297
|
}
|
|
893
1298
|
```
|
|
1299
|
+
|
|
1300
|
+
## Import Origins
|
|
1301
|
+
|
|
1302
|
+
- `@wildo-ai/saas-models`
|
|
1303
|
+
|
|
1304
|
+
## Source Excerpts
|
|
1305
|
+
|
|
1306
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
1307
|
+
|
|
1308
|
+
```typescript
|
|
1309
|
+
*
|
|
1310
|
+
* Queue policy for an operation declared with createResourceConfiguration_Initialization
|
|
1311
|
+
* from @wildo-ai/saas-models. Set queueConfig beside serviceRuntimeMode, outside variants.
|
|
1312
|
+
* Omitted fields take the schema defaults. timeoutMs limits caller waiting, not execution.
|
|
1313
|
+
* Priority selects the initial queue lane; retries do not promise permanent priority ordering.
|
|
1314
|
+
* maxRetries limits additional attempts after an actual failure, not duplicate broker deliveries.
|
|
1315
|
+
*
|
|
1316
|
+
* @example
|
|
1317
|
+
* // Inside an operation configuration:
|
|
1318
|
+
* // serviceRuntimeMode: ResourceOperation_ServiceRuntimeMode.QUEUED,
|
|
1319
|
+
* // queueConfig: { timeoutMs: 30000, maxRetries: 0 },
|
|
1320
|
+
*/
|
|
1321
|
+
export const ResourceConfiguration_QueueConfigSchema = z.object({
|
|
1322
|
+
/** Priority for queue routing (HIGH/CRITICAL → priority queue) */
|
|
1323
|
+
priority: z.enum(JobPriority).default(JobPriority.NORMAL),
|
|
1324
|
+
|
|
1325
|
+
/** Maximum retry attempts before dead-letter */
|
|
1326
|
+
maxRetries: z.number().int().min(0).default(3),
|
|
1327
|
+
|
|
1328
|
+
/** Caller reply-wait deadline in milliseconds (default: 5 minutes). Does not cancel worker execution. */
|
|
1329
|
+
timeoutMs: z.number().int().min(1000).max(2147483647).default(300000),
|
|
1330
|
+
|
|
1331
|
+
/**
|
|
1332
|
+
* Retry backoff timing (base delay, cap, curve). Controls how long a failed
|
|
1333
|
+
* job of this operation waits before each re-attempt. Optional — unset fields
|
|
1334
|
+
* fall back to `QUEUE_RETRY_DEFAULTS`. Honored by the queue worker via a
|
|
1335
|
+
* durable broker delay queue (see `QueueRetryBackoffConfig`). Distinct from
|
|
1336
|
+
* `maxRetries` (how many attempts) and `timeoutMs` (caller reply-wait deadline).
|
|
1337
|
+
*/
|
|
1338
|
+
retryConfig: QueueRetryBackoffConfigSchema.optional(),
|
|
1339
|
+
|
|
1340
|
+
}).strict().optional();
|
|
1341
|
+
|
|
1342
|
+
export type ResourceConfiguration_QueueConfig = z.infer<typeof ResourceConfiguration_QueueConfigSchema>;
|
|
1343
|
+
|
|
1344
|
+
/** Application input accepts omitted defaulted fields; the resource factory validates and resolves them. */
|
|
1345
|
+
export type ResourceConfiguration_QueueConfigAuthored = z.input<typeof ResourceConfiguration_QueueConfigSchema>;
|
|
1346
|
+
```
|
|
894
1347
|
## Import Origins
|
|
895
1348
|
|
|
896
1349
|
- `@wildo-ai/saas-models`
|
|
@@ -945,6 +1398,8 @@ export type ResourceConfiguration_Operation_ApiCall<
|
|
|
945
1398
|
httpVerb: HttpMethod;
|
|
946
1399
|
isApiKeyAccessDisabled: boolean; // default false
|
|
947
1400
|
isBulkOperation: boolean; // default false
|
|
1401
|
+
/** On a bulk twin: the resolved limit on rows per request (`resolveBulkOperationMaxSelection`). */
|
|
1402
|
+
bulkOperationMaxSelection?: number;
|
|
948
1403
|
initiatorInfos?: ResourceConfiguration_Operation_UrlInitiatorInfo[];
|
|
949
1404
|
|
|
950
1405
|
tokenAuthentication?: TokenAuthenticationConfig; // default undefined
|
|
@@ -953,9 +1408,20 @@ export type ResourceConfiguration_Operation_ApiCall<
|
|
|
953
1408
|
/**
|
|
954
1409
|
* Resolved per-endpoint rate-limit policy (forwarded by the resource
|
|
955
1410
|
* configuration factory from the variant builder parameters). Read at
|
|
956
|
-
* runtime by
|
|
1411
|
+
* runtime by three enforcers, one per plane that can dispatch this
|
|
1412
|
+
* operation: `RateLimitBackendService.checkPolicyForVariant` at the
|
|
957
1413
|
* controller pre-flight seam (`controller-resource.backend.service.ts`
|
|
958
|
-
* → `doOperation`).
|
|
1414
|
+
* → `doOperation`), `McpServerBackendService.assertOperationRateLimitPolicy`
|
|
1415
|
+
* on the MCP tool plane, and `assertDeclaredOperationRateLimit` on the agent
|
|
1416
|
+
* function-tool plane (`function-tools.backend.definitions.ts`). Only the
|
|
1417
|
+
* first is IP-keyed; the other two count the caller's credential, because
|
|
1418
|
+
* there is no socket to key on.
|
|
1419
|
+
*
|
|
1420
|
+
* **A new plane that dispatches a resource operation off HTTP owes its own
|
|
1421
|
+
* call to `checkPolicyForSubject`.** Nothing structural enforces that — the
|
|
1422
|
+
* field is simply not read where nobody reads it — which is how the MCP and
|
|
1423
|
+
* function-tool planes each shipped unthrottled for the operations that
|
|
1424
|
+
* declare a budget.
|
|
959
1425
|
*
|
|
960
1426
|
* Auto-variants (`SUMMARY` / `CONTEXT` for READ/LIST) inherit this
|
|
961
1427
|
* field from their default URL-bearing variant (`API_CALL` or
|
|
@@ -986,6 +1452,46 @@ export type ResourceConfiguration_Operation_ApiCall<
|
|
|
986
1452
|
|
|
987
1453
|
### Origin Package: `@wildo-ai/saas-models`
|
|
988
1454
|
|
|
1455
|
+
```typescript
|
|
1456
|
+
*
|
|
1457
|
+
* Frontend HTTP timeout for THIS variant, in milliseconds — declare it on any operation whose
|
|
1458
|
+
* synchronous round trip legitimately outlives the frontend client's 30-second default (an
|
|
1459
|
+
* operation that calls a model and waits for the answer, a long import, a blocking generation).
|
|
1460
|
+
*
|
|
1461
|
+
* The frontend resources client applies it as the per-request timeout on every dispatch shape
|
|
1462
|
+
* (api-call, api-call-with-callback, search). An explicit caller-supplied
|
|
1463
|
+
* `RequestOptions.timeout` still wins; omitting the field keeps the client default.
|
|
1464
|
+
*
|
|
1465
|
+
* Why it matters: without it, a long-running operation's request is aborted CLIENT-side while
|
|
1466
|
+
* the server work succeeds — the caller renders a network error, and the operation-success
|
|
1467
|
+
* refresh chain never fires, so lists keep showing the pre-operation world. Declare the
|
|
1468
|
+
* expectation on the variant (the operation knows it is long-running); do not hard-code
|
|
1469
|
+
* timeouts in consumer hooks, which duplicates that knowledge at every call site.
|
|
1470
|
+
*
|
|
1471
|
+
* This is a TRANSPORT expectation only — not a UI/observability signal (that is `riskLevel`)
|
|
1472
|
+
* and not a server-side bound: the backend is free to answer sooner or be cut off by its own
|
|
1473
|
+
* limits.
|
|
1474
|
+
*
|
|
1475
|
+
* @example a custom operation that generates a document before answering
|
|
1476
|
+
* variants: [{
|
|
1477
|
+
* variantType: ResourceOperationVariantType.API_CALL,
|
|
1478
|
+
* roles: [CORE_ORG_ROLES.ORG_MEMBER],
|
|
1479
|
+
* riskLevel: ResourceOperationRiskLevel.MEDIUM,
|
|
1480
|
+
* clientRequestTimeoutMs: 300_000, // five minutes — the generation is synchronous
|
|
1481
|
+
* requestDto: GenerateReportRequest_Schema,
|
|
1482
|
+
* customResponseDto: GenerateReportOutcome_Schema,
|
|
1483
|
+
* }]
|
|
1484
|
+
*/
|
|
1485
|
+
clientRequestTimeoutMs?: number;
|
|
1486
|
+
```
|
|
1487
|
+
## Import Origins
|
|
1488
|
+
|
|
1489
|
+
- `@wildo-ai/saas-models`
|
|
1490
|
+
|
|
1491
|
+
## Source Excerpts
|
|
1492
|
+
|
|
1493
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
1494
|
+
|
|
989
1495
|
```typescript
|
|
990
1496
|
*
|
|
991
1497
|
* Variant builder type that distributes operation-specific fields based on the operation key.
|
|
@@ -1031,11 +1537,16 @@ export type OperationConfig_ForKey<
|
|
|
1031
1537
|
TMainSchema extends z.ZodTypeAny = z.ZodAny
|
|
1032
1538
|
> = {
|
|
1033
1539
|
variants: OperationVariant_ForKey<K, TMainSchema>[];
|
|
1540
|
+
/** Reply deadline, initial routing priority and failure retry budget/backoff. Does not cancel execution. */
|
|
1541
|
+
queueConfig?: ResourceConfiguration_QueueConfigAuthored;
|
|
1034
1542
|
serviceRuntimeMode?: ResourceOperation_ServiceRuntimeMode;
|
|
1035
1543
|
parentResourceAccessScopeStrategyOverrides?: { resourceType: ResourceType, accessScopeStrategy: ResourceRelationshipAccessScopeStrategy }[];
|
|
1036
1544
|
userNotifications?: UserNotificationDefinitionWithoutPrimaryScopeAndIdentifier[];
|
|
1037
|
-
notificationBadgeOperations?: {
|
|
1545
|
+
notificationBadgeOperations?: { badgeRef: NotificationBadgeKey, operation: NotificationBadgeOperation }[];
|
|
1038
1546
|
m2mNotifications?: M2MNotificationDefinitionWithoutIdentifier[];
|
|
1547
|
+
recordsUsage?: MeteredUsageRecordingDefinition;
|
|
1548
|
+
/** See {@link ResourceOperationConsentGateDeclaration} (#1258 Step 3). */
|
|
1549
|
+
consentGate?: ResourceOperationConsentGateDeclaration;
|
|
1039
1550
|
};
|
|
1040
1551
|
```
|
|
1041
1552
|
## Import Origins
|
|
@@ -1348,10 +1859,11 @@ export function isSearchableRelationDescriptor(
|
|
|
1348
1859
|
* relies on, mirrored for reads. The viewer therefore needs no read access to the
|
|
1349
1860
|
* related row itself (e.g. another member's `user_profile`).
|
|
1350
1861
|
*
|
|
1351
|
-
* @remarks
|
|
1352
|
-
*
|
|
1353
|
-
*
|
|
1354
|
-
*
|
|
1862
|
+
* @remarks Both persistence adapters resolve it: the MongoDB and PostgreSQL resource
|
|
1863
|
+
* repositories each implement `findFieldValuesByJoinField` with the same contract
|
|
1864
|
+
* (the PostgreSQL half landed with #1100; until then a PostgreSQL-backed related
|
|
1865
|
+
* resource silently degraded every label to `fallback`). Import from
|
|
1866
|
+
* `@wildo-ai/saas-models`.
|
|
1355
1867
|
*
|
|
1356
1868
|
* @example
|
|
1357
1869
|
* // organizationMembers labels itself by the linked user's name. firstName/
|
|
@@ -1499,6 +2011,8 @@ export type ResourceConfiguration<
|
|
|
1499
2011
|
* (factory-enforced both ways). See the authoring-side declaration for the full contract.
|
|
1500
2012
|
*/
|
|
1501
2013
|
httpApiBinding?: HttpApiResourceBinding,
|
|
2014
|
+
/** REQUIRED when `persistenceAdapter` is INTROSPECTION; meaningless otherwise. */
|
|
2015
|
+
introspectionBinding?: IntrospectionResourceBinding,
|
|
1502
2016
|
|
|
1503
2017
|
/**
|
|
1504
2018
|
* The inbound ETL pipeline, when this LOCAL resource declared one — parsed + coherence-checked
|
|
@@ -1528,6 +2042,14 @@ export type ResourceConfiguration<
|
|
|
1528
2042
|
*/
|
|
1529
2043
|
systemAccessPolicy?: ResourceSystemAccessPolicy,
|
|
1530
2044
|
|
|
2045
|
+
/**
|
|
2046
|
+
* Declares this resource as the application's SUBJECT-ERASURE REQUEST LANE and binds the fields an
|
|
2047
|
+
* evidence collector reads. Omitted ⇒ this resource is not that lane, which is the honest default:
|
|
2048
|
+
* most resources are not, and an application that never built an erasure lane has declared none
|
|
2049
|
+
* rather than failed a control. See {@link ResourceSubjectErasureLane}.
|
|
2050
|
+
*/
|
|
2051
|
+
subjectErasureLane?: ResourceSubjectErasureLane,
|
|
2052
|
+
|
|
1531
2053
|
/**
|
|
1532
2054
|
* W7.3a: Marks this resource as accessible to anonymous sessions.
|
|
1533
2055
|
* When true, the engine generates dual URL paths and a STANDALONE relationship to ANONYMOUS_USERS.
|
|
@@ -1551,11 +2073,17 @@ export type ResourceConfiguration<
|
|
|
1551
2073
|
*/
|
|
1552
2074
|
dataSubjectPolicy?: ResourceDataSubjectPolicy,
|
|
1553
2075
|
|
|
2076
|
+
/** Resolved retention-class binding, exactly as declared (undefined when the resource binds no class). */
|
|
2077
|
+
retentionBinding?: ResourceRetentionBinding,
|
|
2078
|
+
|
|
1554
2079
|
/** Resolved portability default (undefined when the resource declared no `portabilityPolicy` — an
|
|
1555
2080
|
* Art. 15 export is unaffected, an Art. 20 export refuses on any field that also lacks its own
|
|
1556
2081
|
* `.portabilityProvenance()`). */
|
|
1557
2082
|
portabilityPolicy?: ResourcePortabilityPolicy,
|
|
1558
2083
|
|
|
2084
|
+
/** Resolved `workUnit` declaration (#1598): `true` when every row of this resource is a case. */
|
|
2085
|
+
workUnit?: boolean,
|
|
2086
|
+
|
|
1559
2087
|
operations : ResourceConfiguration_Operation<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>[]
|
|
1560
2088
|
}
|
|
1561
2089
|
```
|
|
@@ -1578,6 +2106,20 @@ export type ResourcesRegistry = {
|
|
|
1578
2106
|
resourceConfigurations: {
|
|
1579
2107
|
[key: ResourceType]: AnyResourceConfiguration ;
|
|
1580
2108
|
};
|
|
2109
|
+
/**
|
|
2110
|
+
* The resource types the APPLICATION registered — its own, never the engine's.
|
|
2111
|
+
*
|
|
2112
|
+
* The registry composes app and core factory maps into one `resourceConfigurations`, which is what
|
|
2113
|
+
* every runtime consumer wants. This is the one place the two are still distinguishable, so the
|
|
2114
|
+
* split is recorded HERE rather than re-derived by each consumer from a core key set — which would
|
|
2115
|
+
* be a second enumeration of a population this file already knows.
|
|
2116
|
+
*
|
|
2117
|
+
* Its consumer today is the personal-data declaration report, which asks a question only an
|
|
2118
|
+
* application author can act on: the engine declares its own posture on ~85 resources, and putting
|
|
2119
|
+
* those in front of a reader of a report about THEIR application is how a diagnostic channel stops
|
|
2120
|
+
* being read.
|
|
2121
|
+
*/
|
|
2122
|
+
applicationResourceTypes: ResourceType[];
|
|
1581
2123
|
/**
|
|
1582
2124
|
* Map of ResourceType to its standard field identifier (e.g., USERS -> userId).
|
|
1583
2125
|
* Used for FK field resolution without string manipulation.
|
|
@@ -1610,5 +2152,13 @@ export type ResourcesRegistry = {
|
|
|
1610
2152
|
* from the presence of a unit field. See `OrganizationUnitNarrowingDeclaration`.
|
|
1611
2153
|
*/
|
|
1612
2154
|
organizationUnitNarrowing: Readonly<Partial<Record<ResourceType, OrganizationUnitNarrowingDeclaration>>>;
|
|
2155
|
+
/**
|
|
2156
|
+
* Resources a UNIT-scoped service-provider expert may READ across the whole client organization even
|
|
2157
|
+
* though they do not narrow by unit — a shared reference list, say (#1597). Each entry carries the
|
|
2158
|
+
* rationale a reviewer reads. Validated at boot: never an authorization-plane resource, never a
|
|
2159
|
+
* resource that also narrows by unit. Absent or empty ⇒ a unit-scoped expert reaches only the
|
|
2160
|
+
* resources that narrow by unit (fail closed).
|
|
2161
|
+
*/
|
|
2162
|
+
serviceProviderOrganizationWideAccess?: Readonly<Partial<Record<ResourceType, ServiceProviderOrganizationWideAccessDeclaration>>>;
|
|
1613
2163
|
}
|
|
1614
2164
|
```
|