@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
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
# Interpret authority and support-access evidence
|
|
2
|
+
|
|
3
|
+
Read this when building an administrator investigation view, explaining who changed a member's
|
|
4
|
+
authority, or extending administrative operations. Keep the built-in lifecycle and its transaction
|
|
5
|
+
context; a custom `roles` field does not automatically inherit these specialized emitters.
|
|
6
|
+
|
|
7
|
+
## Identify which authority moved
|
|
8
|
+
|
|
9
|
+
| Built-in lifecycle | Evidence to interpret |
|
|
10
|
+
|---|---|
|
|
11
|
+
| Organization membership role change | `ORGANIZATION_MEMBER_ROLE_CHANGED` carries previous, resulting and requested role sets where supplied, plus the organization and membership. |
|
|
12
|
+
| Membership removal or invitation revocation | `ORGANIZATION_MEMBER_REMOVED` captures roles, previous status and revoked unit assignments before deletion removes that state. |
|
|
13
|
+
| Unit role assignment change | `ORGANIZATION_UNIT_MEMBER_ROLE_CHANGED` carries previous, new and requested **scalar** roles and the assignment/unit. It is narrower than organization-wide membership. |
|
|
14
|
+
| Unit assignment revocation | Its distinct removal event carries the revoked role; do not reconstruct that role from a row that has been deleted. |
|
|
15
|
+
| Ownership repair | Inspect `RESOURCE_OPERATION_PERFORMED` for the membership resource and `GRANT_OWNERSHIP`, including `fieldEvidence`. Do not expect a specialized role-change event's `requestedRoles` field here. |
|
|
16
|
+
|
|
17
|
+
The requested roles are what the caller authored; the resulting roles are what the operation stored.
|
|
18
|
+
Defaults and grant ceilings make that distinction meaningful. A unit assignment is one role in one
|
|
19
|
+
unit, not an organization-wide array with a different label.
|
|
20
|
+
|
|
21
|
+
The audit record's `userId` identifies the actor. The affected person and membership are separate
|
|
22
|
+
event data, such as `eventData.userId` and `eventData.memberId`; filtering by the record's `userId`
|
|
23
|
+
does not find every change **to** that person. For these authority events, `eventData.changedBy`
|
|
24
|
+
also describes the actor.
|
|
25
|
+
|
|
26
|
+
Beside `userId`, every record states the KIND of that actor in `actorKind` (`user`,
|
|
27
|
+
`delegated_client`, `machine`, `system`, `unauthenticated`, `unattributed`). When an AI agent performed the change, the
|
|
28
|
+
record also carries `agentActor` (which agent, which execution, which tool) — `userId` still names
|
|
29
|
+
the person whose authority the agent used. A change made through an external A2A or MCP client names
|
|
30
|
+
that client in `delegatingClientId`; one made with a machine credential names it in
|
|
31
|
+
`principalCredentialId`. `unauthenticated` marks an event where no principal is proven by design (a
|
|
32
|
+
sign-in attempt, a public operation). `unattributed` is the value to alert on: an action happened and no
|
|
33
|
+
principal could be resolved.
|
|
34
|
+
|
|
35
|
+
## Query first, then interpret the payload
|
|
36
|
+
|
|
37
|
+
Use the application's API base and a session authorized for the named customer organization.
|
|
38
|
+
For example:
|
|
39
|
+
|
|
40
|
+
```http
|
|
41
|
+
GET /organizations/{organizationId}/audit-logs?eventType=organization_member_role_changed
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
For a support crossing, use `eventType=cross_tenant_administrative_access` on the same organization
|
|
45
|
+
audit route. The route's scope and role checks still apply. A guessed organization identifier or a
|
|
46
|
+
role string does not grant access to another customer's history.
|
|
47
|
+
|
|
48
|
+
Use declared top-level query filters. Nested `eventData.resourceType` and
|
|
49
|
+
`eventData.operationIdentifier` are payload fields to inspect after retrieval, not LIST filters.
|
|
50
|
+
For ownership repair, select the operation-event family before inspecting those fields; a search
|
|
51
|
+
restricted to specialized member-role changes can miss it.
|
|
52
|
+
|
|
53
|
+
## Correlate support access without collapsing the records
|
|
54
|
+
|
|
55
|
+
| Record | Question it answers |
|
|
56
|
+
|---|---|
|
|
57
|
+
| Grant lifecycle | Who requested/approved/revoked access, with which justification and validity window? |
|
|
58
|
+
| Crossing observation | Which operator reached which identifiable tenant through which resource operation and variant? |
|
|
59
|
+
| Operation/change evidence | What was requested or changed by the business action? |
|
|
60
|
+
| Application-wide read event | Which broader read occurred without a single target organization? |
|
|
61
|
+
|
|
62
|
+
Resolve `authorizingGrantId` **together with** `authorizingGrantScope`. The row crossing observer uses
|
|
63
|
+
the tenant-grant scope when a tenant grant was resolved; application-wide read grants do not replace
|
|
64
|
+
row admission. Collection observations can identify the applicable tenant or application grant.
|
|
65
|
+
An absent grant identifier is not a request to invent one. `admissionDeclared` tells you the operation
|
|
66
|
+
opted into the crossing mechanism; it alone proves neither usable authorization nor successful work.
|
|
67
|
+
|
|
68
|
+
The row observer acts after the target row's tenant is identifiable; the crossing entry belongs to
|
|
69
|
+
that reached tenant's audit view. Declared READ/LIST/SEARCH outside organization-scoped resources
|
|
70
|
+
use a separate observer grouping the foreign tenants actually returned, including a single READ.
|
|
71
|
+
An empty result produces no returned-record crossing. That observer excludes internal/webhook
|
|
72
|
+
execution and the organization-scoped resources covered by the row observer; COUNT has no returned
|
|
73
|
+
records for it to inspect. A request
|
|
74
|
+
refused before reaching an observation point need not have a crossing entry. Correlate the available
|
|
75
|
+
actor, operation, affected record and request context with grant and operation evidence rather than
|
|
76
|
+
assuming one atomic evidence bundle.
|
|
77
|
+
|
|
78
|
+
## Preserve transaction and delivery meaning
|
|
79
|
+
|
|
80
|
+
Built-in authority writes stage their event data and emit after commit, so a rollback does not leave
|
|
81
|
+
an event asserting a change that never committed. The audit store is not part of that business
|
|
82
|
+
transaction. When extending the lifecycle, preserve its transaction options and supported
|
|
83
|
+
post-commit mechanism; emitting eagerly from an ordinary hook would change that guarantee.
|
|
84
|
+
|
|
85
|
+
Reasserting unchanged roles emits no new specialized role-change event. Cascade removal is explained
|
|
86
|
+
by the parent membership/account lifecycle, not fabricated as a separate revocation for every child.
|
|
87
|
+
System provisioning can produce stored evidence without an authenticated tenant routing context;
|
|
88
|
+
tenant SIEM routing uses that authenticated context, not merely an organization field in event data.
|
|
89
|
+
|
|
90
|
+
Crossing observation is best-effort and does not fail the observed request. An unavailable service or
|
|
91
|
+
failed emission can leave no retained entry. Inspect observation-drop and audit-store failure
|
|
92
|
+
diagnostics as well as configured log/metric retention. An empty query proves neither absence of
|
|
93
|
+
access nor healthy evidence delivery. Present a recorded action, a permission decision and the
|
|
94
|
+
availability of evidence as separate claims.
|
|
95
|
+
|
|
96
|
+
|
|
97
|
+
## Application audit read policy
|
|
98
|
+
|
|
99
|
+
`auditTrail.applicationReadAccess` defaults to `AuditApplicationReadAccess.ROLE_BASED` in every
|
|
100
|
+
environment. Holders of `CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN` or the read-only
|
|
101
|
+
`CORE_APP_ROLES.APP_AUDIT_EVIDENCE_READER` can read the application audit trail without a second approval;
|
|
102
|
+
scope filters and cross-tenant observations still apply. Give the evidence reader — not super-admin — to a
|
|
103
|
+
party that must read the trail and must not administer the application: an assurance collector's machine
|
|
104
|
+
credential or an external auditor. It inherits no other role. Opt into
|
|
105
|
+
`AuditApplicationReadAccess.INDEPENDENT_APPROVAL` when the application requires a time-bound
|
|
106
|
+
grant signed by a different administrator. Import the enum from `@wildo-ai/saas-models`.
|
|
107
|
+
|
|
108
|
+
A role-based audit read can therefore legitimately have no `authorizingGrantId`. Do not invent a
|
|
109
|
+
grant or infer refusal from that absence: correlate the operation, configured policy, actor roles
|
|
110
|
+
and response outcome.
|
|
111
|
+
|
|
112
|
+
A MACHINE reader has no user id. Its reads are attributed by credential instead: each
|
|
113
|
+
`cross_tenant_administrative_access` row carries `eventData.machineCredential`, and a machine read of the
|
|
114
|
+
application audit door also records `machine_access` (`resourceServer: api`, `operationIdentifier: api_list`,
|
|
115
|
+
`api_read` or `api_search`) even when it returned no tenant's rows. A collector counting audit rows should
|
|
116
|
+
exclude the rows its own credential wrote, or each run counts the previous run's reads.
|
|
117
|
+
|
|
118
|
+
Under `INDEPENDENT_APPROVAL` a machine reads only through an application access grant bound to its
|
|
119
|
+
credential: an administrator requests it with `grantedMachineCredential` (an active, unexpired API key or
|
|
120
|
+
OAuth client of this application), a DIFFERENT administrator approves it, and the grant admits that credential
|
|
121
|
+
and never the administrator who requested it. A machine credential can also ask the token endpoint for a
|
|
122
|
+
shorter token with `requested_expires_in` (seconds) on the `client_credentials` grant; the application's
|
|
123
|
+
access-token lifetime remains the ceiling. Other application-wide reads and tenant support grants keep their existing
|
|
124
|
+
requirements. Audit records are not automatically anonymized in production.
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
For an application requiring independent approval, configure the shared application configuration:
|
|
128
|
+
|
|
129
|
+
```typescript
|
|
130
|
+
import { AuditApplicationReadAccess, type AuditTrailConfig } from '@wildo-ai/saas-models';
|
|
131
|
+
|
|
132
|
+
const auditTrail: AuditTrailConfig = {
|
|
133
|
+
applicationReadAccess: AuditApplicationReadAccess.INDEPENDENT_APPROVAL,
|
|
134
|
+
};
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
Omitting `applicationReadAccess` selects role-based access. The stronger universal
|
|
138
|
+
`WILDO.ACCESS.SEGREGATION_OF_DUTIES@1` claim must not be accepted on the strength of a directory-only
|
|
139
|
+
elevation test when audit reads intentionally use the role-based policy.
|
|
140
|
+
|
|
141
|
+
|
|
142
|
+
The startup policy event also records `auditApplicationReadAccess.before` and `.after`. An absent
|
|
143
|
+
historical policy is represented as an unknown baseline, not assumed to have required approval.
|
|
144
|
+
Omitting the setting and explicitly selecting role-based access are the same effective policy.
|
|
145
|
+
This event observes the deployed configuration; deployment history identifies who authored it.
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
# Framework Collection-Operation Declarations
|
|
2
|
+
|
|
3
|
+
What a LIST or SEARCH operation variant declares so callers can filter, sort, search, page and
|
|
4
|
+
export it — and what each declaration's ABSENCE means, which is the half that surprises people.
|
|
5
|
+
|
|
6
|
+
Read this when authoring a collection operation, or when a list "works" but returns the wrong rows.
|
|
7
|
+
|
|
8
|
+
| declaration | what it does | absent ⇒ |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| `filterFields` | field name → schema; the fields a caller may filter on. A date-typed field automatically becomes a RANGE filter | no filtering offered |
|
|
11
|
+
| `sortFields` | the sortable allow-list | **no allow-list you chose** — see below |
|
|
12
|
+
| `isSearchable` + `searchableFields` + `searchableOptions` | free-text search over declared fields, own or relational | no text search |
|
|
13
|
+
| `maxPaginatedResultPerPageLimit` | the per-page ceiling a caller cannot exceed | 100 on a LIST, 50 on a SEARCH — see below |
|
|
14
|
+
| `collectionExport` | `formats` (`CSV` / `JSON` / `PDF`), `rowScopes`, `maximumExportedRows`, and `pdfTemplateId` exactly when `PDF` is offered, with `maximumExportedRows` required for a whole-set PDF (see the `pdf-template-authoring` skill); derives an export route beside the operation, under the same roles | no export route |
|
|
15
|
+
|
|
16
|
+
## ⚠️ Declare `sortFields`. Omitting it is not "no sorting"
|
|
17
|
+
|
|
18
|
+
With no `sortFields` there is nothing to validate a caller's `sort` against, and the two adapters
|
|
19
|
+
then do different things — neither of which is an allow-list you authored:
|
|
20
|
+
|
|
21
|
+
- **MongoDB returns the caller's sort VERBATIM.** Any field name they send is applied.
|
|
22
|
+
- **PostgreSQL falls back to the resource's planned COLUMNS** as the whitelist — it must name a real
|
|
23
|
+
column, because an unknown identifier there is both a SQL error and an injection surface.
|
|
24
|
+
|
|
25
|
+
So the behaviour is fail-closed on PostgreSQL and open on MongoDB, and on neither is it the set you
|
|
26
|
+
intended. Declare the fields you want sortable.
|
|
27
|
+
|
|
28
|
+
## Every page is totally ordered — you do not add a tiebreaker
|
|
29
|
+
|
|
30
|
+
A sortable field does not have to be unique. Whatever order a page is served in — the caller's
|
|
31
|
+
`sort`, your first `sortFields` entry, or the `createdAt` newest-first default — both adapters end it
|
|
32
|
+
on `_id` in the direction of the last key. Rows that tie on the sort key (a status, a batch written in
|
|
33
|
+
one millisecond) are therefore served exactly once across pages, and a job that walks every page sees
|
|
34
|
+
every row. Do not add `_id` to `sortFields` for this.
|
|
35
|
+
|
|
36
|
+
On MongoDB a field marked `.isDBIndexed()` is indexed as `{ field: 1, _id: 1 }`, so the index still
|
|
37
|
+
serves that ordering in both directions. On PostgreSQL the single-column index serves it as it is.
|
|
38
|
+
|
|
39
|
+
## What a filter is, and is not
|
|
40
|
+
|
|
41
|
+
A filter is an equality, a list of values, or a declared date range. There is no operator syntax on
|
|
42
|
+
the wire — anything richer is a custom operation with its own request shape.
|
|
43
|
+
|
|
44
|
+
**Filtering never widens visibility.** Whatever a caller asks for is intersected with the tenancy and
|
|
45
|
+
ownership filter their execution context carries, and with the retention hide. A filter can only ever
|
|
46
|
+
narrow.
|
|
47
|
+
|
|
48
|
+
## Free text is substring matching, not a search engine
|
|
49
|
+
|
|
50
|
+
Own-field search compiles to a case-insensitive substring match on both adapters. There is no
|
|
51
|
+
relevance ordering, no stemming and no typo tolerance — results come back in the declared sort order.
|
|
52
|
+
If the product needs ranked search, this declaration is not it.
|
|
53
|
+
|
|
54
|
+
Every own-field name in `searchableFields` must be a field of the resource, exactly like `filterFields`
|
|
55
|
+
and `sortFields`: the factory refuses a name that is not one when the resource is registered. On
|
|
56
|
+
PostgreSQL such a name would fail every search on a missing column; on MongoDB it would quietly match
|
|
57
|
+
nothing. A relational entry is checked for its `localField`, the half that lives on this resource.
|
|
58
|
+
|
|
59
|
+
## Export is not a snapshot
|
|
60
|
+
|
|
61
|
+
A whole-set export PAGES THROUGH the source operation, so rows written or deleted while the file is
|
|
62
|
+
produced can be missed or repeated; there is no consistent read across pages. Headers are sent before
|
|
63
|
+
the second page is read, so a fault mid-stream TRUNCATES the file rather than returning an error —
|
|
64
|
+
the row-count header is what lets a consumer notice a short file.
|
|
65
|
+
|
|
66
|
+
`maximumExportedRows` is optional, and omitting it means the export pages through whatever the
|
|
67
|
+
caller's filters match. Narrowing that is a decision you make deliberately.
|
|
68
|
+
|
|
69
|
+
CSV is lossy for nested values: an object or array is JSON-encoded into its cell to stay recoverable.
|
|
70
|
+
When a machine reads the result back, choose JSON.
|
|
71
|
+
|
|
72
|
+
## A page ceiling bounds what a CLIENT can ask for — and the two operations enforce it differently
|
|
73
|
+
|
|
74
|
+
Every paginated read is capped at the operation's `maxPaginatedResultPerPageLimit`, on every storage
|
|
75
|
+
adapter. What a caller who asks for more gets back depends on the operation:
|
|
76
|
+
|
|
77
|
+
| operation | a `limit` above the ceiling | undeclared ceiling |
|
|
78
|
+
|---|---|---|
|
|
79
|
+
| LIST | **clamped** — answered `200` with the ceiling applied, and the response's `pagination.limit` reports the limit actually used | 100 |
|
|
80
|
+
| SEARCH | **refused** — `400` validation failure before any query runs, because the request contract carries the same number | 50 |
|
|
81
|
+
|
|
82
|
+
So a client paging through a SEARCH must read the ceiling rather than guess high, and a client of a
|
|
83
|
+
LIST must read `pagination.limit` rather than assume its request was honoured.
|
|
84
|
+
|
|
85
|
+
Declare a ceiling when the default is wrong for the collection. The declaration is a contract, not a
|
|
86
|
+
policy limit: nothing stops an operation declaring a large one, and every page of that size is served
|
|
87
|
+
in full — so size it against the cost of the rows, not against what a caller would like.
|
|
88
|
+
|
|
89
|
+
**A ceiling does not bound an internal read.** Code in a custom implementation or service that asks a
|
|
90
|
+
repository for rows WITHOUT pagination gets every matching row, deliberately: framework enumerations
|
|
91
|
+
such as erasure cascades and subject exports rely on completeness. Over a large tenant that read holds
|
|
92
|
+
the whole result in memory, and nothing prevents it. When your code does not need every row, request
|
|
93
|
+
a page and iterate.
|
|
94
|
+
|
|
95
|
+
**A ceiling bounds the page, not the work.** An expensive filter is still expensive, and the count that
|
|
96
|
+
accompanies a paginated read runs whatever the page size.
|
|
97
|
+
|
|
98
|
+
## Related
|
|
99
|
+
|
|
100
|
+
- `references/framework-saas-models-resource-config-api.md` — the operation-variant type these are
|
|
101
|
+
declared on.
|
package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md
ADDED
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# Framework Operation Audit API
|
|
2
|
+
|
|
3
|
+
What a resource operation leaves in the audit trail, and how to select its evidence.
|
|
4
|
+
|
|
5
|
+
Read it when an operation must be reviewable — or when you expected a row and did not get one.
|
|
6
|
+
|
|
7
|
+
## The baseline needs no declaration
|
|
8
|
+
|
|
9
|
+
Every framework-managed write-shaped `HIGH` / `CRITICAL` variant emits an operation-performed row automatically. `riskLevel` is the
|
|
10
|
+
axis, and that is deliberate: a risk-driven floor is fail-closed by omission, whereas a
|
|
11
|
+
declarative-only mechanism fails OPEN when an author forgets — which is how twenty event types came
|
|
12
|
+
to be declared and wired to nothing.
|
|
13
|
+
|
|
14
|
+
So the first move is not to declare anything. It is to set `riskLevel` honestly.
|
|
15
|
+
|
|
16
|
+
## Include a below-floor write
|
|
17
|
+
|
|
18
|
+
`auditableEvent.auditBelowRiskFloor` emits for a write-shaped `MEDIUM` / `LOW` verb anyway. Reach for it when the
|
|
19
|
+
verb's danger is not proportional to its blast radius — "how alarming is the UI affordance" and "is
|
|
20
|
+
this evidence an auditor needs" are related questions, not the same one.
|
|
21
|
+
|
|
22
|
+
Mark selected write-evidence fields with `.isAuditEvidence()` on the schema. This includes their available before/after values in the operation event; it does not trigger read auditing. Choose authority, lifecycle and scope fields rather than personal text or secrets.
|
|
23
|
+
|
|
24
|
+
## Preserve an operator's reason
|
|
25
|
+
|
|
26
|
+
Set `auditableEvent.reasonField` to the top-level request string that carries the justification.
|
|
27
|
+
The framework captures that string before custom input transformations and includes it as `eventData.reason`
|
|
28
|
+
after the write commits. It stays in history when a later operation clears or replaces the resource's current
|
|
29
|
+
reason. Bound the request text and ask for an operational explanation; do not select secrets or general personal
|
|
30
|
+
data. No other request values are copied by this declaration. It does not raise the risk floor: a `MEDIUM` or
|
|
31
|
+
`LOW` write still needs `auditBelowRiskFloor` if it must be recorded.
|
|
32
|
+
|
|
33
|
+
`OVERRIDE_ALL` implementations own persistence and bypass the framework-managed post-commit lane. They must
|
|
34
|
+
record their own committed event, after persistence succeeds or an enclosing transaction commits. The engine's
|
|
35
|
+
application and organization feature commands do this explicitly, including enable, disable and reset reasons.
|
|
36
|
+
|
|
37
|
+
## Three things the trail will not tell you
|
|
38
|
+
|
|
39
|
+
- **A high-risk READ leaves no operation-level row.** The event asserts an effect, and a read had
|
|
40
|
+
none. Neither a higher risk nor `auditBelowRiskFloor` overrides this exclusion. One-time response
|
|
41
|
+
disclosure is a separate controller mechanism: backend-only fields returned at creation, or ephemeral
|
|
42
|
+
response fields, trigger it when exposed. `.isAuditEvidence()` is not one of those triggers. For an
|
|
43
|
+
ordinary business read that needs a record, use an appropriate explicit audit event at the owning
|
|
44
|
+
service; do not mark stored data as ephemeral merely to obtain a row.
|
|
45
|
+
- **A bulk write records submitted field NAMES without prior values.** The before-image is fetched only
|
|
46
|
+
when exactly one row is selected.
|
|
47
|
+
- **There is no suppression path.** An operation with its own purpose-built event emits BOTH rows —
|
|
48
|
+
and they are not duplicates: the generic row carries the operation identity, the cascade
|
|
49
|
+
correlation, the actor's roles as they stood and the execution type, none of which a purpose-built
|
|
50
|
+
event carries.
|
|
51
|
+
|
|
52
|
+
## `riskLevel` drives audit and UI, never authorization
|
|
53
|
+
|
|
54
|
+
It decides audit emission, MCP destructive hints, danger-zone placement and typed confirmation. It
|
|
55
|
+
decides NO authorization. Re-authentication before a high-impact action is
|
|
56
|
+
`requiresStepUpAuthentication`, declared separately — see
|
|
57
|
+
`references/framework-operation-step-up-api.md`.
|
|
58
|
+
|
|
59
|
+
## Operation Auditable Event
|
|
60
|
+
|
|
61
|
+
## Import Origins
|
|
62
|
+
|
|
63
|
+
- `@wildo-ai/saas-models`
|
|
64
|
+
|
|
65
|
+
## Source Excerpts
|
|
66
|
+
|
|
67
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
68
|
+
|
|
69
|
+
```typescript
|
|
70
|
+
*
|
|
71
|
+
* Declarative control over this variant's audit emission.
|
|
72
|
+
*
|
|
73
|
+
* **The baseline needs no declaration.** Every framework-managed write-shaped `HIGH` / `CRITICAL` variant emits
|
|
74
|
+
* `RESOURCE_OPERATION_PERFORMED` automatically — `riskLevel` is already the framework's canonical
|
|
75
|
+
* danger axis (it drives MCP destructive hints, frontend danger-zone placement and CRITICAL typed
|
|
76
|
+
* confirmation), and a risk-driven floor is fail-closed by omission. A declarative-ONLY mechanism
|
|
77
|
+
* was rejected for exactly that reason: it fails OPEN when an author forgets, which is how 20 event
|
|
78
|
+
* types came to be declared in `CoreAuditableEventType` and wired to nothing.
|
|
79
|
+
*
|
|
80
|
+
* This declaration selects below-floor writes and explicit operator justification evidence.
|
|
81
|
+
*/
|
|
82
|
+
export type ResourceOperation_AuditableEvent = {
|
|
83
|
+
/**
|
|
84
|
+
* Emit for this variant even though its `riskLevel` is below the automatic floor.
|
|
85
|
+
*
|
|
86
|
+
* For a `MEDIUM` / `LOW` verb whose danger is not proportional to its blast radius — the risk
|
|
87
|
+
* level answers "how alarming is the UI affordance", which is a related but not identical
|
|
88
|
+
* question to "is this evidence an auditor needs".
|
|
89
|
+
*/
|
|
90
|
+
auditBelowRiskFloor?: boolean;
|
|
91
|
+
/**
|
|
92
|
+
* Top-level request string carrying the operator's justification, e.g. `reasonField: 'reason'`.
|
|
93
|
+
* Captured before custom input transformations and recorded as `eventData.reason` after commit.
|
|
94
|
+
* This explicitly authorizes retaining that text in audit destinations; do not select a secret
|
|
95
|
+
* or an unrestricted business-data field. Bound the text in the request DTO and tell callers
|
|
96
|
+
* to supply an operational justification. Other request values are never copied by this option.
|
|
97
|
+
* This does not change the risk floor: below-floor writes still need `auditBelowRiskFloor`.
|
|
98
|
+
* OVERRIDE_ALL implementations own their persistence and must emit their committed audit event.
|
|
99
|
+
*/
|
|
100
|
+
reasonField?: string;
|
|
101
|
+
};
|
|
102
|
+
|
|
103
|
+
/*
|
|
104
|
+
* Three consequences of the risk-driven floor an author has to design around.
|
|
105
|
+
*
|
|
106
|
+
* - **A high-risk READ leaves no operation-level row here.** The exclusion is deliberate and is
|
|
107
|
+
* guarded by a test rather than merely noted: the event asserts an EFFECT, and a read had none.
|
|
108
|
+
* Neither risk nor `auditBelowRiskFloor` overrides this exclusion. `.isAuditEvidence()` selects
|
|
109
|
+
* write-evidence values; it does not trigger read auditing. One-time response disclosure is a
|
|
110
|
+
* separate controller mechanism for backend-only fields returned at creation and ephemeral
|
|
111
|
+
* response fields. Ordinary business reads needing evidence require an appropriate explicit
|
|
112
|
+
* audit event at their owning service, not a misleading field marker.
|
|
113
|
+
* - **A bulk write records submitted field NAMES without prior values.** The before-image is fetched
|
|
114
|
+
* only when exactly one row is selected, so a bulk update cannot tell a reviewer what a field
|
|
115
|
+
* used to hold.
|
|
116
|
+
* - **There is no suppression, and the second row is not a duplicate.** An operation with its own
|
|
117
|
+
* purpose-built event emits BOTH. The generic row carries the operation identity, the cascade
|
|
118
|
+
* correlation, the actor's roles as they stood and the execution type — and no purpose-built
|
|
119
|
+
* event carries any of those, so the two state different facts about one action.
|
|
120
|
+
*
|
|
121
|
+
* Note `riskLevel` drives audit emission and the interface's danger affordances, and drives NO
|
|
122
|
+
* authorization decision — re-authentication is `requiresStepUpAuthentication`, declared separately.
|
|
123
|
+
*/
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
|
|
127
|
+
## Membership authority has specialized evidence too
|
|
128
|
+
|
|
129
|
+
Use the framework membership and unit-assignment operations rather than direct storage writes. Organization role-change events preserve previous, requested and resulting role sets; unit assignments carry one role, not a role array. Direct removals preserve revoked authority and membership status before deletion. Cascade removal is explained by parent evidence rather than one invented child revocation per assignment.
|
|
130
|
+
|
|
131
|
+
The actor is the audit subject; the affected member/user and organization are explicit event data. Specialized role changes are emitted after durability, deferring to an outer transaction's post-commit lane; rolled-back changes must not claim successful grants. An unchanged role set produces no specialized role-change event. Customer routing uses authenticated context, so system provisioning can reach the shared store without customer-specific routing.
|
|
132
|
+
|
|
133
|
+
Named ownership repair uses `RESOURCE_OPERATION_PERFORMED`, not the ordinary UPDATE specialized hook. Custom hooks resolve exact operation identity even when persistence is UPDATE-like. Query both families when reviewing authority: the automatic event uses operation identity and marked `fieldEvidence`, not the specialized `requestedRoles` payload. Generic operation evidence can exist alongside specialized evidence. Delivery remains observable and best effort, not atomic with the business transaction.
|
|
@@ -0,0 +1,141 @@
|
|
|
1
|
+
# Framework Operation Idempotency-Key API
|
|
2
|
+
|
|
3
|
+
This file exposes `idempotencyKey` — the per-operation-variant declaration that an operation takes the
|
|
4
|
+
`Idempotency-Key` request header, so a caller's retry receives the first request's outcome instead of running the
|
|
5
|
+
effect a second time.
|
|
6
|
+
|
|
7
|
+
Read it when an operation does something your database cannot roll back: charging or changing a subscription at a
|
|
8
|
+
payment provider, sending a message, writing to a third-party system.
|
|
9
|
+
|
|
10
|
+
## Why a retry is the danger
|
|
11
|
+
|
|
12
|
+
A response can be lost after the effect happened — a timeout, a dropped connection, a proxy restart. The caller cannot
|
|
13
|
+
tell "it did not happen" from "it happened and I never heard", so it retries. The framework's own HTTP client already
|
|
14
|
+
retries automatically on 5xx, 408, 429 and network loss. Without a key, that retry is a second charge.
|
|
15
|
+
|
|
16
|
+
## Declaring it
|
|
17
|
+
|
|
18
|
+
```ts
|
|
19
|
+
{ variantType: ResourceOperationVariantType.API_CALL, idempotencyKey: ResourceOperationIdempotencyKeyRequirement.REQUIRED, roles: [...] }
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
| value | a request without the header | use when |
|
|
23
|
+
|---|---|---|
|
|
24
|
+
| `ACCEPTED` | runs, unkeyed (its retries are not deduplicated) | repeating the effect converges: cancelling twice leaves it cancelled |
|
|
25
|
+
| `REQUIRED` | refused, 400 `idempotency_key_required` | repeating the effect is a second, different effect: adding an item twice adds two |
|
|
26
|
+
|
|
27
|
+
Declare it on a mutation. A read-shaped variant (a read, list, search or count, or a custom operation borrowing one of
|
|
28
|
+
those verbs) that declares it stops the application from starting: a read-shaped variant claims that repeating it
|
|
29
|
+
changes nothing, so the key would protect no retry, and `REQUIRED` would only refuse harmless repeats. A custom operation
|
|
30
|
+
whose effect must not run twice is not a read — borrow a mutation verb in `resourceOperationLike` and declare the key there.
|
|
31
|
+
|
|
32
|
+
## Who must send it
|
|
33
|
+
|
|
34
|
+
`REQUIRED` binds every externally initiated request: a signed-in user, an organization or application machine credential
|
|
35
|
+
(API key or OAuth client credentials), a consumable-token link, a public or anonymous request. A machine client retries
|
|
36
|
+
exactly like a browser does, so it is bound exactly like one. Engine code calling the operation internally, a provider
|
|
37
|
+
webhook, a queued worker and a nested sub-call are exempt: none of them has a client retry to deduplicate.
|
|
38
|
+
|
|
39
|
+
Two planes need a decision before a `REQUIRED` operation reaches them:
|
|
40
|
+
|
|
41
|
+
- **MCP tools.** `tools/call` carries no key, so an operation that is both `REQUIRED` and `mcp.exposed` would be listed
|
|
42
|
+
and refused on every call. The application refuses to start in that state. Keep the operation off MCP, or declare
|
|
43
|
+
`ACCEPTED` when a keyless retry is genuinely safe.
|
|
44
|
+
- **Agent function tools.** A tool you author that dispatches a `REQUIRED` operation passes a key as
|
|
45
|
+
`options: { idempotencyKey }` to `dispatchResourceOperationAsTool`, and reuses that key when it retries. Know what that
|
|
46
|
+
covers: a tool mints its key inside one execution, so the key deduplicates the retries the tool makes itself — not the
|
|
47
|
+
model calling the tool again after a failure, which is a new execution and therefore a new request. If a repeated model
|
|
48
|
+
call must not repeat the effect, derive the key from something stable in the tool's own arguments instead.
|
|
49
|
+
- **The built-in resource write tool** dispatches a resource's default create or update and carries no key, so it refuses
|
|
50
|
+
to target a `REQUIRED` operation rather than offering the model a tool that fails on every call. Author a dedicated tool
|
|
51
|
+
for that operation.
|
|
52
|
+
|
|
53
|
+
## What the framework does, and what it leaves to you
|
|
54
|
+
|
|
55
|
+
The framework does the transport half:
|
|
56
|
+
|
|
57
|
+
- parses the header (a quoted String of 1 to 200 printable ASCII characters, or a bare token), refusing anything else
|
|
58
|
+
with 400 `idempotency_key_malformed`;
|
|
59
|
+
- refuses the header on a MUTATION that does NOT declare it, with 400 `idempotency_key_not_accepted` — silently ignoring
|
|
60
|
+
it would let a caller believe a retry is safe when it is not. A read ignores an undeclared key: repeating a read is
|
|
61
|
+
harmless, and a client that sends the header on every request keeps working;
|
|
62
|
+
- documents the header and those 400s in the OpenAPI reference;
|
|
63
|
+
- makes its own frontend client send one key per call and reuse it on its automatic retries;
|
|
64
|
+
- hands the key to your implementation as `utils.requestIdempotencyKey`, and removes it from the options every later phase
|
|
65
|
+
sees. Forwarding `utils.serviceOptions` into another operation therefore never hands that operation your caller's key,
|
|
66
|
+
whatever context the nested call runs in — a child reusing its parent's key would collide with it;
|
|
67
|
+
- refuses a key sent to a variant whose runtime mode is not `INLINE`: queued and background execution cannot carry it to
|
|
68
|
+
your implementation, so accepting it would promise a protection nothing delivers.
|
|
69
|
+
|
|
70
|
+
Your implementation does the other half, because only it knows what "the same request" and "its outcome" mean:
|
|
71
|
+
|
|
72
|
+
- remember that a key was used, durably, in the same transaction as the effect's local write;
|
|
73
|
+
- on a repeat of the same request, answer the recorded outcome without running the effect again;
|
|
74
|
+
- on the same key with a DIFFERENT request, refuse with 422 using `ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`
|
|
75
|
+
(a 422 strips error context on the wire, so the reference is the signal a client can branch on);
|
|
76
|
+
- while the first request is still running, refuse the repeat with 409 rather than running it concurrently.
|
|
77
|
+
|
|
78
|
+
One concurrency trap is worth naming, because it passes every sequential test. If you check "has this key's request
|
|
79
|
+
already started?" against one read of your state and then record the new request against a LATER read, two concurrent
|
|
80
|
+
requests with the same key can both pass the check: the second records itself after the first finished, and runs the
|
|
81
|
+
effect again. Record the request only against the exact state you checked (a compare-and-swap on it), and when that
|
|
82
|
+
fails, repeat the check once from a fresh read — the first request's recorded outcome or in-flight marker is then there
|
|
83
|
+
to answer it.
|
|
84
|
+
|
|
85
|
+
Declaring the variant without doing that half ships a header nothing deduplicates.
|
|
86
|
+
|
|
87
|
+
## Operation Idempotency Key
|
|
88
|
+
|
|
89
|
+
## Import Origins
|
|
90
|
+
|
|
91
|
+
- `@wildo-ai/saas-models`
|
|
92
|
+
|
|
93
|
+
## Source Excerpts
|
|
94
|
+
|
|
95
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
96
|
+
|
|
97
|
+
```typescript
|
|
98
|
+
*
|
|
99
|
+
* Whether this variant takes the `Idempotency-Key` request header, so a caller's retry receives the first request's
|
|
100
|
+
* outcome instead of running the effect again.
|
|
101
|
+
*
|
|
102
|
+
* Declare it on a mutation whose effect happens OUTSIDE your database — a payment provider, an email, a third-party
|
|
103
|
+
* write — where a retry after a lost response is the duplicate you cannot roll back. A pure database write already
|
|
104
|
+
* gets optimistic locking from `If-Match`; this is for what a transaction cannot undo.
|
|
105
|
+
*
|
|
106
|
+
* - `ACCEPTED`: the header is honored when sent, and a request without it runs unkeyed. Right for an effect that
|
|
107
|
+
* converges when repeated (cancelling something twice leaves it cancelled).
|
|
108
|
+
* - `REQUIRED`: a request without the header is refused with 400 (`idempotency_key_required`). Right for an effect
|
|
109
|
+
* whose repeat is a second, different effect (adding an item twice adds two).
|
|
110
|
+
*
|
|
111
|
+
* What the framework does for you: parses and bounds the header (a quoted String or a bare token of 1 to 200 printable
|
|
112
|
+
* ASCII characters, otherwise 400 `idempotency_key_malformed`); refuses the header on a MUTATION that does not declare
|
|
113
|
+
* this (400 `idempotency_key_not_accepted` — ignoring it would silently leave the caller's retry undeduplicated), while a
|
|
114
|
+
* read ignores it; documents the header in the OpenAPI reference; makes the framework's own HTTP client send one key per
|
|
115
|
+
* call and reuse it on its automatic retries; and hands the key to your implementation as `utils.requestIdempotencyKey`,
|
|
116
|
+
* removing it from the options so that forwarding `utils.serviceOptions` to another operation never passes your caller's
|
|
117
|
+
* key along.
|
|
118
|
+
*
|
|
119
|
+
* Honored on the `INLINE` runtime mode only: a key sent to a queued or background variant is refused, because those
|
|
120
|
+
* paths cannot carry it to the implementation.
|
|
121
|
+
*
|
|
122
|
+
* Mutations only: a read-shaped variant (a read, list, search or count, or a custom operation borrowing one of those
|
|
123
|
+
* verbs) that declares it stops the application from starting. A read-shaped variant claims that repeating it changes
|
|
124
|
+
* nothing, so the key would protect no retry and `REQUIRED` would only refuse harmless repeats. A custom operation whose
|
|
125
|
+
* effect must not run twice is not a read: borrow a mutation verb in `resourceOperationLike` and declare the key there.
|
|
126
|
+
*
|
|
127
|
+
* What it does NOT do: remember outcomes. Deciding that a key was seen, replaying its result and refusing the same key
|
|
128
|
+
* sent with a different request (422, `ErrorCustomMessageReference.IDEMPOTENCY_KEY_REUSED`) is the implementation's
|
|
129
|
+
* job, because only it knows what "the same request" and "its result" mean for its effect.
|
|
130
|
+
*
|
|
131
|
+
* @example a provider-backed mutation that must not run twice
|
|
132
|
+
* variants: [{
|
|
133
|
+
* variantType: ResourceOperationVariantType.API_CALL,
|
|
134
|
+
* roles: [CORE_ORG_ROLES.ORG_OWNER],
|
|
135
|
+
* riskLevel: ResourceOperationRiskLevel.HIGH,
|
|
136
|
+
* idempotencyKey: ResourceOperationIdempotencyKeyRequirement.REQUIRED,
|
|
137
|
+
* requestDto: AddSeatRequest_Schema,
|
|
138
|
+
* }]
|
|
139
|
+
*/
|
|
140
|
+
idempotencyKey?: ResourceOperationIdempotencyKeyRequirement;
|
|
141
|
+
```
|
package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-step-up-api.md
ADDED
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
# Framework Operation Step-Up API
|
|
2
|
+
|
|
3
|
+
This file exposes `requiresStepUpAuthentication` — the per-operation-variant flag that demands a
|
|
4
|
+
FRESH proof of identity before the operation runs.
|
|
5
|
+
|
|
6
|
+
Read it when an operation does something irreversible, destructive, or credential-bearing:
|
|
7
|
+
deleting a tenant, deleting a user, rotating a secret, marking an account for teardown.
|
|
8
|
+
|
|
9
|
+
## What declaring it costs you: one line
|
|
10
|
+
|
|
11
|
+
Set it on the variant. The caller must then present a single-use re-authentication token, or the
|
|
12
|
+
request is refused with `STEP_UP_REQUIRED` (HTTP 403). The framework's own HTTP client catches that
|
|
13
|
+
refusal, runs the registered step-up handler, and replays the request — so on the frontend there is
|
|
14
|
+
nothing to write.
|
|
15
|
+
|
|
16
|
+
```ts
|
|
17
|
+
{ variantType: ResourceOperationVariantType.API_CALL, requiresStepUpAuthentication: true, roles: [...] }
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## Three things that decide whether it will actually fire
|
|
21
|
+
|
|
22
|
+
**It is PER-VARIANT, and that is deliberate.** An operation with a tenant-administrator variant and a
|
|
23
|
+
platform-administrator variant declares it twice. Destroying somebody else's tenant is not a lesser
|
|
24
|
+
act than destroying your own, so neither variant inherits the other's answer.
|
|
25
|
+
|
|
26
|
+
**It is unconditional, and independent of the user type's freshness policy.** The baseline
|
|
27
|
+
`stepUpAuth` policy is opt-in and age-based; an application that never configures it is never
|
|
28
|
+
challenged for anything. This flag challenges regardless — which is the point, because a caller who
|
|
29
|
+
signed in two minutes ago would otherwise destroy the resource with no proof at all.
|
|
30
|
+
|
|
31
|
+
**It is NOT derived from `riskLevel`.** That was considered and rejected: `riskLevel` drives
|
|
32
|
+
interface placement and confirmation prompts and is read by no authorization code, so promoting it
|
|
33
|
+
would have silently turned every existing `CRITICAL` operation into a challenged one.
|
|
34
|
+
|
|
35
|
+
## Where it is inert, and where it locks people out
|
|
36
|
+
|
|
37
|
+
| situation | what happens |
|
|
38
|
+
|---|---|
|
|
39
|
+
| a read-shaped operation (`READ` / `LIST` / `SEARCH` / `COUNT`) | **skipped — the flag enforces nothing.** Use `roles` to restrict who may read |
|
|
40
|
+
| machine principals, internal calls, worker executions, sub-calls | exempt: there is no interactive credential to re-present |
|
|
41
|
+
| a principal holding none of password / TOTP / passkey | refused, fail-closed |
|
|
42
|
+
|
|
43
|
+
Check the last row before declaring the flag. Re-authentication supports password, TOTP and passkey
|
|
44
|
+
proofs, subject to the effective policy. A person who signs in through SSO can satisfy this gate only
|
|
45
|
+
if they also hold an accepted local factor. A genuinely SSO-only account cannot satisfy it through
|
|
46
|
+
an upstream SSO session alone. Passkey-only accounts need their passkey accepted by the effective
|
|
47
|
+
policy. Check effective `stepUpAuth.methods` when step-up is enabled, including organization overrides;
|
|
48
|
+
login-method availability is a separate decision.
|
|
49
|
+
|
|
50
|
+
## Operation Step-Up
|
|
51
|
+
|
|
52
|
+
## Import Origins
|
|
53
|
+
|
|
54
|
+
- `@wildo-ai/saas-models`
|
|
55
|
+
|
|
56
|
+
## Source Excerpts
|
|
57
|
+
|
|
58
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
59
|
+
|
|
60
|
+
```typescript
|
|
61
|
+
*
|
|
62
|
+
* Demand a FRESH proof of identity for this specific operation, regardless of how recently the
|
|
63
|
+
* caller authenticated.
|
|
64
|
+
*
|
|
65
|
+
* The framework's baseline step-up is a per-USER-TYPE policy (`UserTypeAuthPolicy.stepUpAuth`):
|
|
66
|
+
* opt-in, defaulting to `enabled: false`, and *freshness*-based — it challenges only once the
|
|
67
|
+
* session's `lastAuthenticatedAt` is older than `maxAgeSeconds` (default 300). That is the right
|
|
68
|
+
* shape for "this tenant wants periodic re-proof across the board", and the wrong shape for a
|
|
69
|
+
* single irreversible action: a caller who signed in two minutes ago destroys the resource with
|
|
70
|
+
* no credential proof at all, and an application that never configures `stepUpAuth` is never
|
|
71
|
+
* challenged for anything.
|
|
72
|
+
*
|
|
73
|
+
* Setting this to `true` makes the challenge UNCONDITIONAL for this operation. The caller must
|
|
74
|
+
* present a valid single-use `REAUTH` consumable token (minted by `POST /auth/reauth`, carried in
|
|
75
|
+
* `X-Reauth-Token`); otherwise the request is refused with `STEP_UP_REQUIRED` (HTTP 403). The
|
|
76
|
+
* frontend HTTP client already completes this loop — it catches the 403, runs the registered
|
|
77
|
+
* step-up handler to obtain a token, and replays the request — so declaring the flag is the whole
|
|
78
|
+
* integration.
|
|
79
|
+
*
|
|
80
|
+
* FAIL-CLOSED by design: an operation that declares this is challenged even when the user type
|
|
81
|
+
* has NO `stepUpAuth` policy at all. Deriving the requirement from `riskLevel` was rejected —
|
|
82
|
+
* `riskLevel` is a UI/observability signal (danger-zone placement, typed confirmation, MCP
|
|
83
|
+
* destructive hints), read today by no authorization code, and silently promoting it to a security
|
|
84
|
+
* control would change the behaviour of every existing `CRITICAL` operation at once.
|
|
85
|
+
*
|
|
86
|
+
* Applies only to principals whose identity can be re-proved: user requests that are not
|
|
87
|
+
* sub-calls. Machine principals, internal calls and worker executions are exempt exactly as they
|
|
88
|
+
* are for the baseline policy — there is no interactive credential to re-present.
|
|
89
|
+
*
|
|
90
|
+
* ⚠️ **Check who can actually satisfy it before declaring it.**
|
|
91
|
+
* `AuthMethodManagementBackendService.reAuthenticate` accepts THREE factors — `PASSWORD`, `TOTP`
|
|
92
|
+
* (a code or a backup code, through the same anti-replay authority login uses) and `PASSKEY` (a
|
|
93
|
+
* WebAuthn assertion produced under {@link PasskeyAuthenticationCeremony.STEP_UP}, which pins user
|
|
94
|
+
* verification to REQUIRED and uses a challenge key a login assertion cannot redeem). A principal
|
|
95
|
+
* satisfies this gate only by proving an enrolled factor accepted by the effective policy.
|
|
96
|
+
* Holding a credential alone does not mean its method is currently permitted.
|
|
97
|
+
*
|
|
98
|
+
* A person who signs in through SSO can use an accepted local factor; a genuinely SSO-only
|
|
99
|
+
* account without one cannot satisfy this gate with its upstream SSO session. Passkey-only
|
|
100
|
+
* accounts can satisfy it when their passkey remains accepted by the effective policy.
|
|
101
|
+
*
|
|
102
|
+
* - **directory-managed (SCIM) users** in particular. The framework deliberately destroys their
|
|
103
|
+
* `passwordHash` AND passkeys as a compliance control
|
|
104
|
+
* (`_reconcileLocalCredentialsForDirectoryManaged` — a local first factor would survive IdP
|
|
105
|
+
* deprovisioning) and deliberately PRESERVES their TOTP, which sits on top of the IdP first
|
|
106
|
+
* factor. TOTP re-auth is what makes that preserved factor usable, and it is why an ORG_ADMIN
|
|
107
|
+
* of a directory-managed tenant can start a teardown when enrolled TOTP is accepted by policy.
|
|
108
|
+
*
|
|
109
|
+
* A principal holding NONE of the three still cannot satisfy the gate, and is still refused
|
|
110
|
+
* fail-closed with a diagnosable message. Check the effective `stepUpAuth` policy, including
|
|
111
|
+
* organization overrides and its accepted `methods` when enabled, before declaring this flag
|
|
112
|
+
* on an operation that population must perform. Login-method availability is a separate decision.
|
|
113
|
+
*
|
|
114
|
+
* This is also why the requirement is a per-operation flag rather than a hardcoded `password`
|
|
115
|
+
* field in a request DTO: the proof is negotiated by the auth policy, not frozen into the resource
|
|
116
|
+
* contract. A `{ password }` field cannot adapt to any of the above.
|
|
117
|
+
*
|
|
118
|
+
* assurance-control: WILDO.IDENTITY.STEP_UP_AUTHENTICATION — re-authentication before a high-impact action.
|
|
119
|
+
*
|
|
120
|
+
* ⚠️ **Read-shaped operations are SKIPPED, so the flag is inert on them.** `READ`, `LIST`,
|
|
121
|
+
* `SEARCH` and `COUNT` never reach the gate — declaring it there configures cleanly and enforces
|
|
122
|
+
* nothing. Step-up guards an ACT, not a look; to restrict who may read, use the operation's
|
|
123
|
+
* `roles`.
|
|
124
|
+
*/
|
|
125
|
+
requiresStepUpAuthentication?: boolean;
|
|
126
|
+
```
|