@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
|
@@ -148,6 +148,15 @@ export interface FrontendAppProviderModule {
|
|
|
148
148
|
* so a renamed key yielded `undefined` and a silently wrong provider. With a
|
|
149
149
|
* schema declared, the framework validates once at hydration and a mismatch
|
|
150
150
|
* says which key and why.
|
|
151
|
+
*
|
|
152
|
+
* MANDATORY for an authored module (#1705): its declared keys are the only
|
|
153
|
+
* list that bounds what a browser is served, so a module without one — or
|
|
154
|
+
* with one whose keys cannot be read without running it (use
|
|
155
|
+
* `defineFrontendPublicConfigSchema` or a Zod object) — is refused at
|
|
156
|
+
* projection, at `wildo config sync` and at hydration. It stays OPTIONAL in
|
|
157
|
+
* this type on purpose: the same type describes a HYDRATED registry entry, and
|
|
158
|
+
* a provider the service declares but whose code this bundle does not carry is
|
|
159
|
+
* data-only and has no schema to hold. The three runtime refusals are the gate.
|
|
151
160
|
*/
|
|
152
161
|
publicConfigSchema?: ProviderFrontendPublicConfigSchema;
|
|
153
162
|
/**
|
|
@@ -169,6 +178,17 @@ export interface FrontendAppProviderModule {
|
|
|
169
178
|
* `VENDOR_HOSTED` provider declaring no region cannot support a transfer statement.
|
|
170
179
|
*/
|
|
171
180
|
complianceProfile?: ProviderComplianceProfile;
|
|
181
|
+
/**
|
|
182
|
+
* Consent purposes THIS VENDOR rests on beyond its capabilities' floor (#1702). DATA.
|
|
183
|
+
*
|
|
184
|
+
* ADDITIVE: the provider rests on the union of these and the floor
|
|
185
|
+
* `PROVIDER_CAPABILITY_FRONTEND_CONSENT_CLASSIFICATION` gives each declared capability, so nothing
|
|
186
|
+
* written here can lower what a capability requires. Declare it when the vendor's own processing goes
|
|
187
|
+
* beyond the service the person asked for — Google reCAPTCHA is the measured case, a captcha whose
|
|
188
|
+
* vendor also analyses the visitor for its own purposes — and leave it out otherwise. A consent-based
|
|
189
|
+
* provider's SDK, scripts and components are all withheld until the person grants these.
|
|
190
|
+
*/
|
|
191
|
+
consentPurposes?: ReadonlyArray<ConsentPurpose>;
|
|
172
192
|
}
|
|
173
193
|
```
|
|
174
194
|
|
|
@@ -209,6 +229,15 @@ export const AcmePickerFrontendAppProvider: FrontendAppProviderModule = {
|
|
|
209
229
|
// key or a client id belongs here; a secret never does.
|
|
210
230
|
publicConfig: { clientId: 'acme-public-client-id' },
|
|
211
231
|
|
|
232
|
+
// MANDATORY (#1705): the keys `publicConfig` may carry, declared once. It is
|
|
233
|
+
// both halves — a strict validator the browser runs at hydration, and a key
|
|
234
|
+
// list `wildo config sync` reads without running anything. A module without
|
|
235
|
+
// one is refused at sync, at the companion projection and at hydration, and
|
|
236
|
+
// every served value is also compared against the environment's secrets.
|
|
237
|
+
publicConfigSchema: defineFrontendPublicConfigSchema({
|
|
238
|
+
clientId: { kind: FrontendPublicConfigValueKind.STRING, required: true, description: 'The PUBLIC OAuth client id.' },
|
|
239
|
+
}),
|
|
240
|
+
|
|
212
241
|
// Name only the buckets this provider reaches; the framework fills in the
|
|
213
242
|
// rest. Which CSP directive grades which bucket is framework knowledge, so a
|
|
214
243
|
// provider author never has to learn the directive taxonomy — and declaring
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
# What a frontend provider's `publicConfig` may carry — and how it is checked
|
|
2
|
+
|
|
3
|
+
Read this when a frontend provider module (a picker, an analytics or monitoring SDK, a captcha):
|
|
4
|
+
|
|
5
|
+
- declares its public configuration keys, or you add one;
|
|
6
|
+
- is handed a key through `providerConfigurations.<ref>.frontend_sdk` or through the application's own
|
|
7
|
+
`provider-contributions` mapping;
|
|
8
|
+
- is refused by `wildo config sync` or by the backend's `/application-config`, and you need to know why.
|
|
9
|
+
|
|
10
|
+
## A `publicConfigSchema` is mandatory
|
|
11
|
+
|
|
12
|
+
Every frontend provider module declares `publicConfigSchema`, built with `defineFrontendPublicConfigSchema`
|
|
13
|
+
(or a Zod object). It is both halves at once: a strict validator the browser runs when the provider is
|
|
14
|
+
hydrated, and a key list `wildo config sync` reads without running anything. A module without one is
|
|
15
|
+
refused three times over — when its contribution is projected, at sync (`SCHEMA_NOT_INTROSPECTABLE`) and
|
|
16
|
+
at hydration, where its code is withheld. Declare EVERY key the module's own `publicConfig` carries, and
|
|
17
|
+
every key an application may supply; the keys a capability owns (the file picker's `acceptedMimeTypes`,
|
|
18
|
+
`maxFileSizeMb`, `maxSelectionCount`) are admitted through the capability and need no declaration.
|
|
19
|
+
|
|
20
|
+
A key is checked wherever it came from: authored on the module, mapped onto the contribution in
|
|
21
|
+
`provider-contributions`, or supplied under `providerConfigurations`. An undeclared one is refused
|
|
22
|
+
(`UNDECLARED_KEY`) — it would be served to every browser and read by nothing.
|
|
23
|
+
|
|
24
|
+
The generated configuration is held to the same list where it is READ, not only where it is written: the
|
|
25
|
+
backend refuses to serve on `/application-config`, and the website and documentation builds refuse to bake
|
|
26
|
+
into pages, an entry that carries no key list or serves a key outside it. That is what an artifact
|
|
27
|
+
generated by an older `wildo config sync` looks like; the remedy is to run `wildo config sync` again.
|
|
28
|
+
|
|
29
|
+
## Secret VALUES are compared, not key names
|
|
30
|
+
|
|
31
|
+
Before `wildo config sync` writes the generated provider artifacts, it compares every string every frontend
|
|
32
|
+
provider would serve against the confidential values of that environment's `secrets.json`. A value equal to
|
|
33
|
+
one — or containing a long one, such as a URL carrying a key — is refused (`SECRET_VALUE`), whatever it is
|
|
34
|
+
called and whichever vendor the secret belongs to. The message names the served key and the secret's slot,
|
|
35
|
+
never the value. The backend runs the same comparison over what it serves on `/application-config`, against
|
|
36
|
+
its providers' secret slots.
|
|
37
|
+
|
|
38
|
+
- Everything in `secrets.json` is confidential except identities (usernames, the administrator's name and
|
|
39
|
+
email) and a provider slot its contract marks as holding a vendor value made for browsers (PostHog's
|
|
40
|
+
project key, which its browser SDK is initialized with too).
|
|
41
|
+
- If the environment's `secrets.json` cannot be read, sync produces NO frontend provider configuration and
|
|
42
|
+
names the file. For a remote environment, `wildo config sync --ci` reconstructs it first.
|
|
43
|
+
- The fix for a refusal is to serve the vendor's PUBLIC key (a publishable, site or search-only key), never
|
|
44
|
+
to rename the key. If the secret was ever committed or served, rotate it.
|
|
45
|
+
|
|
46
|
+
## Import Origins
|
|
47
|
+
|
|
48
|
+
- `@wildo-ai/saas-models`
|
|
49
|
+
|
|
50
|
+
## Source Excerpts
|
|
51
|
+
|
|
52
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
53
|
+
|
|
54
|
+
```typescript
|
|
55
|
+
/** Why an application-supplied public-config bag was refused. */
|
|
56
|
+
export enum FrontendProviderPublicConfigRefusal {
|
|
57
|
+
/** A key the provider module does not declare — almost always a misspelling. */
|
|
58
|
+
UNDECLARED_KEY = 'UNDECLARED_KEY',
|
|
59
|
+
/** A key naming a secret from the same vendor's backend contract. Never negotiable. */
|
|
60
|
+
SECRET_KEY = 'SECRET_KEY',
|
|
61
|
+
/** The supplied bag is not a plain object — a string, an array, `null`. */
|
|
62
|
+
NOT_AN_OBJECT = 'NOT_AN_OBJECT',
|
|
63
|
+
/**
|
|
64
|
+
* The module declares no `publicConfigSchema` whose keys can be read without running it
|
|
65
|
+
* (#1705). Nothing can then say which keys it takes, so nothing it is handed can be held to a
|
|
66
|
+
* list — and "admit everything" is the answer that reaches a browser.
|
|
67
|
+
*/
|
|
68
|
+
SCHEMA_NOT_INTROSPECTABLE = 'SCHEMA_NOT_INTROSPECTABLE',
|
|
69
|
+
/**
|
|
70
|
+
* A served value equals, or contains, one of the producer's SECRET VALUES (#1705) — whatever the
|
|
71
|
+
* key is called and whichever vendor the secret belongs to. Never negotiable.
|
|
72
|
+
*/
|
|
73
|
+
SECRET_VALUE = 'SECRET_VALUE',
|
|
74
|
+
}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
78
|
+
|
|
79
|
+
```typescript
|
|
80
|
+
/**
|
|
81
|
+
* The shortest secret a served value is searched INSIDE, not only compared to.
|
|
82
|
+
*
|
|
83
|
+
* Containment catches a secret embedded in a larger public value — a URL carrying
|
|
84
|
+
* `?key=<secret>`, a `https://user:<secret>@host` endpoint — which exact equality would miss.
|
|
85
|
+
* Below this length a secret (a six-character default password, a short database name held in a
|
|
86
|
+
* credential slot) could occur by coincidence inside an ordinary public value such as a host name,
|
|
87
|
+
* and refusing a correct configuration on that coincidence would teach operators to route around
|
|
88
|
+
* the check. Shorter secrets are still compared EXACTLY.
|
|
89
|
+
*/
|
|
90
|
+
export const FRONTEND_PUBLIC_CONFIG_SECRET_CONTAINMENT_MIN_LENGTH = 16;
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
94
|
+
|
|
95
|
+
```typescript
|
|
96
|
+
/**
|
|
97
|
+
* The value kinds a public-config key may declare. Scalars only, on purpose: a
|
|
98
|
+
* public key is an identifier or a flag, and a structured value here is a
|
|
99
|
+
* design smell — a provider that needs one has a capability-level shape
|
|
100
|
+
* (`FrontendFilePickerPublicConfigSchema`) to declare it in.
|
|
101
|
+
*/
|
|
102
|
+
export enum FrontendPublicConfigValueKind {
|
|
103
|
+
STRING = 'string',
|
|
104
|
+
NUMBER = 'number',
|
|
105
|
+
BOOLEAN = 'boolean',
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
export interface FrontendPublicConfigKeySpec {
|
|
109
|
+
readonly kind: FrontendPublicConfigValueKind;
|
|
110
|
+
/** Absent = optional. Picker keys are usually optional: a missing one is reported when the picker opens, not by dropping the provider. */
|
|
111
|
+
readonly required?: boolean;
|
|
112
|
+
/** For the person writing `wildo.saas.config.ts`. Not validated; surfaced in refusals. */
|
|
113
|
+
readonly description?: string;
|
|
114
|
+
}
|
|
115
|
+
```
|
|
@@ -0,0 +1,386 @@
|
|
|
1
|
+
# Provider components — one declaration, three surfaces
|
|
2
|
+
|
|
3
|
+
Read this when a provider module contributes a component (`components[capability]`) and you need to
|
|
4
|
+
know how it reaches the application, the marketing website or the documentation site, or when you
|
|
5
|
+
mount one yourself.
|
|
6
|
+
|
|
7
|
+
## One registry, built the same way everywhere
|
|
8
|
+
|
|
9
|
+
A provider declares a component ONCE, on its frontend module. The application, the website and the
|
|
10
|
+
documentation site each build the same registry from that declaration, keyed `capability:providerRef`:
|
|
11
|
+
several providers may answer one capability, nothing picks one for you, a provider's declared
|
|
12
|
+
`<script>` tags load before its component is handed back, and a provider resting on a consent purpose
|
|
13
|
+
the person has not granted downloads nothing. The registry refuses to load where there is no browser
|
|
14
|
+
document, so a server render (the website) or a build-time prerender (the documentation site) never
|
|
15
|
+
executes a vendor's code.
|
|
16
|
+
|
|
17
|
+
## Import Origins
|
|
18
|
+
|
|
19
|
+
- `@wildo-ai/external-connectors-public`
|
|
20
|
+
|
|
21
|
+
## Source Excerpts
|
|
22
|
+
|
|
23
|
+
### Origin Package: `@wildo-ai/external-connectors-public`
|
|
24
|
+
|
|
25
|
+
```typescript
|
|
26
|
+
/** A loader as a provider module declares it: on demand, returning the component. */
|
|
27
|
+
export type ProviderComponentLoader = () => Promise<unknown>;
|
|
28
|
+
|
|
29
|
+
/** Why a provider component could not be registered or loaded. */
|
|
30
|
+
export enum ProviderComponentDiagnosticKind {
|
|
31
|
+
/**
|
|
32
|
+
* A second registration arrived for one capability AND provider. The first is kept: a duplicate is
|
|
33
|
+
* a wiring mistake, and swapping the live component under a mounted surface would be worse than
|
|
34
|
+
* ignoring it.
|
|
35
|
+
*/
|
|
36
|
+
DUPLICATE_REGISTRATION = 'DUPLICATE_REGISTRATION',
|
|
37
|
+
/** The loader threw or rejected. That provider's component is unavailable; others are not affected. */
|
|
38
|
+
LOAD_FAILED = 'LOAD_FAILED',
|
|
39
|
+
/**
|
|
40
|
+
* The loader resolved something that is not a component. Almost always a loader returning a MODULE
|
|
41
|
+
* NAMESPACE — `() => import('./Picker')` — where it should return the component itself.
|
|
42
|
+
*/
|
|
43
|
+
LOADED_VALUE_IS_NOT_A_COMPONENT = 'LOADED_VALUE_IS_NOT_A_COMPONENT',
|
|
44
|
+
/**
|
|
45
|
+
* A live provider DECLARES a component for a capability and nothing supplies its loader — neither
|
|
46
|
+
* the module (`components[cap].load`) nor the surface's facet library (a loader contribution). The
|
|
47
|
+
* declaration is DATA a reviewer can read; without code behind it the surface would offer a
|
|
48
|
+
* component that cannot open. Not registered, and reported once at startup.
|
|
49
|
+
*/
|
|
50
|
+
DECLARED_WITHOUT_LOADER = 'DECLARED_WITHOUT_LOADER',
|
|
51
|
+
/**
|
|
52
|
+
* BOTH the module and the facet library supplied a loader for one `capability:providerRef`. The
|
|
53
|
+
* module's wins — it is the provider's own word — and the collision is reported, because the engine
|
|
54
|
+
* never authors both and two loaders for one declaration is the map-order ambiguity #380 removed.
|
|
55
|
+
*/
|
|
56
|
+
LOADER_SUPPLIED_TWICE = 'LOADER_SUPPLIED_TWICE',
|
|
57
|
+
/**
|
|
58
|
+
* A `<script>` the declaring provider needs did not load — a network failure, a
|
|
59
|
+
* Content-Security-Policy refusal, or an integrity mismatch. The component resolves `null`, and that
|
|
60
|
+
* answer is CACHED exactly like `LOAD_FAILED`: the failed element stays in the document and is not
|
|
61
|
+
* retried this session (a vendor script can fail after partially executing, and a second copy could
|
|
62
|
+
* initialise over the first). A component whose vendor global is absent is not usable, and handing
|
|
63
|
+
* it back would only move the failure into its own mount, where nothing can name the provider's
|
|
64
|
+
* declaration as the cause.
|
|
65
|
+
*/
|
|
66
|
+
SCRIPT_LOAD_FAILED = 'SCRIPT_LOAD_FAILED',
|
|
67
|
+
/**
|
|
68
|
+
* The provider rests on a consent purpose the person has not granted, or its consent classification
|
|
69
|
+
* is broken, so neither its component nor its scripts were loaded (#1702). NOT cached: a grant given
|
|
70
|
+
* a moment later must be able to load it, which is the difference from every failure above.
|
|
71
|
+
*/
|
|
72
|
+
WITHHELD_PENDING_CONSENT = 'WITHHELD_PENDING_CONSENT',
|
|
73
|
+
/**
|
|
74
|
+
* `resolve` was called where there is no browser document — a server render (the website) or a
|
|
75
|
+
* build-time prerender (the documentation site). Nothing was loaded and nothing is cached: the same
|
|
76
|
+
* registry asked again in the browser loads normally (#1703).
|
|
77
|
+
*/
|
|
78
|
+
NOT_IN_A_BROWSER = 'NOT_IN_A_BROWSER',
|
|
79
|
+
/**
|
|
80
|
+
* The provider rests on a consent purpose AND its registration carries `<script>` tags (#1704). A script,
|
|
81
|
+
* once executed, cannot be stopped when that consent is withdrawn, so such a registration is never
|
|
82
|
+
* registered: neither its component nor its scripts can load. Projection already refuses the module and
|
|
83
|
+
* hydration withholds it; this is the same predicate (`consentBasedProviderStopRefusal`) at the registry,
|
|
84
|
+
* so a hand-built module list cannot reach a page with one either.
|
|
85
|
+
*/
|
|
86
|
+
CONSENT_BASED_PROVIDER_NOT_STOPPABLE = 'CONSENT_BASED_PROVIDER_NOT_STOPPABLE',
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
export interface ProviderComponentDiagnostic {
|
|
90
|
+
readonly kind: ProviderComponentDiagnosticKind;
|
|
91
|
+
readonly capability: string;
|
|
92
|
+
readonly providerRef: string;
|
|
93
|
+
readonly message: string;
|
|
94
|
+
readonly cause?: unknown;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export interface ProviderComponentRegistration {
|
|
98
|
+
readonly capability: ProviderCapability;
|
|
99
|
+
readonly providerRef: string;
|
|
100
|
+
readonly load: ProviderComponentLoader;
|
|
101
|
+
/**
|
|
102
|
+
* What the provider DECLARED about this component — today, what a selection from it contains. Kept
|
|
103
|
+
* beside the loader rather than looked up from the DATA entry at the use site, because a surface
|
|
104
|
+
* needs it BEFORE it decides to load anything, and because the two would then be two sources for
|
|
105
|
+
* one fact.
|
|
106
|
+
*/
|
|
107
|
+
readonly descriptor: ProviderFrontendComponentDescriptor;
|
|
108
|
+
/**
|
|
109
|
+
* The third-party `<script>` tags the DECLARING PROVIDER needs (its module's `scripts`), loaded
|
|
110
|
+
* before the component is handed back. Absent means the component depends on no script.
|
|
111
|
+
*/
|
|
112
|
+
readonly scripts?: ReadonlyArray<ProviderFrontendScriptDeclaration>;
|
|
113
|
+
/**
|
|
114
|
+
* What the DECLARING PROVIDER rests on for consent — its capabilities and its own module-level
|
|
115
|
+
* purposes (#1702). Consent is a property of the provider, not of one component. Required, so a
|
|
116
|
+
* registration cannot be built that forgot the question.
|
|
117
|
+
*/
|
|
118
|
+
readonly consent: ConsentClassifiableProviderModule;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/** Whether a provider's component may load for the purposes granted, and what would permit it. */
|
|
122
|
+
export interface ProviderComponentConsentRequirement {
|
|
123
|
+
/** True when the component may load now. */
|
|
124
|
+
readonly permitted: boolean;
|
|
125
|
+
/**
|
|
126
|
+
* The purposes the person would have to grant. Empty when `permitted`, AND when no grant could
|
|
127
|
+
* permit it (a capability no browser may host, a purpose outside the vocabulary) — which is why
|
|
128
|
+
* `permitted` exists.
|
|
129
|
+
*/
|
|
130
|
+
readonly missingPurposes: readonly ConsentPurpose[];
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
* Loads a provider's declared scripts and resolves once each has executed or failed. Never rejects:
|
|
135
|
+
* failures come back in the outcome.
|
|
136
|
+
*/
|
|
137
|
+
export type ProviderComponentScriptLoader = (
|
|
138
|
+
scripts: ReadonlyArray<DeclaredProviderScript>,
|
|
139
|
+
) => Promise<ProviderScriptLoadOutcome>;
|
|
140
|
+
|
|
141
|
+
export interface ProviderComponentRegistry<TComponent = unknown> {
|
|
142
|
+
/**
|
|
143
|
+
* Every provider offering a component for this capability, in registration order. Synchronous ON
|
|
144
|
+
* PURPOSE: a surface has to render its chooser before any component is loaded.
|
|
145
|
+
*/
|
|
146
|
+
listProviders(capability: ProviderCapability): ReadonlyArray<string>;
|
|
147
|
+
/** Whether this exact provider offers a component for this capability. */
|
|
148
|
+
has(capability: ProviderCapability, providerRef: string): boolean;
|
|
149
|
+
/**
|
|
150
|
+
* Every provider with at least one registered component. A surface reads it to load such a provider's
|
|
151
|
+
* `<script>` tags WITH its component rather than at startup — see `collectProviderScriptsWithoutComponents`.
|
|
152
|
+
*/
|
|
153
|
+
providersWithComponents(): ReadonlySet<string>;
|
|
154
|
+
/**
|
|
155
|
+
* What the provider declared about its component, without loading it — `undefined` when this
|
|
156
|
+
* provider offers none for this capability. Synchronous: a routing decision that had to await a
|
|
157
|
+
* download would mean downloading a component to find out whether the surface can use it.
|
|
158
|
+
*/
|
|
159
|
+
describe(capability: ProviderCapability, providerRef: string): ProviderFrontendComponentDescriptor | undefined;
|
|
160
|
+
/**
|
|
161
|
+
* Whether this provider's component may load for the purposes granted (#1702) — `undefined` when
|
|
162
|
+
* the provider offers none. Synchronous, so a surface can render a consent-required state without
|
|
163
|
+
* downloading anything.
|
|
164
|
+
*/
|
|
165
|
+
consentRequirement(
|
|
166
|
+
capability: ProviderCapability,
|
|
167
|
+
providerRef: string,
|
|
168
|
+
grantedConsentPurposes: readonly ConsentPurpose[],
|
|
169
|
+
): ProviderComponentConsentRequirement | undefined;
|
|
170
|
+
/**
|
|
171
|
+
* Loads one provider's component AND the scripts its provider declares, in parallel, and hands the
|
|
172
|
+
* component back only once both are present. The loader runs at most once per pair, and a failure
|
|
173
|
+
* of either half is reported and returns `null` rather than throwing into a render.
|
|
174
|
+
*
|
|
175
|
+
* CONSENT-GATED (#1702): a provider resting on a purpose not in `grantedConsentPurposes` loads
|
|
176
|
+
* nothing and resolves `null` with `WITHHELD_PENDING_CONSENT`. The grant defaults to NONE: a caller
|
|
177
|
+
* that holds no person's answer must not load consent-based code on an assumed one.
|
|
178
|
+
*
|
|
179
|
+
* BROWSER-ONLY (#1703): with no browser document it loads nothing and resolves `null` with
|
|
180
|
+
* `NOT_IN_A_BROWSER`. Neither refusal is cached.
|
|
181
|
+
*/
|
|
182
|
+
resolve(
|
|
183
|
+
capability: ProviderCapability,
|
|
184
|
+
providerRef: string,
|
|
185
|
+
grantedConsentPurposes?: readonly ConsentPurpose[],
|
|
186
|
+
): Promise<TComponent | null>;
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
export interface CreateProviderComponentRegistryInput {
|
|
190
|
+
readonly registrations?: Iterable<ProviderComponentRegistration>;
|
|
191
|
+
readonly onDiagnostic?: (diagnostic: ProviderComponentDiagnostic) => void;
|
|
192
|
+
/**
|
|
193
|
+
* How declared scripts are loaded. Defaults to the shared injector on the live `document`;
|
|
194
|
+
* injectable so a test can settle a script without a network.
|
|
195
|
+
*/
|
|
196
|
+
readonly loadScripts?: ProviderComponentScriptLoader;
|
|
197
|
+
/**
|
|
198
|
+
* Whether a browser document is present. Defaults to `typeof document !== 'undefined'`, read on
|
|
199
|
+
* every `resolve`. Injectable only so a test can stand for a server render inside a DOM test
|
|
200
|
+
* environment; a host must not pass `() => true` to force a load on a server.
|
|
201
|
+
*/
|
|
202
|
+
readonly hasBrowserDocument?: () => boolean;
|
|
203
|
+
}
|
|
204
|
+
```
|
|
205
|
+
|
|
206
|
+
## Where a component's loader comes from
|
|
207
|
+
|
|
208
|
+
A provider PACKAGE that ships its own component writes `components[capability].load` on its module —
|
|
209
|
+
`async () => (await import('./Lookup.js')).Lookup`, returning the component, never the module
|
|
210
|
+
namespace. An ENGINE provider module cannot import a React component, so the surface's facet library
|
|
211
|
+
contributes the loader instead:
|
|
212
|
+
|
|
213
|
+
## Import Origins
|
|
214
|
+
|
|
215
|
+
- `@wildo-ai/external-connectors-public`
|
|
216
|
+
|
|
217
|
+
## Source Excerpts
|
|
218
|
+
|
|
219
|
+
### Origin Package: `@wildo-ai/external-connectors-public`
|
|
220
|
+
|
|
221
|
+
```typescript
|
|
222
|
+
/**
|
|
223
|
+
* A loader the SURFACE'S FACET LIBRARY supplies for a component a provider module declares — the
|
|
224
|
+
* second of the two doors, and the one every engine-shipped component uses (#394).
|
|
225
|
+
*
|
|
226
|
+
* An engine provider module lives in this deliberately renderer-free package and cannot name a
|
|
227
|
+
* loader that reaches a React component: that would close a package cycle. The library that owns
|
|
228
|
+
* the component contributes the loader instead:
|
|
229
|
+
*
|
|
230
|
+
* - the application: `presets-components`, through `contributeProviderComponentLoaders`;
|
|
231
|
+
* - the website: the page bridge's `providerComponentLoaders` dependency;
|
|
232
|
+
* - the documentation site: `DocsFrontendProviders`' `providerComponentLoaders` prop.
|
|
233
|
+
*
|
|
234
|
+
* A provider PACKAGE that ships its own component uses `components[cap].load` instead. Both doors
|
|
235
|
+
* exist, the engine authors exactly one per declaration, and a collision is reported.
|
|
236
|
+
*/
|
|
237
|
+
export interface ProviderComponentLoaderContribution {
|
|
238
|
+
readonly capability: ProviderCapability;
|
|
239
|
+
readonly providerRef: string;
|
|
240
|
+
readonly load: ProviderComponentLoader;
|
|
241
|
+
}
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
## One state vocabulary
|
|
245
|
+
|
|
246
|
+
Every surface reports the same states. Import `ProviderComponentStatus` from the facet your surface
|
|
247
|
+
uses — `@wildo-ai/external-connectors-public/app`, `/website` or `/techdoc`; `@wildo-ai/saas-frontend-lib`
|
|
248
|
+
no longer re-states it. `CONSENT_REQUIRED` means nothing was downloaded, and a surface
|
|
249
|
+
renders a consent-required state there — never a blank.
|
|
250
|
+
|
|
251
|
+
## Import Origins
|
|
252
|
+
|
|
253
|
+
- `@wildo-ai/external-connectors-public`
|
|
254
|
+
|
|
255
|
+
## Source Excerpts
|
|
256
|
+
|
|
257
|
+
### Origin Package: `@wildo-ai/external-connectors-public`
|
|
258
|
+
|
|
259
|
+
```typescript
|
|
260
|
+
/**
|
|
261
|
+
* Why a provider component is not on screen yet — ONE vocabulary for the application, the website and
|
|
262
|
+
* the documentation site, so a surface's rendering of each state means the same thing everywhere.
|
|
263
|
+
*/
|
|
264
|
+
export enum ProviderComponentStatus {
|
|
265
|
+
/** No provider was chosen, or none offers a component for this capability. */
|
|
266
|
+
NONE = 'NONE',
|
|
267
|
+
/** The component, or a script its provider declares, is still downloading. */
|
|
268
|
+
LOADING = 'LOADING',
|
|
269
|
+
/**
|
|
270
|
+
* The component is loaded AND every `<script>` its provider declares has executed — so a component
|
|
271
|
+
* that reads a vendor global on mount finds it. Never READY on the component alone.
|
|
272
|
+
*/
|
|
273
|
+
READY = 'READY',
|
|
274
|
+
/**
|
|
275
|
+
* The loader failed, returned something unrenderable, or a script the provider declares did not
|
|
276
|
+
* load. The registry has already reported why; a surface should fall back rather than retry.
|
|
277
|
+
*/
|
|
278
|
+
UNAVAILABLE = 'UNAVAILABLE',
|
|
279
|
+
/**
|
|
280
|
+
* The provider rests on consent the person has not granted, so NOTHING of it was downloaded (#1702).
|
|
281
|
+
* `missingConsentPurposes` names what would permit it. A surface renders a consent-required state
|
|
282
|
+
* here, never a blank.
|
|
283
|
+
*/
|
|
284
|
+
CONSENT_REQUIRED = 'CONSENT_REQUIRED',
|
|
285
|
+
}
|
|
286
|
+
|
|
287
|
+
export interface ProviderComponentLoadState<TComponent = unknown> {
|
|
288
|
+
readonly status: ProviderComponentStatus;
|
|
289
|
+
readonly Component: TComponent | null;
|
|
290
|
+
/** The purposes to grant. Non-empty exactly when `status` is `CONSENT_REQUIRED`. */
|
|
291
|
+
readonly missingConsentPurposes: readonly ConsentPurpose[];
|
|
292
|
+
}
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
## Mounting a component on each surface
|
|
296
|
+
|
|
297
|
+
| Surface | Mount | Consent comes from |
|
|
298
|
+
|---|---|---|
|
|
299
|
+
| Application | `ProviderFilePickerHost` (file picker), or `useProviderComponent` in your own view | the signed-in person's stored preference |
|
|
300
|
+
| Website | `<WebsiteProviderComponent>` from `@wildo-ai/saas-website` | the visitor's decision (`useWebsiteConsent`) |
|
|
301
|
+
| Documentation site | `<DocsProviderComponent>` from `@wildo-ai/saas-technical-doc/runtime`, inside `DocsFrontendProviders` | nobody is asked: a consent-based provider never loads there |
|
|
302
|
+
|
|
303
|
+
The documentation site has no label pack of its own, so its slot takes the words for its refusal and
|
|
304
|
+
failure states as props — write them with Docusaurus `<Translate>`:
|
|
305
|
+
|
|
306
|
+
## Import Origins
|
|
307
|
+
|
|
308
|
+
- `@wildo-ai/saas-technical-doc`
|
|
309
|
+
|
|
310
|
+
## Source Excerpts
|
|
311
|
+
|
|
312
|
+
### Origin Package: `@wildo-ai/saas-technical-doc`
|
|
313
|
+
|
|
314
|
+
```tsx
|
|
315
|
+
*
|
|
316
|
+
* `<DocsProviderComponent>` — places ONE provider's component on a documentation page (#1703), from
|
|
317
|
+
* the provider's own `components[capability]` declaration, the same one the application and the website
|
|
318
|
+
* read. Mount it inside `DocsFrontendProviders`.
|
|
319
|
+
*
|
|
320
|
+
* - **Nothing of the vendor reaches the prerendered HTML.** Docusaurus renders every page at build time;
|
|
321
|
+
* the component loads from an effect, which never runs there, and the registry refuses to load where
|
|
322
|
+
* there is no browser document. The build renders only the reserved box — this is the effect-based
|
|
323
|
+
* equivalent of a `<BrowserOnly>` boundary, with the box kept so the page does not shift.
|
|
324
|
+
* - **No layout shift.** `reservedMinHeight` applies to the box in every state.
|
|
325
|
+
* - **Consent: nobody is asked here, so a provider resting on a consent purpose never loads** on the
|
|
326
|
+
* documentation site, and the box renders `consentRequired`; a component that fails to load renders
|
|
327
|
+
* `unavailable`. Both REQUIRED, so a page cannot place a component and ship a silent blank where it
|
|
328
|
+
* would have been.
|
|
329
|
+
* - **The words are the site's.** The documentation runtime has no label pack of its own, so every state
|
|
330
|
+
* a reader sees is passed in — write them with Docusaurus `<Translate>` so they are translated with
|
|
331
|
+
* the rest of the site. The box holds a `role="status"` live region from the first render, filled
|
|
332
|
+
* when a refusal or failure appears, so a screen reader announces it.
|
|
333
|
+
* - **The vendor's scripts load with the component**, not on every documentation page.
|
|
334
|
+
*/
|
|
335
|
+
export interface DocsProviderComponentProps<TProps extends object> {
|
|
336
|
+
/** The capability the component fills. */
|
|
337
|
+
capability: ProviderCapability;
|
|
338
|
+
/** The provider the page chose, or `undefined` while nothing is chosen. */
|
|
339
|
+
providerRef: string | undefined;
|
|
340
|
+
/** The props the loaded component receives — the capability's slot contract. */
|
|
341
|
+
componentProps: TProps;
|
|
342
|
+
/** Rendered when the provider rests on a consent purpose, which the documentation site never grants. */
|
|
343
|
+
consentRequired: ReactNode;
|
|
344
|
+
/** Rendered when the component could not be loaded. Required for the same reason: a failure must say so. */
|
|
345
|
+
unavailable: ReactNode;
|
|
346
|
+
/** CSS length reserved for the box in every state, so the page does not shift when the component loads. */
|
|
347
|
+
reservedMinHeight?: string;
|
|
348
|
+
}
|
|
349
|
+
|
|
350
|
+
export function DocsProviderComponent<TProps extends object>({
|
|
351
|
+
capability,
|
|
352
|
+
providerRef,
|
|
353
|
+
componentProps,
|
|
354
|
+
consentRequired,
|
|
355
|
+
unavailable,
|
|
356
|
+
reservedMinHeight,
|
|
357
|
+
}: DocsProviderComponentProps<TProps>): ReactNode {
|
|
358
|
+
const { status, Component } = useDocsProviderComponent(capability, providerRef);
|
|
359
|
+
|
|
360
|
+
// The registry cannot know a capability's props; the page states them through `componentProps`.
|
|
361
|
+
const Loaded = status === ProviderComponentStatus.READY && Component !== null
|
|
362
|
+
? (Component as unknown as React.ComponentType<TProps>)
|
|
363
|
+
: null;
|
|
364
|
+
// The live region is present from the first render and FILLED when a refusal appears, so a screen
|
|
365
|
+
// reader announces it; a region inserted already filled is often not announced at all.
|
|
366
|
+
const content: ReactNode = Loaded !== null
|
|
367
|
+
? <Loaded {...componentProps} />
|
|
368
|
+
: (
|
|
369
|
+
<div role="status">
|
|
370
|
+
{status === ProviderComponentStatus.CONSENT_REQUIRED ? consentRequired : null}
|
|
371
|
+
{status === ProviderComponentStatus.UNAVAILABLE ? unavailable : null}
|
|
372
|
+
</div>
|
|
373
|
+
);
|
|
374
|
+
|
|
375
|
+
return (
|
|
376
|
+
<div
|
|
377
|
+
data-docs-provider-component={capability}
|
|
378
|
+
data-docs-provider-component-state={status}
|
|
379
|
+
aria-busy={status === ProviderComponentStatus.LOADING ? true : undefined}
|
|
380
|
+
style={reservedMinHeight !== undefined ? { minHeight: reservedMinHeight } : undefined}
|
|
381
|
+
>
|
|
382
|
+
{content}
|
|
383
|
+
</div>
|
|
384
|
+
);
|
|
385
|
+
}
|
|
386
|
+
```
|