@wildo-ai/framework-knowledge 1.1.5 → 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/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- 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/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -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 +320 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- 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 +0 -3
- 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 +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- 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 +55 -10
- 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 +1 -1
- 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 +1 -6
- 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 +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
- 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 +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- 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 +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
- 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 +10 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +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.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- 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/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +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.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- 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.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- 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 +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
- 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 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- 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/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- 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/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- 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/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- 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/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- 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 +11 -0
- 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 +7 -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.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 +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- 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 +14 -30
- 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.module.companion-exports.full.md +8 -13
- 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 +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -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 +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -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 +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- 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.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/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -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 +21 -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 +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- 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 +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- 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 +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- 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 +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- 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 +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -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 +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -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.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- 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-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- 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.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- 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 +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- 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 +667 -6
- 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.http-api-binding.md +812 -29
- 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.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 +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -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.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.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.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 +34 -0
- 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 +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -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 +242 -7
- 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 +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- 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 +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -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 +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -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 +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- 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 +10 -10
- 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 +5 -2
- 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 +23 -4
- 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/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1238 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3191 -1126
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- 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 +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- 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 +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- 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-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- 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 +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- 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 +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -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 +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- 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 +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -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 +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -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 +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- 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 +32 -1
- 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 +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- 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-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- 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 +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- 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 +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- 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 +272 -33
- 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-package-allow-list-api.md +111 -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 +132 -23
- 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 +29 -0
- 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 +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -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 +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -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 +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- 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 +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- 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 +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- 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 +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- 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 +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- 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 +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- 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 +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- 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 +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -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 +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -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 +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -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 +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- 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 +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -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 +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- 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 +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- 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 +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5887 -1695
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# saas.models.privacy.statutory-retention-ground
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* **WHY the law lets a row survive an erasure** — the exemption a `retentionPolicy.statutoryRetention`
|
|
14
|
+
* declaration names (#1635).
|
|
15
|
+
*
|
|
16
|
+
* A data subject's right to erasure (GDPR Art. 17(1)) does not apply "to the extent that processing is
|
|
17
|
+
* necessary … for compliance with a legal obligation which requires processing by Union or Member State
|
|
18
|
+
* law to which the controller is subject" (Art. 17(3)(b)). Business correspondence and accounting source
|
|
19
|
+
* documents carry exactly such an obligation — HGB §257 and AO §147 in Germany, Code de commerce L123-22 in
|
|
20
|
+
* France — so a subject erasure keeps those rows until the statutory period ends, and RESTRICTS them in the
|
|
21
|
+
* meantime: stored, and processed for nothing else (the Art. 18(2) effect, which BDSG §35(1)/(3) states
|
|
22
|
+
* explicitly as the substitute for erasure).
|
|
23
|
+
*
|
|
24
|
+
* spec-cite: Regulation (EU) 2016/679, Art. 17(3) introductory sentence, (b) and (e), fetched from
|
|
25
|
+
* gdpr-info.eu/art-17-gdpr 2026-09-27; Art. 18(2) and BDSG §35(1)/(3) as fetched and quoted in #1635.
|
|
26
|
+
*
|
|
27
|
+
* ## One member, on purpose
|
|
28
|
+
*
|
|
29
|
+
* Art. 17(3)(e) — "for the establishment, exercise or defence of legal claims" — is the other ground an
|
|
30
|
+
* operator reaches for, and it is deliberately NOT a member. It is a property of a CASE, decided when a claim
|
|
31
|
+
* arises and lifted when it ends: that is a legal hold (#1634), not a property of every row of a class. A
|
|
32
|
+
* member here would let a resource declare every row permanently "needed for legal claims", which is the
|
|
33
|
+
* standing retention the storage-limitation principle forbids. The remaining grounds of Art. 17(3) (freedom
|
|
34
|
+
* of expression, public health, archiving in the public interest) have no Wildo mechanism behind them; a
|
|
35
|
+
* member without one would be a claim nothing enforces.
|
|
36
|
+
*
|
|
37
|
+
* `z.enum` rather than a literal so a member added later reaches every consumer through this one source.
|
|
38
|
+
*/
|
|
39
|
+
export enum StatutoryRetentionGround {
|
|
40
|
+
/** GDPR Art. 17(3)(b): the rows are kept because a statute requires the controller to keep them. */
|
|
41
|
+
LEGAL_OBLIGATION = 'legal_obligation',
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Zod schema for {@link StatutoryRetentionGround}. Explicitly annotated for the `isolatedDeclarations`
|
|
46
|
+
* emit constraint.
|
|
47
|
+
*/
|
|
48
|
+
export const StatutoryRetentionGroundSchema: z.ZodEnum<typeof StatutoryRetentionGround> =
|
|
49
|
+
z.enum(StatutoryRetentionGround);
|
|
50
|
+
```
|
|
@@ -0,0 +1,388 @@
|
|
|
1
|
+
# saas.models.privacy.subject-data-recipients
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*/
|
|
13
|
+
import { z } from 'zod';
|
|
14
|
+
// The D6 erasure vocabulary, REUSED rather than restated (#1710). Published from the package root, because the
|
|
15
|
+
// contracts below carry it into the root-exported application configuration and provider compliance profile.
|
|
16
|
+
import { HttpApiErasureStance } from '../../http-api-binding/http-api-erasure-stance.shared';
|
|
17
|
+
import { OperatorProcessingRole } from './operator-compliance-identity.shared.schemas';
|
|
18
|
+
import { PersonalDataCategory } from './personal-data-category.shared.schemas';
|
|
19
|
+
import {
|
|
20
|
+
SubjectErasureExternalEffectStatus,
|
|
21
|
+
type SubjectErasureExternalEffectOutcome,
|
|
22
|
+
} from './subject-erasure.shared.schemas';
|
|
23
|
+
|
|
24
|
+
/** Why a recipient's categories are not all derivable (#1709) — the reason travels with the recipient to runtime. */
|
|
25
|
+
export enum RecipientCategoriesNotDerivableReason {
|
|
26
|
+
/** Reached by a typed client, a browser operation or unscanned code: no declared field-to-input map exists. */
|
|
27
|
+
FLOW_UNDECLARED = 'flow-undeclared',
|
|
28
|
+
/** A system-of-record instance that no resource binds or pipes: nothing declares what reaches it. */
|
|
29
|
+
NO_RESOURCE_FLOW = 'no-resource-flow',
|
|
30
|
+
/** The resource flows could not be read (the introspection failed), so nothing is known — which is not "none". */
|
|
31
|
+
FLOWS_NOT_READ = 'flows-not-read',
|
|
32
|
+
/** Some flowing field is personal by the application's own declaration and carries no category. */
|
|
33
|
+
UNCATEGORIZED_PERSONAL_FIELDS = 'uncategorized-personal-fields',
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* WHOSE account reached the recipient — which decides who owes the Art. 19 communication.
|
|
38
|
+
*
|
|
39
|
+
* Not the population class: that also answers "operator-run" and "declared without a data path", neither of which is a
|
|
40
|
+
* recipient. This is the question an erasure asks of a recipient that exists.
|
|
41
|
+
*/
|
|
42
|
+
export enum SubjectDataRecipientReach {
|
|
43
|
+
/** Reached with an application-owned credential: the operator engaged this vendor. */
|
|
44
|
+
OPERATOR_ACCOUNT = 'operator-account',
|
|
45
|
+
/** Reached ONLY through a tenant's or a person's connected account: the tenant's own vendor (#1707). */
|
|
46
|
+
TENANT_ACCOUNT = 'tenant-account',
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* The stance a VENDOR declares about subject data it keeps (#1710) — on the provider's compliance profile. The D6
|
|
51
|
+
* vocabulary, narrowed to the two stances a vendor fact can take: the third, an acknowledged non-erasure, is the
|
|
52
|
+
* CONTROLLER's act and is declared by the operator ({@link ProviderSubjectErasureAcknowledgementSchema}).
|
|
53
|
+
*/
|
|
54
|
+
export const ProviderSubjectErasureDeclarationSchema = z.strictObject({
|
|
55
|
+
/**
|
|
56
|
+
* - `NO_SUBJECT_DATA`: the vendor keeps nothing about a subject beyond the call itself — erasure reports
|
|
57
|
+
* DECLARED_NO_SUBJECT_DATA, which is complete.
|
|
58
|
+
* - `EXTERNAL_ERASURE_OPERATION`: an erasure effect in the external-effects registry reaches this vendor (the billing
|
|
59
|
+
* effect for a billing provider). If none is registered for it at runtime, erasure reports NOT_REGISTERED.
|
|
60
|
+
*/
|
|
61
|
+
stance: z.enum({
|
|
62
|
+
NO_SUBJECT_DATA: HttpApiErasureStance.NO_SUBJECT_DATA,
|
|
63
|
+
EXTERNAL_ERASURE_OPERATION: HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION,
|
|
64
|
+
}),
|
|
65
|
+
});
|
|
66
|
+
export type ProviderSubjectErasureDeclaration = z.infer<typeof ProviderSubjectErasureDeclarationSchema>;
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* The OPERATOR's acknowledgement that erasure does not reach this vendor (#1710): the D6 stance
|
|
70
|
+
* CONTROLLER_ACKNOWLEDGED_NON_ERASURE for a provider, on `providerComplianceChoices.<ref>`. Erasure then reports
|
|
71
|
+
* ACKNOWLEDGED_NON_ERASURE — still incomplete, because the data is still live at the vendor, however deliberate the
|
|
72
|
+
* decision was.
|
|
73
|
+
*/
|
|
74
|
+
export const ProviderSubjectErasureAcknowledgementSchema = z.strictObject({
|
|
75
|
+
/** Why the operator accepts that erasure does not reach the vendor — "Resend deletes its logs within 90 days". */
|
|
76
|
+
reason: z.string().trim().min(1),
|
|
77
|
+
});
|
|
78
|
+
export type ProviderSubjectErasureAcknowledgement = z.infer<typeof ProviderSubjectErasureAcknowledgementSchema>;
|
|
79
|
+
|
|
80
|
+
/** One recipient, as the running application needs to state it. */
|
|
81
|
+
export const SubjectDataRecipientSchema = z.strictObject({
|
|
82
|
+
/** The provider ref. A system of record is never a recipient here (see the module JSDoc). */
|
|
83
|
+
ref: z.string().trim().min(1),
|
|
84
|
+
/**
|
|
85
|
+
* The legal entity the operator's processor register adopted for it, or `null` when the register has no entry — a
|
|
86
|
+
* gap stated as such, never filled with a suggestion.
|
|
87
|
+
*/
|
|
88
|
+
legalEntityName: z.string().trim().min(1).nullable(),
|
|
89
|
+
/** Where the register says it processes. Empty when there is no register entry. */
|
|
90
|
+
processingRegions: z.array(z.string().trim().min(1)),
|
|
91
|
+
reach: z.enum(SubjectDataRecipientReach),
|
|
92
|
+
/** The categories its declared flows carry to it (#1709), in enum order. */
|
|
93
|
+
categories: z.array(z.enum(PersonalDataCategory)),
|
|
94
|
+
/** Every reason those categories are not all known. Empty when the declared flows account for everything. */
|
|
95
|
+
categoriesNotDerivable: z.array(z.enum(RecipientCategoriesNotDerivableReason)),
|
|
96
|
+
/** True when the categories include free text a person wrote, which can carry any other category. */
|
|
97
|
+
categoriesAreAFloor: z.boolean(),
|
|
98
|
+
/** The declared flows the categories come from — `capability:EMAIL_TRANSACTIONAL`, … */
|
|
99
|
+
derivedFrom: z.array(z.string().trim().min(1)),
|
|
100
|
+
/**
|
|
101
|
+
* The erasure stance: the vendor's declaration, or the operator's acknowledged non-erasure. `null` when neither
|
|
102
|
+
* exists — erasure then reports UNMEASURED for this recipient.
|
|
103
|
+
*/
|
|
104
|
+
erasureStance: z.enum(HttpApiErasureStance).nullable(),
|
|
105
|
+
});
|
|
106
|
+
export type SubjectDataRecipient = z.infer<typeof SubjectDataRecipientSchema>;
|
|
107
|
+
|
|
108
|
+
/** Which resource types one operator role covers, from `operatorComplianceIdentity.roleAllocations[].resourceTypes`. */
|
|
109
|
+
export const SubjectDataRoleAllocationSchema = z.strictObject({
|
|
110
|
+
role: z.enum(OperatorProcessingRole),
|
|
111
|
+
resourceTypes: z.array(z.string().trim().min(1)).min(1),
|
|
112
|
+
});
|
|
113
|
+
export type SubjectDataRoleAllocation = z.infer<typeof SubjectDataRoleAllocationSchema>;
|
|
114
|
+
|
|
115
|
+
/** The derived projection `compliance.subjectDataRecipients` carries. */
|
|
116
|
+
export const SubjectDataRecipientsDeclarationSchema = z.strictObject({
|
|
117
|
+
recipients: z.array(SubjectDataRecipientSchema),
|
|
118
|
+
/** The role allocations that name their resource types. An allocation in prose only is not carried. */
|
|
119
|
+
roleAllocations: z.array(SubjectDataRoleAllocationSchema),
|
|
120
|
+
});
|
|
121
|
+
export type SubjectDataRecipientsDeclaration = z.infer<typeof SubjectDataRecipientsDeclarationSchema>;
|
|
122
|
+
|
|
123
|
+
/** Whether the running application has a recipient declaration at all. */
|
|
124
|
+
export enum SubjectDataRecipientsStatementStatus {
|
|
125
|
+
/** The projection is composed; the list below is the derived answer (possibly empty). */
|
|
126
|
+
DECLARED = 'declared',
|
|
127
|
+
/** No projection: the application has not stated who received personal data. A gap, marked. */
|
|
128
|
+
NOT_DECLARED = 'not-declared',
|
|
129
|
+
/**
|
|
130
|
+
* A declaration may exist, but applying it to this request FAILED (the erasure's post-commit accounting threw), so
|
|
131
|
+
* which recipients hold this subject's data is unknown. Distinct from NOT_DECLARED, whose remedy is to generate the
|
|
132
|
+
* projection; this one's is to reconcile the vendors by hand and look at the logged error.
|
|
133
|
+
*/
|
|
134
|
+
UNDETERMINED = 'undetermined',
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/** Why one recipient is listed for this subject. */
|
|
138
|
+
export enum SubjectDataRecipientRelevance {
|
|
139
|
+
/** Its derived categories meet this subject's data, or its flow names one of the involved resources. */
|
|
140
|
+
CARRIES_SUBJECT_DATA = 'carries-subject-data',
|
|
141
|
+
/** Its categories are not all derivable, or are a floor: it may have received this subject's data. */
|
|
142
|
+
MAY_HAVE_RECEIVED = 'may-have-received',
|
|
143
|
+
}
|
|
144
|
+
|
|
145
|
+
/**
|
|
146
|
+
* Who owes what to this recipient when the subject's data is erased — the role split (#1710).
|
|
147
|
+
*
|
|
148
|
+
* A processor "assists the controller … for the fulfilment of the controller's obligation to respond to requests for
|
|
149
|
+
* exercising the data subject's rights" (Art. 28(3)(e)); the Art. 19 communication is the controller's.
|
|
150
|
+
* spec-cite: GDPR Art. 28(3)(e), https://gdpr-info.eu/art-28-gdpr/ (fetched 2026-09-29)
|
|
151
|
+
*/
|
|
152
|
+
export enum SubjectDataRecipientObligation {
|
|
153
|
+
/** The operator is CONTROLLER (or joint controller) for this data: it communicates the erasure (Art. 19). */
|
|
154
|
+
OPERATOR_COMMUNICATES = 'operator-communicates',
|
|
155
|
+
/** The operator is PROCESSOR for this data: the outcome is assistance evidence for the tenant, the controller. */
|
|
156
|
+
OPERATOR_ASSISTS_CONTROLLER = 'operator-assists-controller',
|
|
157
|
+
/** Reached with the tenant's own account: the tenant's recipient, and the tenant's to notify. */
|
|
158
|
+
TENANT_NOTIFIES = 'tenant-notifies',
|
|
159
|
+
/** No role allocation names the subject's resource type, so who owes the communication is not declared. */
|
|
160
|
+
ROLE_UNDECLARED = 'role-undeclared',
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
/** One recipient listed for one request. */
|
|
164
|
+
export interface SubjectDataRecipientStatementEntry extends SubjectDataRecipient {
|
|
165
|
+
relevance: SubjectDataRecipientRelevance;
|
|
166
|
+
obligation: SubjectDataRecipientObligation;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/** The recipient part of a subject export or erasure report. Contains no personal data. */
|
|
170
|
+
export interface SubjectDataRecipientsStatement {
|
|
171
|
+
status: SubjectDataRecipientsStatementStatus;
|
|
172
|
+
/** The operator's role for the subject's resource type, or `null` when no allocation names it. */
|
|
173
|
+
operatorRole: OperatorProcessingRole | null;
|
|
174
|
+
recipients: SubjectDataRecipientStatementEntry[];
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
/** The operator role an allocation declares for a resource type, or `null` when none names it. */
|
|
178
|
+
export function operatorRoleForResourceType(
|
|
179
|
+
declaration: SubjectDataRecipientsDeclaration | undefined,
|
|
180
|
+
resourceType: string,
|
|
181
|
+
): OperatorProcessingRole | null {
|
|
182
|
+
return declaration?.roleAllocations.find((allocation) => allocation.resourceTypes.includes(resourceType))?.role ?? null;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
function obligationOf(reach: SubjectDataRecipientReach, role: OperatorProcessingRole | null): SubjectDataRecipientObligation {
|
|
186
|
+
if (reach === SubjectDataRecipientReach.TENANT_ACCOUNT) return SubjectDataRecipientObligation.TENANT_NOTIFIES;
|
|
187
|
+
switch (role) {
|
|
188
|
+
case OperatorProcessingRole.CONTROLLER:
|
|
189
|
+
case OperatorProcessingRole.JOINT_CONTROLLER:
|
|
190
|
+
return SubjectDataRecipientObligation.OPERATOR_COMMUNICATES;
|
|
191
|
+
case OperatorProcessingRole.PROCESSOR:
|
|
192
|
+
return SubjectDataRecipientObligation.OPERATOR_ASSISTS_CONTROLLER;
|
|
193
|
+
case null:
|
|
194
|
+
return SubjectDataRecipientObligation.ROLE_UNDECLARED;
|
|
195
|
+
default: {
|
|
196
|
+
const unhandled: never = role;
|
|
197
|
+
throw new Error(`subject data recipients: unhandled operator role ${String(unhandled)}`);
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/**
|
|
203
|
+
* The `derivedFrom` token kind of a flow the ENGINE composes through a capability: `capability:<token>` (#1709), written
|
|
204
|
+
* by `deriveRecipientDisclosures`. The only flow kind this list carries, because systems of record are kept out of it.
|
|
205
|
+
*/
|
|
206
|
+
export const RECIPIENT_CAPABILITY_FLOW_TOKEN_KIND = 'capability';
|
|
207
|
+
|
|
208
|
+
/**
|
|
209
|
+
* The recipients one subject export or erasure must name — see the module JSDoc for the rule. Pure, so the backend,
|
|
210
|
+
* a test and a reviewer apply the same one.
|
|
211
|
+
*/
|
|
212
|
+
export function selectSubjectDataRecipients(params: {
|
|
213
|
+
declaration: SubjectDataRecipientsDeclaration | undefined;
|
|
214
|
+
subjectResourceType: string;
|
|
215
|
+
/** The union of the `.dataCategories()` those resources declare. */
|
|
216
|
+
involvedCategories: readonly PersonalDataCategory[];
|
|
217
|
+
/**
|
|
218
|
+
* `false` when the involved categories are NOT the whole answer: a resource's configuration could not be read, or it
|
|
219
|
+
* declares personal fields with no category. An unknown on the SUBJECT side must widen the list exactly as an unknown
|
|
220
|
+
* on the recipient side does — every recipient not matched is then kept as MAY_HAVE_RECEIVED, never dropped.
|
|
221
|
+
*/
|
|
222
|
+
involvedCategoriesComplete: boolean;
|
|
223
|
+
/**
|
|
224
|
+
* Whether the subject is an ACCOUNT HOLDER (a user). A capability recipient's categories are what the ENGINE sends
|
|
225
|
+
* when it composes the call — the recipient address of an account's mail, the billing customer, the signed-in actor —
|
|
226
|
+
* which are account holders' data. So a category match through a capability alone says the vendor carries an account
|
|
227
|
+
* holder's data; for any other subject (a CRM contact) it says only that it MAY have received it, because nothing
|
|
228
|
+
* declares that the application routes that subject's data to the capability.
|
|
229
|
+
*/
|
|
230
|
+
subjectIsAccountHolder: boolean;
|
|
231
|
+
}): SubjectDataRecipientsStatement {
|
|
232
|
+
if (params.declaration === undefined) return notDeclaredSubjectDataRecipientsStatement();
|
|
233
|
+
const role = operatorRoleForResourceType(params.declaration, params.subjectResourceType);
|
|
234
|
+
const involvedCategories = new Set(params.involvedCategories);
|
|
235
|
+
const recipients: SubjectDataRecipientStatementEntry[] = [];
|
|
236
|
+
for (const recipient of params.declaration.recipients) {
|
|
237
|
+
const sharesACategory = recipient.categories.some((category) => involvedCategories.has(category));
|
|
238
|
+
const carries = sharesACategory && params.subjectIsAccountHolder;
|
|
239
|
+
const uncertain = sharesACategory
|
|
240
|
+
|| recipient.categoriesNotDerivable.length > 0
|
|
241
|
+
|| recipient.categoriesAreAFloor
|
|
242
|
+
|| !params.involvedCategoriesComplete;
|
|
243
|
+
if (!carries && !uncertain) continue;
|
|
244
|
+
recipients.push({
|
|
245
|
+
...recipient,
|
|
246
|
+
relevance: carries ? SubjectDataRecipientRelevance.CARRIES_SUBJECT_DATA : SubjectDataRecipientRelevance.MAY_HAVE_RECEIVED,
|
|
247
|
+
obligation: obligationOf(recipient.reach, role),
|
|
248
|
+
});
|
|
249
|
+
}
|
|
250
|
+
return { status: SubjectDataRecipientsStatementStatus.DECLARED, operatorRole: role, recipients };
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
/**
|
|
254
|
+
* The statement of an application with no recipient declaration. Also the placeholder an orchestrator writes into a
|
|
255
|
+
* report its caller completes (the erasure and export doors fill the real statement, as they fill `externalEffects`).
|
|
256
|
+
*/
|
|
257
|
+
export function notDeclaredSubjectDataRecipientsStatement(): SubjectDataRecipientsStatement {
|
|
258
|
+
return { status: SubjectDataRecipientsStatementStatus.NOT_DECLARED, operatorRole: null, recipients: [] };
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/** The statement of a request whose recipient accounting failed — see {@link SubjectDataRecipientsStatementStatus.UNDETERMINED}. */
|
|
262
|
+
export function undeterminedSubjectDataRecipientsStatement(): SubjectDataRecipientsStatement {
|
|
263
|
+
return { status: SubjectDataRecipientsStatementStatus.UNDETERMINED, operatorRole: null, recipients: [] };
|
|
264
|
+
}
|
|
265
|
+
|
|
266
|
+
/** The effect ref the recipient reconciliation writes for a recipient no registered effect reached. */
|
|
267
|
+
export function subjectErasureRecipientEffectRef(recipientRef: string): string {
|
|
268
|
+
return `recipient:${recipientRef}`;
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
/** The effect ref of the single outcome an erasure carries when its recipients are not declared or could not be determined. */
|
|
272
|
+
export const SUBJECT_DATA_RECIPIENTS_NOT_DECLARED_EFFECT_REF = 'subject-data-recipients';
|
|
273
|
+
|
|
274
|
+
/** What an erasure did about one recipient. */
|
|
275
|
+
export interface SubjectErasureRecipientOutcome {
|
|
276
|
+
recipientRef: string;
|
|
277
|
+
legalEntityName: string | null;
|
|
278
|
+
reach: SubjectDataRecipientReach;
|
|
279
|
+
relevance: SubjectDataRecipientRelevance;
|
|
280
|
+
obligation: SubjectDataRecipientObligation;
|
|
281
|
+
/**
|
|
282
|
+
* The outcome at this recipient: the covering effects' combined status, or the status the declared stance decides.
|
|
283
|
+
* `null` for a tenant-account recipient — not the operator's erasure to run, and named for the tenant to notify.
|
|
284
|
+
*/
|
|
285
|
+
status: SubjectErasureExternalEffectStatus | null;
|
|
286
|
+
/** The effect refs that reached it — a registered effect, or the reconciliation's `recipient:<ref>`. */
|
|
287
|
+
effectRefs: string[];
|
|
288
|
+
}
|
|
289
|
+
|
|
290
|
+
/**
|
|
291
|
+
* Most-incomplete-wins when several effects reach one recipient: a PARTIAL next to a COMPLETED is still partial.
|
|
292
|
+
* Ordered from the state a reader must act on first to the states that close the question.
|
|
293
|
+
*/
|
|
294
|
+
const STATUS_SEVERITY: readonly SubjectErasureExternalEffectStatus[] = [
|
|
295
|
+
SubjectErasureExternalEffectStatus.PARTIAL,
|
|
296
|
+
SubjectErasureExternalEffectStatus.FAILED,
|
|
297
|
+
SubjectErasureExternalEffectStatus.UNMEASURED,
|
|
298
|
+
SubjectErasureExternalEffectStatus.NOT_REGISTERED,
|
|
299
|
+
SubjectErasureExternalEffectStatus.ACKNOWLEDGED_NON_ERASURE,
|
|
300
|
+
SubjectErasureExternalEffectStatus.COMPLETED,
|
|
301
|
+
SubjectErasureExternalEffectStatus.NOTHING_TO_ERASE,
|
|
302
|
+
SubjectErasureExternalEffectStatus.DECLARED_NO_SUBJECT_DATA,
|
|
303
|
+
];
|
|
304
|
+
|
|
305
|
+
function combinedStatus(statuses: readonly SubjectErasureExternalEffectStatus[]): SubjectErasureExternalEffectStatus {
|
|
306
|
+
return STATUS_SEVERITY.find((status) => statuses.includes(status)) ?? SubjectErasureExternalEffectStatus.UNMEASURED;
|
|
307
|
+
}
|
|
308
|
+
|
|
309
|
+
/**
|
|
310
|
+
* Reconcile the recipients an erasure must reach with the effects that ran (#1710).
|
|
311
|
+
*
|
|
312
|
+
* Every operator-account recipient gets a status, so none can pass silently:
|
|
313
|
+
* - a registered effect that names it as its `recipientRef` → that effect's status;
|
|
314
|
+
* - otherwise its stance decides: NO_SUBJECT_DATA → DECLARED_NO_SUBJECT_DATA (complete); an acknowledged
|
|
315
|
+
* non-erasure → ACKNOWLEDGED_NON_ERASURE; EXTERNAL_ERASURE_OPERATION with no effect registered → NOT_REGISTERED;
|
|
316
|
+
* no stance → UNMEASURED. Each becomes an `externalEffects` outcome under `recipient:<ref>`, so every existing
|
|
317
|
+
* reader of the report (`isIncompleteSubjectErasureExternalEffect`, the Your Application request lane) sees it without
|
|
318
|
+
* learning a new field.
|
|
319
|
+
* - NOT DECLARED adds one UNMEASURED outcome naming the missing projection.
|
|
320
|
+
*
|
|
321
|
+
* It marks and never refuses: the local erasure has already committed when this runs.
|
|
322
|
+
*/
|
|
323
|
+
export function reconcileSubjectErasureRecipients(params: {
|
|
324
|
+
statement: SubjectDataRecipientsStatement;
|
|
325
|
+
effectOutcomes: readonly SubjectErasureExternalEffectOutcome[];
|
|
326
|
+
/** Which recipient each REGISTERED effect reaches — applicable to this subject or not: effect ref → recipient ref. */
|
|
327
|
+
recipientRefByEffectRef: ReadonlyMap<string, string>;
|
|
328
|
+
}): { recipients: SubjectErasureRecipientOutcome[]; addedEffectOutcomes: SubjectErasureExternalEffectOutcome[] } {
|
|
329
|
+
const addedEffectOutcomes: SubjectErasureExternalEffectOutcome[] = [];
|
|
330
|
+
if (params.statement.status !== SubjectDataRecipientsStatementStatus.DECLARED) {
|
|
331
|
+
addedEffectOutcomes.push({
|
|
332
|
+
effectRef: SUBJECT_DATA_RECIPIENTS_NOT_DECLARED_EFFECT_REF,
|
|
333
|
+
status: SubjectErasureExternalEffectStatus.UNMEASURED,
|
|
334
|
+
detail: params.statement.status === SubjectDataRecipientsStatementStatus.NOT_DECLARED
|
|
335
|
+
? 'The application declares no subject-data recipients (compliance.subjectDataRecipients is absent), so which vendors hold this subject\'s data is unknown. Run `wildo config subject-data-recipients` and redeploy.'
|
|
336
|
+
: 'Which recipients hold this subject\'s data could not be determined for this request; reconcile each vendor before treating the erasure as complete.',
|
|
337
|
+
});
|
|
338
|
+
return { recipients: [], addedEffectOutcomes };
|
|
339
|
+
}
|
|
340
|
+
const recipients = params.statement.recipients.map((recipient): SubjectErasureRecipientOutcome => {
|
|
341
|
+
const base = {
|
|
342
|
+
recipientRef: recipient.ref,
|
|
343
|
+
legalEntityName: recipient.legalEntityName,
|
|
344
|
+
reach: recipient.reach,
|
|
345
|
+
relevance: recipient.relevance,
|
|
346
|
+
obligation: recipient.obligation,
|
|
347
|
+
};
|
|
348
|
+
if (recipient.reach === SubjectDataRecipientReach.TENANT_ACCOUNT) return { ...base, status: null, effectRefs: [] };
|
|
349
|
+
const covering = params.effectOutcomes.filter((outcome) => params.recipientRefByEffectRef.get(outcome.effectRef) === recipient.ref);
|
|
350
|
+
if (covering.length > 0) {
|
|
351
|
+
return { ...base, status: combinedStatus(covering.map((outcome) => outcome.status)), effectRefs: covering.map((outcome) => outcome.effectRef) };
|
|
352
|
+
}
|
|
353
|
+
const effectRef = subjectErasureRecipientEffectRef(recipient.ref);
|
|
354
|
+
const registeredForOtherSubjects = [...params.recipientRefByEffectRef.entries()]
|
|
355
|
+
.filter(([, recipientRef]) => recipientRef === recipient.ref).map(([registeredRef]) => registeredRef);
|
|
356
|
+
const decided = registeredForOtherSubjects.length > 0
|
|
357
|
+
// An effect reaches this vendor, but not for this subject's type (the billing effect answers for users). That is
|
|
358
|
+
// no evidence either way about THIS subject's data there, so it is unmeasured — never "not registered", which
|
|
359
|
+
// would say nobody built the door.
|
|
360
|
+
? {
|
|
361
|
+
effectRef,
|
|
362
|
+
status: SubjectErasureExternalEffectStatus.UNMEASURED,
|
|
363
|
+
detail: `${recipient.ref} is reached by the erasure effect(s) ${registeredForOtherSubjects.join(', ')}, which do not apply to this subject's type; whether ${recipient.ref} holds this subject's data is not measured.`,
|
|
364
|
+
}
|
|
365
|
+
: uncoveredRecipientOutcome(recipient, effectRef);
|
|
366
|
+
addedEffectOutcomes.push(decided);
|
|
367
|
+
return { ...base, status: decided.status, effectRefs: [effectRef] };
|
|
368
|
+
});
|
|
369
|
+
return { recipients, addedEffectOutcomes };
|
|
370
|
+
}
|
|
371
|
+
|
|
372
|
+
function uncoveredRecipientOutcome(recipient: SubjectDataRecipientStatementEntry, effectRef: string): SubjectErasureExternalEffectOutcome {
|
|
373
|
+
switch (recipient.erasureStance) {
|
|
374
|
+
case HttpApiErasureStance.NO_SUBJECT_DATA:
|
|
375
|
+
return { effectRef, status: SubjectErasureExternalEffectStatus.DECLARED_NO_SUBJECT_DATA, detail: `${recipient.ref} declares it keeps no subject data beyond the call.` };
|
|
376
|
+
case HttpApiErasureStance.CONTROLLER_ACKNOWLEDGED_NON_ERASURE:
|
|
377
|
+
return { effectRef, status: SubjectErasureExternalEffectStatus.ACKNOWLEDGED_NON_ERASURE, detail: `The operator acknowledged that erasure does not reach ${recipient.ref}; its copy of the subject's data remains until the vendor deletes it.` };
|
|
378
|
+
case HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION:
|
|
379
|
+
return { effectRef, status: SubjectErasureExternalEffectStatus.NOT_REGISTERED, detail: `${recipient.ref} declares an erasure operation, but no erasure effect reaching it is registered in this application.` };
|
|
380
|
+
case null:
|
|
381
|
+
return { effectRef, status: SubjectErasureExternalEffectStatus.UNMEASURED, detail: `${recipient.ref} declares no erasure stance and no effect reaches it, so whether it still holds the subject's data is unknown.` };
|
|
382
|
+
default: {
|
|
383
|
+
const unhandled: never = recipient.erasureStance;
|
|
384
|
+
throw new Error(`subject data recipients: unhandled erasure stance ${String(unhandled)}`);
|
|
385
|
+
}
|
|
386
|
+
}
|
|
387
|
+
}
|
|
388
|
+
```
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
# saas.models.provider-address-lookup-contract
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* What an address lookup hands back for ONE chosen place.
|
|
14
|
+
*
|
|
15
|
+
* `address` is the application's own value: the person chose it, and it is stored exactly as a typed
|
|
16
|
+
* address would be. `placeId` is the VENDOR's key for the place, present only when the component's
|
|
17
|
+
* declared `placeIdRetention` allows one; the framework refuses a selection that carries a place id its
|
|
18
|
+
* component declared it never returns, and never stores one (#561 D3).
|
|
19
|
+
*/
|
|
20
|
+
export interface ProviderAddressLookupSelection {
|
|
21
|
+
readonly address: AddressValue;
|
|
22
|
+
/** The vendor's identifier for the matched place. Opaque, usable for this interaction only, and never stored. */
|
|
23
|
+
readonly placeId?: string;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* The props every `FRONTEND_ADDRESS_LOOKUP` component receives.
|
|
28
|
+
*
|
|
29
|
+
* Deliberately narrow. The component suggests and resolves; the FIELD owns the value, its validation
|
|
30
|
+
* (`z_address()` with its `countriesAllowed`) and its persistence. That split is what lets an address
|
|
31
|
+
* field work with no lookup at all, which is why the capability fills no engine slot.
|
|
32
|
+
*
|
|
33
|
+
* ## The vendor is reached through `suggest` and `retrieve`, never directly (#561 D2)
|
|
34
|
+
*
|
|
35
|
+
* The framework's host binds both to the operations the component's descriptor declares
|
|
36
|
+
* (`addressLookup.suggestOperationId` / `retrieveOperationId`) and runs them through the application
|
|
37
|
+
* backend's provider-operation door. The host also writes the vendor session token into each input when the
|
|
38
|
+
* descriptor names `sessionTokenInput` (#561 D4) — a component never generates, holds or rotates one. Each
|
|
39
|
+
* resolves to the operation's parsed output, and rejects with the door's error (a refusal, a throttle, a
|
|
40
|
+
* vendor timeout); a component reports that through `onError` and the field stays usable by hand.
|
|
41
|
+
*/
|
|
42
|
+
export interface ProviderAddressLookupProps {
|
|
43
|
+
/** The provider's own `ref`. */
|
|
44
|
+
readonly providerRef: string;
|
|
45
|
+
/** The provider's public configuration, already validated against its `publicConfigSchema` when it declares one. */
|
|
46
|
+
readonly publicConfig: Readonly<Record<string, unknown>>;
|
|
47
|
+
/**
|
|
48
|
+
* ISO 3166-1 alpha-2 codes the field accepts (`z_address({ countriesAllowed })`). A component should
|
|
49
|
+
* restrict its suggestions to them; the field still validates whatever comes back.
|
|
50
|
+
*/
|
|
51
|
+
readonly countriesAllowed?: readonly string[];
|
|
52
|
+
/** The field's default country, a hint for ranking suggestions. */
|
|
53
|
+
readonly defaultCountry?: string;
|
|
54
|
+
/** The person's language (BCP 47), so suggestions and the retrieved address are spelled in it where the vendor can. */
|
|
55
|
+
readonly languageCode: string;
|
|
56
|
+
/** True while the field is disabled or read-only: the component offers no search then. */
|
|
57
|
+
readonly disabled: boolean;
|
|
58
|
+
/**
|
|
59
|
+
* The search control's form NAME. The host renders the control's visible label (from the application's
|
|
60
|
+
* labels) for the element whose id is `field-<name>` — the id every engine form control takes — so the
|
|
61
|
+
* component puts that id on its focusable control and invents no label text of its own.
|
|
62
|
+
*/
|
|
63
|
+
readonly name: string;
|
|
64
|
+
/**
|
|
65
|
+
* The vendor's required attribution (#561 D4), from the descriptor's `attributionMark`, or absent when the vendor
|
|
66
|
+
* requires none. `mark` is the vendor's text, verbatim; `accessibleLabel` is a sentence from the application's
|
|
67
|
+
* labels naming it, for assistive technology.
|
|
68
|
+
*
|
|
69
|
+
* The component shows it INSIDE the container that shows its suggestions, whenever suggestions are shown — the
|
|
70
|
+
* placement Google requires ("within the same visual container" as the content). Render it with
|
|
71
|
+
* `ProviderAddressLookupAttribution` (`@wildo-ai/saas-frontend-lib`), which applies the vendor's text rules
|
|
72
|
+
* (untranslated, on one line, in a permitted colour); the framework's own lookup combobox does.
|
|
73
|
+
* spec-cite: https://developers.google.com/maps/documentation/places/web-service/policies — text attribution rules,
|
|
74
|
+
* fetched 2026-09-29.
|
|
75
|
+
*/
|
|
76
|
+
readonly attribution?: ProviderAddressLookupAttributionText;
|
|
77
|
+
/** Run the declared SUGGEST operation with this input. */
|
|
78
|
+
suggest(input: Readonly<Record<string, unknown>>): Promise<unknown>;
|
|
79
|
+
/** Run the declared RETRIEVE operation with this input. Ends the vendor session, whatever it answers. */
|
|
80
|
+
retrieve(input: Readonly<Record<string, unknown>>): Promise<unknown>;
|
|
81
|
+
/** The person chose a place. Called at most once per interaction. */
|
|
82
|
+
onSelect(selection: ProviderAddressLookupSelection): void;
|
|
83
|
+
/** The person dismissed the lookup without choosing. Ends the vendor session. */
|
|
84
|
+
onCancel(): void;
|
|
85
|
+
/**
|
|
86
|
+
* The lookup could not run — the door refused it, the vendor timed out or answered a shape the adapter
|
|
87
|
+
* cannot read. Reported rather than thrown, for the reason the file-picker contract gives: a throw inside
|
|
88
|
+
* a component's own event handler reaches no React error boundary.
|
|
89
|
+
*/
|
|
90
|
+
onError(error: Error): void;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/** A vendor's required attribution, as the host hands it to a lookup component. */
|
|
94
|
+
export interface ProviderAddressLookupAttributionText {
|
|
95
|
+
/** The vendor's own attribution text, never translated or restyled ("Google Maps"). */
|
|
96
|
+
readonly mark: string;
|
|
97
|
+
/** A sentence from the application's labels that names the mark, for assistive technology. */
|
|
98
|
+
readonly accessibleLabel: string;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/** One suggestion, as a person reads it. Vendor text, never derived by the framework. */
|
|
102
|
+
export interface ProviderAddressLookupSuggestion {
|
|
103
|
+
/** The vendor's handle for the suggestion, passed back to `buildRetrieveInput`. Opaque; never stored. */
|
|
104
|
+
readonly id: string;
|
|
105
|
+
/** The line a person recognises the place by (the street address). */
|
|
106
|
+
readonly primaryText: string;
|
|
107
|
+
/** The line that disambiguates it (town, region, country), when the vendor gives one. */
|
|
108
|
+
readonly secondaryText?: string;
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* Everything VENDOR-SPECIFIC about an address lookup, as four pure functions: how a query becomes the
|
|
113
|
+
* suggest operation's input, how its answer becomes suggestions, how a chosen suggestion becomes the retrieve
|
|
114
|
+
* operation's input, and how that answer becomes the framework's `AddressValue`.
|
|
115
|
+
*
|
|
116
|
+
* With it, the framework's own combobox (`ProviderAddressLookupCombobox` in `@wildo-ai/saas-frontend-lib`)
|
|
117
|
+
* is a complete lookup component: the keyboard pattern, the debounce, the minimum query length, stale-answer
|
|
118
|
+
* handling and the manual-entry fallback are written once rather than once per vendor. A provider whose
|
|
119
|
+
* lookup needs its own UI implements `ProviderAddressLookupProps` directly instead.
|
|
120
|
+
*
|
|
121
|
+
* `readAddress` returns TEXT parts only: a vendor geocode is never taken (#561 D3). A stored coordinate has no
|
|
122
|
+
* expiry, while a lookup's geocode is at best storable for a limited time (Google: 30 days) or not at all (Mapbox
|
|
123
|
+
* Search Box) — #561's 2026-09-14 reading of both vendors' terms — and nothing runs the vendor's clock. The
|
|
124
|
+
* field drops coordinates anyway.
|
|
125
|
+
*/
|
|
126
|
+
export interface ProviderAddressLookupAdapter {
|
|
127
|
+
buildSuggestInput(request: {
|
|
128
|
+
readonly query: string;
|
|
129
|
+
readonly countriesAllowed?: readonly string[];
|
|
130
|
+
readonly defaultCountry?: string;
|
|
131
|
+
readonly languageCode: string;
|
|
132
|
+
}): Record<string, unknown>;
|
|
133
|
+
/** Never throws on a well-formed but empty answer; returns `[]`. Throws only on an answer it cannot read. */
|
|
134
|
+
readSuggestions(output: unknown): readonly ProviderAddressLookupSuggestion[];
|
|
135
|
+
buildRetrieveInput(request: { readonly suggestion: ProviderAddressLookupSuggestion; readonly languageCode: string }): Record<string, unknown>;
|
|
136
|
+
/** `undefined` when the vendor answered with no postal address for the place (a place with no street address). */
|
|
137
|
+
readAddress(output: unknown): AddressValue | undefined;
|
|
138
|
+
}
|
|
139
|
+
```
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# saas.models.provider-address-lookup-declaration
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* How a `FRONTEND_ADDRESS_LOOKUP` component reaches its vendor, and what the vendor's terms require of the
|
|
14
|
+
* page (#561) — the DATA half a reviewer reads, and the half the framework's host ENFORCES.
|
|
15
|
+
*
|
|
16
|
+
* ## Why the lookup names backend OPERATIONS rather than a vendor URL (#561 D2)
|
|
17
|
+
*
|
|
18
|
+
* The vendor is never called from the page. Each suggestion and the final retrieval run through the
|
|
19
|
+
* application backend's provider-operation door (`POST /provider-operations/:providerRef/:operationId`),
|
|
20
|
+
* which spends the application's own credential, admits the operation by `providers.browserOperations`,
|
|
21
|
+
* throttles each caller, and records a `PROVIDER_OPERATION_CALL` row that carries no typed input. So the
|
|
22
|
+
* page holds no vendor key and needs no vendor origin in its CSP, and every vendor is reached one way.
|
|
23
|
+
* Google recommends exactly this for its web services: "Using a secure proxy server provides a solid source
|
|
24
|
+
* for interacting with a Google Maps Platform web service endpoint from a client-side application without
|
|
25
|
+
* exposing your API key".
|
|
26
|
+
* spec-cite: https://developers.google.com/maps/api-security-best-practices — "Proxy server", fetched 2026-09-29.
|
|
27
|
+
*
|
|
28
|
+
* The host hands the component two functions, `suggest` and `retrieve`, bound to the two operation ids
|
|
29
|
+
* declared here, so a reviewer reading the manifest sees which backend operations the application must open to
|
|
30
|
+
* browsers. What BOUNDS a component is the door, not this declaration: a component is code and could call the
|
|
31
|
+
* browser door itself, and the door runs only the operations the application listed in `providers.browserOperations`.
|
|
32
|
+
*
|
|
33
|
+
* ## Why the session token and the attribution are declared rather than left to the component (#561 D4)
|
|
34
|
+
*
|
|
35
|
+
* Both are vendor TERMS, and a term a component may forget is not held. The host generates one UUIDv4 per
|
|
36
|
+
* lookup session and writes it into the input field named by `sessionTokenInput` on every suggestion and on
|
|
37
|
+
* the retrieval, then starts a new session after a retrieval or when the lookup is abandoned — the vendor
|
|
38
|
+
* bills per session, and a missing or reused token bills every keystroke. The host renders
|
|
39
|
+
* `attributionMark` beside the lookup whenever it is mounted.
|
|
40
|
+
*/
|
|
41
|
+
export const ProviderAddressLookupDeclarationSchema = z.strictObject({
|
|
42
|
+
/** The backend operation of the SAME provider ref that turns typed text into suggestions. */
|
|
43
|
+
suggestOperationId: z.string().trim().min(1),
|
|
44
|
+
/** The backend operation of the same ref that turns one chosen suggestion into a structured address. */
|
|
45
|
+
retrieveOperationId: z.string().trim().min(1),
|
|
46
|
+
/**
|
|
47
|
+
* The operation INPUT field the vendor reads its session token from, when the vendor bills by session.
|
|
48
|
+
* Absent: the vendor takes none, and the host sends none.
|
|
49
|
+
*/
|
|
50
|
+
sessionTokenInput: z.string().trim().min(1).optional(),
|
|
51
|
+
/**
|
|
52
|
+
* The attribution the vendor requires beside its suggestions, VERBATIM — a trademark, never translated
|
|
53
|
+
* (Google: "the text Google Maps is acceptable" where its logo does not fit). The host renders it inside a
|
|
54
|
+
* sentence from the application's own labels.
|
|
55
|
+
* spec-cite: https://developers.google.com/maps/documentation/places/web-service/policies — attribution without a
|
|
56
|
+
* Google map, fetched 2026-09-29.
|
|
57
|
+
*/
|
|
58
|
+
attributionMark: z.string().trim().min(1).optional(),
|
|
59
|
+
});
|
|
60
|
+
export type ProviderAddressLookupDeclaration = z.infer<typeof ProviderAddressLookupDeclarationSchema>;
|
|
61
|
+
```
|