@wildo-ai/framework-knowledge 1.1.5 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +320 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1238 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3191 -1126
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5887 -1695
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -0,0 +1,577 @@
|
|
|
1
|
+
# The recipient population
|
|
2
|
+
|
|
3
|
+
Who, of everything the application declares, actually RECEIVES personal data, and on whose account. One
|
|
4
|
+
function computes it, and the privacy notice's recipients fact, your drafting brief and the assurance
|
|
5
|
+
evidence all read that one function, so a notice and its evidence cannot disagree about who a recipient is.
|
|
6
|
+
|
|
7
|
+
Read this when:
|
|
8
|
+
|
|
9
|
+
- the brief lists a provider under TENANT RECIPIENTS or DECLARED, NO DATA PATH and you need to know why;
|
|
10
|
+
- a report says a configured provider is not on the processor register, or that a register entry names a
|
|
11
|
+
tenant's own vendor;
|
|
12
|
+
- you are deciding whether a catalogue vendor the application declares belongs in the notice at all;
|
|
13
|
+
- you are tempted to list every configured provider as a recipient "to be safe".
|
|
14
|
+
|
|
15
|
+
Do not do the last one. A provider nothing reaches receives nothing, and naming it publishes a recipient
|
|
16
|
+
that does not exist. A vendor reached only through a customer's own connected account is the customer's
|
|
17
|
+
vendor; naming it as the operator's sub-processor states an engagement the operator never made.
|
|
18
|
+
|
|
19
|
+
How a class is decided, in order: an explicit `SELF_HOSTED` choice is operator-run; a member no data path
|
|
20
|
+
reaches is declared-without-data-path; a member some path reaches with the APPLICATION's own account is an
|
|
21
|
+
operator sub-processor; what remains is reached only through tenants' or people's accounts and is a tenant
|
|
22
|
+
recipient. The data paths are an engine capability, a capability role the engine wires (single sign-on, a
|
|
23
|
+
captcha, a file picker), a browser operation `providers.browserOperations` opens, a generated typed client
|
|
24
|
+
application source imports, and a `systemsOfRecord` instance.
|
|
25
|
+
|
|
26
|
+
To move a member out of DECLARED, NO DATA PATH, either remove the declaration or build the path it was
|
|
27
|
+
declared for. To move one out of OPERATOR SUB-PROCESSOR with no compliance choice, answer
|
|
28
|
+
`providerComplianceChoices` in `wildo.saas.config.ts`. Never edit the register to make a report quiet:
|
|
29
|
+
an entry you cannot verify is worse than an absent one.
|
|
30
|
+
|
|
31
|
+
## Import Origins
|
|
32
|
+
|
|
33
|
+
- `@wildo-ai/saas-specifications`
|
|
34
|
+
|
|
35
|
+
## Source Excerpts
|
|
36
|
+
|
|
37
|
+
### Origin Package: `@wildo-ai/saas-specifications`
|
|
38
|
+
|
|
39
|
+
```typescript
|
|
40
|
+
/**
|
|
41
|
+
* The KEYS of `providers.scopes` in the SaaS config.
|
|
42
|
+
*
|
|
43
|
+
* Named because one of them decides whether a provider can be a recipient at all: `COMPANION` is the scope of
|
|
44
|
+
* the tool that BUILDS the application, which reaches its source and specifications and never a user's data.
|
|
45
|
+
* The other four are runtimes. Three of them group several runtimes (`frontendServices.<service>`,
|
|
46
|
+
* `minions.<minion>`, `workers.<worker>`), which is why a walk that read only `scopes.<key>.providers` missed
|
|
47
|
+
* every provider under them.
|
|
48
|
+
*/
|
|
49
|
+
export enum ProviderScopeKey {
|
|
50
|
+
BACKEND = "backend",
|
|
51
|
+
COMPANION = "companion",
|
|
52
|
+
FRONTEND_SERVICES = "frontendServices",
|
|
53
|
+
MINIONS = "minions",
|
|
54
|
+
WORKERS = "workers",
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/** What a population member is: a configured provider, or a declared system-of-record instance. */
|
|
58
|
+
export enum RecipientPopulationMemberKind {
|
|
59
|
+
CONFIGURED_PROVIDER = "configured-provider",
|
|
60
|
+
SYSTEM_OF_RECORD = "system-of-record",
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* The four answers the population gives about a member.
|
|
65
|
+
*
|
|
66
|
+
* Mutually exclusive and total: every runtime member lands in exactly one, decided in this order.
|
|
67
|
+
*/
|
|
68
|
+
export enum RecipientPopulationClass {
|
|
69
|
+
/** An explicit `SELF_HOSTED` compliance choice. The operator runs it; no third party receives anything. */
|
|
70
|
+
OPERATOR_RUN = "operator-run",
|
|
71
|
+
/**
|
|
72
|
+
* Reached with an APPLICATION-owned credential through at least one data path. The operator engaged this
|
|
73
|
+
* vendor, so it belongs in the operator's processor register.
|
|
74
|
+
*/
|
|
75
|
+
OPERATOR_SUB_PROCESSOR = "operator-sub-processor",
|
|
76
|
+
/**
|
|
77
|
+
* Reached ONLY through a tenant's or a person's connected account. The tenant's own vendor, reached at the
|
|
78
|
+
* tenant's instruction: reported separately, and never required in — nor admissible to — the operator's
|
|
79
|
+
* register.
|
|
80
|
+
*/
|
|
81
|
+
TENANT_RECIPIENT = "tenant-recipient",
|
|
82
|
+
/**
|
|
83
|
+
* Declared and loaded, with no data path that reaches it. It receives nothing, so it is a finding to resolve
|
|
84
|
+
* (remove the declaration, or build the path it was declared for) and is never published as a recipient.
|
|
85
|
+
*/
|
|
86
|
+
DECLARED_WITHOUT_DATA_PATH = "declared-without-data-path",
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** HOW data can reach a member. Each kind names the mechanism, so a reader can check the claim at its site. */
|
|
90
|
+
export enum RecipientDataPathKind {
|
|
91
|
+
/** The provider serves an engine capability this application may resolve (email, billing, an LLM, …). */
|
|
92
|
+
ENGINE_CAPABILITY = "engine-capability",
|
|
93
|
+
/** The provider declares a capability ROLE the engine wires without an engine capability (SSO, captcha, a file picker). */
|
|
94
|
+
PROVIDER_CAPABILITY = "provider-capability",
|
|
95
|
+
/** `providers.browserOperations` opens an operation to a signed-in browser. */
|
|
96
|
+
BROWSER_OPERATION = "browser-operation",
|
|
97
|
+
/**
|
|
98
|
+
* Application source imports the provider's typed client from a provider package the application owns
|
|
99
|
+
* (`<scope>/provider-<ref>`, installed from the module registry; #2018). Until #2019 it was also a subpath of the
|
|
100
|
+
* generated catalogue package, which is archived.
|
|
101
|
+
*/
|
|
102
|
+
TYPED_CLIENT = "typed-client",
|
|
103
|
+
/**
|
|
104
|
+
* The application's source was NOT scanned for typed clients, so a code path cannot be ruled out. Carried as
|
|
105
|
+
* a path rather than assumed absent: calling a vendor "reached by nothing" because nobody looked would hide a
|
|
106
|
+
* recipient, which is the direction a notice must never err in.
|
|
107
|
+
*/
|
|
108
|
+
UNSCANNED_CODE = "unscanned-code",
|
|
109
|
+
/** A declared `systemsOfRecord` instance, read with the application's own service identity. */
|
|
110
|
+
SYSTEM_OF_RECORD_INSTANCE = "system-of-record-instance",
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** One place application source imports a provider's typed client. */
|
|
114
|
+
export interface ProviderTypedClientSite {
|
|
115
|
+
readonly providerRef: string;
|
|
116
|
+
/** `path:line`, relative to the application root. */
|
|
117
|
+
readonly site: string;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
/** One way data can reach a member, and whose accounts that way can spend. */
|
|
121
|
+
export interface RecipientDataPath {
|
|
122
|
+
readonly kind: RecipientDataPathKind;
|
|
123
|
+
readonly ownerScopes: readonly ExternalProvider_Connection_OwnerScope[];
|
|
124
|
+
/** The capabilities, operation ids or source sites behind the path, so the claim can be checked. */
|
|
125
|
+
readonly detail: readonly string[];
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/** One member of the recipient population. */
|
|
129
|
+
export interface RecipientPopulationMember {
|
|
130
|
+
readonly kind: RecipientPopulationMemberKind;
|
|
131
|
+
/** The provider ref, or the system-of-record instance name. The register joins on it. */
|
|
132
|
+
readonly ref: string;
|
|
133
|
+
/** Where it is declared: `backend`, `frontendServices.app`, `systemsOfRecord`, … */
|
|
134
|
+
readonly declaredIn: readonly string[];
|
|
135
|
+
readonly populationClass: RecipientPopulationClass;
|
|
136
|
+
readonly dataPaths: readonly RecipientDataPath[];
|
|
137
|
+
/** The owner scopes some data path can spend, after the application's `providers.connections` narrowing. */
|
|
138
|
+
readonly reachableOwnerScopes: readonly ExternalProvider_Connection_OwnerScope[];
|
|
139
|
+
/** The operator's `providerComplianceChoices` entry for it, or `null` when nobody has answered. */
|
|
140
|
+
readonly deploymentModel: ProviderDeploymentModel | null;
|
|
141
|
+
/**
|
|
142
|
+
* What the provider's package declares about who runs it and where (#1708) — ESTABLISHED or UNDETERMINED — or
|
|
143
|
+
* `null` when it declares none, when the profiles were not read, or for a system-of-record instance (whose
|
|
144
|
+
* vendor is not a provider ref).
|
|
145
|
+
*/
|
|
146
|
+
readonly complianceProfile: ProviderComplianceProfile | null;
|
|
147
|
+
/** The operator's choice assessed against that profile, or `null` when there is no choice or no profiles were read. */
|
|
148
|
+
readonly complianceChoiceAssessment: ProviderComplianceChoiceAssessment | null;
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/** The whole population, and the lists every reader needs from it. Every list is sorted. */
|
|
152
|
+
export interface RecipientPopulation {
|
|
153
|
+
readonly members: readonly RecipientPopulationMember[];
|
|
154
|
+
readonly operatorRunRefs: readonly string[];
|
|
155
|
+
readonly operatorSubProcessorRefs: readonly string[];
|
|
156
|
+
readonly tenantRecipientRefs: readonly string[];
|
|
157
|
+
readonly declaredWithoutDataPathRefs: readonly string[];
|
|
158
|
+
/**
|
|
159
|
+
* Operator sub-processors with NO compliance choice: in use, reached with the operator's own account, and
|
|
160
|
+
* nobody has said who runs them or where. A tenant recipient is not listed, because who runs the tenant's own
|
|
161
|
+
* vendor is the tenant's answer, not the operator's.
|
|
162
|
+
*/
|
|
163
|
+
readonly operatorSubProcessorsWithoutComplianceChoice: readonly string[];
|
|
164
|
+
/** Providers declared ONLY under the build-time companion scope. Outside the population, named so they are never lost. */
|
|
165
|
+
readonly authoringScopeProviderRefs: readonly string[];
|
|
166
|
+
/** Compliance choices keyed by a ref no runtime member or authoring provider carries: stale answers. */
|
|
167
|
+
readonly complianceChoicesNamingNoMember: readonly string[];
|
|
168
|
+
/**
|
|
169
|
+
* Whether the providers' compliance profiles were supplied (#1708). `false` means the three lists below say
|
|
170
|
+
* nothing — the profiles were not read — which a reader must report as NOT RUN, never as "no gap".
|
|
171
|
+
*/
|
|
172
|
+
readonly complianceProfilesRead: boolean;
|
|
173
|
+
/** Every choice naming a provider member, assessed against what that provider declares possible. Empty when profiles were not read. */
|
|
174
|
+
readonly complianceChoiceAssessments: readonly ProviderComplianceChoiceAssessmentEntry[];
|
|
175
|
+
/** Operator sub-processors whose profile is UNDETERMINED: in use, and nobody has researched who runs them or where. */
|
|
176
|
+
readonly operatorSubProcessorsWithUndeterminedProfile: readonly string[];
|
|
177
|
+
/** Operator sub-processors whose provider declares no profile at all: a module that states nothing. */
|
|
178
|
+
readonly operatorSubProcessorsWithoutProfile: readonly string[];
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/** The inputs, read from the SaaS config and one source scan. Structural on purpose: every reader holds the raw config. */
|
|
182
|
+
export interface RecipientPopulationInputs {
|
|
183
|
+
/** The SaaS config's `providers` block (`scopes`, `connections`, `browserOperations`). */
|
|
184
|
+
readonly providers: unknown;
|
|
185
|
+
/** The SaaS config's `systemsOfRecord` block. */
|
|
186
|
+
readonly systemsOfRecord: unknown;
|
|
187
|
+
readonly providerComplianceChoices: ApplicationProviderComplianceChoices | undefined;
|
|
188
|
+
/**
|
|
189
|
+
* Where application source imports a typed client. `undefined` means the source was NOT scanned,
|
|
190
|
+
* which is carried as {@link RecipientDataPathKind.UNSCANNED_CODE}; an empty list means it was, and found none.
|
|
191
|
+
*/
|
|
192
|
+
readonly typedClientSites: readonly ProviderTypedClientSite[] | undefined;
|
|
193
|
+
/**
|
|
194
|
+
* What each provider's package declares about who runs it and where it processes, keyed by provider ref (#1708),
|
|
195
|
+
* read from discovery (`resolveProviderComplianceProfiles` in `@wildo-ai/platform-config-lib`). A ref absent from
|
|
196
|
+
* the map declares none. `undefined` means the profiles were NOT read, which the population carries as
|
|
197
|
+
* `complianceProfilesRead: false` rather than as "no provider declares one".
|
|
198
|
+
*/
|
|
199
|
+
readonly providerComplianceProfiles?: Readonly<Record<string, ProviderComplianceProfile>>;
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/** Directory segments whose files never run in a deployed runtime, so an import there is no data path. */
|
|
203
|
+
const NON_RUNTIME_SOURCE_SEGMENTS: ReadonlySet<string> = new Set([
|
|
204
|
+
"node_modules",
|
|
205
|
+
"dist",
|
|
206
|
+
".wildo-saas",
|
|
207
|
+
"specifications",
|
|
208
|
+
"__tests__",
|
|
209
|
+
"e2e",
|
|
210
|
+
]);
|
|
211
|
+
|
|
212
|
+
const RUNTIME_SOURCE_EXTENSION = /\.(?:[cm]?[jt]sx?)$/u;
|
|
213
|
+
const TEST_SOURCE_FILE = /\.(?:test|spec)\.[cm]?[jt]sx?$/u;
|
|
214
|
+
|
|
215
|
+
/**
|
|
216
|
+
* Whether a file (path relative to the application root) is RUNTIME source a typed-client import could run
|
|
217
|
+
* from. Tests, the companion tree, specifications and build output are not.
|
|
218
|
+
*/
|
|
219
|
+
export function isRecipientRuntimeSourcePath(path: string): boolean {
|
|
220
|
+
if (!RUNTIME_SOURCE_EXTENSION.test(path) || TEST_SOURCE_FILE.test(path)) return false;
|
|
221
|
+
return !path.split("/").some((segment) => NON_RUNTIME_SOURCE_SEGMENTS.has(segment));
|
|
222
|
+
}
|
|
223
|
+
|
|
224
|
+
/**
|
|
225
|
+
* Where an application's OWN provider packages live (#2018, epic #2012): one workspace package per facet at
|
|
226
|
+
* `providers/<ref>/<facet>/`, installed from the module registry and owned by the application. A pathspec, for
|
|
227
|
+
* the readers' `git ls-files`.
|
|
228
|
+
*/
|
|
229
|
+
export const APPLICATION_PROVIDER_PACKAGE_MANIFEST_PATHSPEC = "providers/*/*/package.json";
|
|
230
|
+
|
|
231
|
+
/** `providers/<ref>/<facet>/package.json`: the ref is the directory, never parsed out of the package name. */
|
|
232
|
+
const APPLICATION_PROVIDER_PACKAGE_MANIFEST_PATH = /^providers\/([a-z][a-z0-9-]*)\/[^/]+\/package\.json$/u;
|
|
233
|
+
|
|
234
|
+
/**
|
|
235
|
+
* Package name → provider ref, for every provider package the application owns, from its manifests.
|
|
236
|
+
*
|
|
237
|
+
* A provider copied into the application (#2012) is imported by ITS package name (`@<app>/provider-<ref>` for
|
|
238
|
+
* the backend facet, `@<app>/provider-<ref>-frontend` for the browser facet). The ref is read from the directory
|
|
239
|
+
* the package lives in, because parsing it out of the name would read `provider-asana-frontend` as a provider called `asana-frontend`. Both facets map to
|
|
240
|
+
* the ref: a browser facet reaches the vendor too.
|
|
241
|
+
*
|
|
242
|
+
* `manifests` are `{ path, content }` with paths relative to the application root; a path outside the layout,
|
|
243
|
+
* or a manifest with no readable `name`, contributes nothing.
|
|
244
|
+
*/
|
|
245
|
+
export function applicationProviderPackagesFromManifests(manifests: ReadonlyArray<{ path: string; content: string }>): ReadonlyMap<string, string> {
|
|
246
|
+
const packages = new Map<string, string>();
|
|
247
|
+
for (const manifest of manifests) {
|
|
248
|
+
const ref = APPLICATION_PROVIDER_PACKAGE_MANIFEST_PATH.exec(manifest.path)?.[1];
|
|
249
|
+
if (ref === undefined) continue;
|
|
250
|
+
let name: unknown;
|
|
251
|
+
try {
|
|
252
|
+
name = (JSON.parse(manifest.content) as { name?: unknown }).name;
|
|
253
|
+
} catch {
|
|
254
|
+
continue;
|
|
255
|
+
}
|
|
256
|
+
if (typeof name === "string" && name.length > 0) packages.set(name, ref);
|
|
257
|
+
}
|
|
258
|
+
return packages;
|
|
259
|
+
}
|
|
260
|
+
|
|
261
|
+
/**
|
|
262
|
+
* The fixed strings a reader's `git grep -F` must search for: each provider package the application owns (#2018).
|
|
263
|
+
*
|
|
264
|
+
* EMPTY when the application owns none, and a reader must then record a scan that found nothing rather than run
|
|
265
|
+
* `git grep` with no `-e`: `git grep -n -F -- .` reads the pathspec `.` as the PATTERN and answers every line
|
|
266
|
+
* holding a dot, a whole-tree dump for an application that provably has no typed client to import. Since #2019 archived the
|
|
267
|
+
* generated catalogue, an owned provider package is the only place a typed client comes from.
|
|
268
|
+
*/
|
|
269
|
+
export function typedClientSearchNeedles(applicationProviderPackages: ReadonlyMap<string, string> = new Map()): readonly string[] {
|
|
270
|
+
return [...applicationProviderPackages.keys()].sort();
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
/**
|
|
274
|
+
* The provider refs an import in one line of source names: any provider package the application owns
|
|
275
|
+
* (`applicationProviderPackages`, name → ref), by its name or a subpath of it.
|
|
276
|
+
*
|
|
277
|
+
* Matches an import SPECIFIER (`from '…'`, `import '…'`, `import('…')`, `require('…')`), never a bare mention,
|
|
278
|
+
* so a comment naming the package is not read as a path.
|
|
279
|
+
*/
|
|
280
|
+
export function providerRefsImportedByTypedClient(
|
|
281
|
+
sourceLine: string,
|
|
282
|
+
applicationProviderPackages: ReadonlyMap<string, string> = new Map(),
|
|
283
|
+
): readonly string[] {
|
|
284
|
+
const refs: string[] = [];
|
|
285
|
+
if (applicationProviderPackages.size > 0) {
|
|
286
|
+
const scoped = /\b(?:from|import|require)\s*\(?\s*["'](@[a-z0-9][a-z0-9._-]*\/[a-z0-9][a-z0-9._-]*)(?:\/[^"']*)?["']/gu;
|
|
287
|
+
for (const match of sourceLine.matchAll(scoped)) {
|
|
288
|
+
const ref = match[1] === undefined ? undefined : applicationProviderPackages.get(match[1]);
|
|
289
|
+
if (ref !== undefined) refs.push(ref);
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
return refs;
|
|
293
|
+
}
|
|
294
|
+
|
|
295
|
+
/**
|
|
296
|
+
* Typed-client sites from `git grep -n` output lines (`path:line:content`), paths relative to the application
|
|
297
|
+
* root. Every reader feeds its own grep here so they cannot disagree about what a line means; the collector
|
|
298
|
+
* greps the committed HEAD and the companion and the CLI the working tree, which is the only difference.
|
|
299
|
+
*/
|
|
300
|
+
export function typedClientSitesFromGrepLines(
|
|
301
|
+
lines: readonly string[],
|
|
302
|
+
applicationProviderPackages: ReadonlyMap<string, string> = new Map(),
|
|
303
|
+
): readonly ProviderTypedClientSite[] {
|
|
304
|
+
const sites: ProviderTypedClientSite[] = [];
|
|
305
|
+
for (const line of lines) {
|
|
306
|
+
const match = /^(.+?):(\d+):(.*)$/u.exec(line);
|
|
307
|
+
if (match === null) continue;
|
|
308
|
+
const [, path, lineNumber, content] = match;
|
|
309
|
+
if (path === undefined || content === undefined || !isRecipientRuntimeSourcePath(path)) continue;
|
|
310
|
+
for (const providerRef of providerRefsImportedByTypedClient(content, applicationProviderPackages)) sites.push({ providerRef, site: `${path}:${lineNumber}` });
|
|
311
|
+
}
|
|
312
|
+
return sites;
|
|
313
|
+
}
|
|
314
|
+
|
|
315
|
+
type UnknownRecord = Readonly<Record<string, unknown>>;
|
|
316
|
+
|
|
317
|
+
function asRecord(value: unknown): UnknownRecord | undefined {
|
|
318
|
+
return value !== null && typeof value === "object" && !Array.isArray(value) ? (value as UnknownRecord) : undefined;
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
function stringArray(value: unknown): readonly string[] {
|
|
322
|
+
return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === "string") : [];
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
const ALL_OWNER_SCOPES: readonly ExternalProvider_Connection_OwnerScope[] = Object.values(ExternalProvider_Connection_OwnerScope);
|
|
326
|
+
|
|
327
|
+
function isOwnerScope(value: unknown): value is ExternalProvider_Connection_OwnerScope {
|
|
328
|
+
return ALL_OWNER_SCOPES.includes(value as ExternalProvider_Connection_OwnerScope);
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
function ownerScopesOfConnections(connections: unknown): readonly ExternalProvider_Connection_OwnerScope[] {
|
|
332
|
+
if (!Array.isArray(connections)) return [];
|
|
333
|
+
return [...new Set(connections.map((shape) => asRecord(shape)?.ownerScope).filter(isOwnerScope))];
|
|
334
|
+
}
|
|
335
|
+
|
|
336
|
+
/**
|
|
337
|
+
* Every `(scope path, provider ref, provider declaration)` under `providers.scopes`, grouped scopes included.
|
|
338
|
+
* A scope value either carries `providers` itself (`backend`, `companion`) or is a map of named runtimes that
|
|
339
|
+
* each do (`frontendServices`, `minions`, `workers`).
|
|
340
|
+
*/
|
|
341
|
+
function declaredProviderEntries(providers: unknown): readonly { scopePath: string; scopeKey: string; ref: string; declaration: UnknownRecord }[] {
|
|
342
|
+
const entries: { scopePath: string; scopeKey: string; ref: string; declaration: UnknownRecord }[] = [];
|
|
343
|
+
const scopes = asRecord(asRecord(providers)?.scopes) ?? {};
|
|
344
|
+
const collect = (scopeKey: string, scopePath: string, scope: UnknownRecord): void => {
|
|
345
|
+
for (const [ref, declaration] of Object.entries(asRecord(scope.providers) ?? {})) {
|
|
346
|
+
const record = asRecord(declaration);
|
|
347
|
+
if (record !== undefined) entries.push({ scopePath, scopeKey, ref, declaration: record });
|
|
348
|
+
}
|
|
349
|
+
};
|
|
350
|
+
for (const [scopeKey, value] of Object.entries(scopes)) {
|
|
351
|
+
const scope = asRecord(value);
|
|
352
|
+
if (scope === undefined) continue;
|
|
353
|
+
if (asRecord(scope.providers) !== undefined) {
|
|
354
|
+
collect(scopeKey, scopeKey, scope);
|
|
355
|
+
continue;
|
|
356
|
+
}
|
|
357
|
+
for (const [runtimeName, runtimeScope] of Object.entries(scope)) {
|
|
358
|
+
const runtime = asRecord(runtimeScope);
|
|
359
|
+
if (runtime !== undefined) collect(scopeKey, `${scopeKey}.${runtimeName}`, runtime);
|
|
360
|
+
}
|
|
361
|
+
}
|
|
362
|
+
return entries;
|
|
363
|
+
}
|
|
364
|
+
|
|
365
|
+
const sorted = (values: Iterable<string>): string[] => [...new Set(values)].sort();
|
|
366
|
+
|
|
367
|
+
/**
|
|
368
|
+
* Classify every runtime-scoped provider and every system-of-record instance. See the module documentation for
|
|
369
|
+
* the axes and the limits; the class order is: operator-run, then no data path, then operator sub-processor
|
|
370
|
+
* (some path spends an application-owned account), then tenant recipient.
|
|
371
|
+
*/
|
|
372
|
+
export function computeRecipientPopulation(inputs: RecipientPopulationInputs): RecipientPopulation {
|
|
373
|
+
const choices = inputs.providerComplianceChoices ?? {};
|
|
374
|
+
const profiles = inputs.providerComplianceProfiles;
|
|
375
|
+
const providersBlock = asRecord(inputs.providers);
|
|
376
|
+
const connectionPolicies = asRecord(providersBlock?.connections) ?? {};
|
|
377
|
+
const browserOperations = asRecord(providersBlock?.browserOperations) ?? {};
|
|
378
|
+
|
|
379
|
+
/** What the application admits for a provider: its `providers.connections` narrowing, or every owner scope. */
|
|
380
|
+
const admittedOwnerScopes = (ref: string): readonly ExternalProvider_Connection_OwnerScope[] => {
|
|
381
|
+
const policy = asRecord(connectionPolicies[ref]);
|
|
382
|
+
return policy === undefined ? ALL_OWNER_SCOPES : ownerScopesOfConnections(policy.admissible);
|
|
383
|
+
};
|
|
384
|
+
|
|
385
|
+
const runtimeDeclarations = new Map<string, { declaredIn: string[]; engineCapabilities: Set<string>; providerCapabilities: Set<string> }>();
|
|
386
|
+
const authoringRefs = new Set<string>();
|
|
387
|
+
for (const entry of declaredProviderEntries(inputs.providers)) {
|
|
388
|
+
if (entry.scopeKey === ProviderScopeKey.COMPANION) {
|
|
389
|
+
authoringRefs.add(entry.ref);
|
|
390
|
+
continue;
|
|
391
|
+
}
|
|
392
|
+
const current = runtimeDeclarations.get(entry.ref) ?? { declaredIn: [], engineCapabilities: new Set<string>(), providerCapabilities: new Set<string>() };
|
|
393
|
+
current.declaredIn.push(entry.scopePath);
|
|
394
|
+
for (const capability of stringArray(entry.declaration.engineCapabilities)) current.engineCapabilities.add(capability);
|
|
395
|
+
for (const capability of stringArray(entry.declaration.providerCapabilities)) current.providerCapabilities.add(capability);
|
|
396
|
+
runtimeDeclarations.set(entry.ref, current);
|
|
397
|
+
}
|
|
398
|
+
|
|
399
|
+
const sitesByRef = new Map<string, string[]>();
|
|
400
|
+
for (const site of inputs.typedClientSites ?? []) sitesByRef.set(site.providerRef, [...(sitesByRef.get(site.providerRef) ?? []), site.site]);
|
|
401
|
+
|
|
402
|
+
// The operator's answer only: a profile states possibilities, never the choice (see the module documentation).
|
|
403
|
+
const deploymentModelOf = (ref: string): ProviderDeploymentModel | null => choices[ref]?.deploymentModel ?? null;
|
|
404
|
+
|
|
405
|
+
const classify = (ref: string, dataPaths: readonly RecipientDataPath[], admitted: readonly ExternalProvider_Connection_OwnerScope[]): {
|
|
406
|
+
populationClass: RecipientPopulationClass;
|
|
407
|
+
reachableOwnerScopes: readonly ExternalProvider_Connection_OwnerScope[];
|
|
408
|
+
} => {
|
|
409
|
+
const reachable = ALL_OWNER_SCOPES.filter((scope) => admitted.includes(scope) && dataPaths.some((path) => path.ownerScopes.includes(scope)));
|
|
410
|
+
if (deploymentModelOf(ref) === ProviderDeploymentModel.SELF_HOSTED) return { populationClass: RecipientPopulationClass.OPERATOR_RUN, reachableOwnerScopes: reachable };
|
|
411
|
+
if (reachable.length === 0) return { populationClass: RecipientPopulationClass.DECLARED_WITHOUT_DATA_PATH, reachableOwnerScopes: reachable };
|
|
412
|
+
if (reachable.includes(ExternalProvider_Connection_OwnerScope.APPLICATION)) {
|
|
413
|
+
return { populationClass: RecipientPopulationClass.OPERATOR_SUB_PROCESSOR, reachableOwnerScopes: reachable };
|
|
414
|
+
}
|
|
415
|
+
return { populationClass: RecipientPopulationClass.TENANT_RECIPIENT, reachableOwnerScopes: reachable };
|
|
416
|
+
};
|
|
417
|
+
|
|
418
|
+
const members: RecipientPopulationMember[] = [];
|
|
419
|
+
for (const [ref, declaration] of runtimeDeclarations) {
|
|
420
|
+
const admitted = admittedOwnerScopes(ref);
|
|
421
|
+
const dataPaths: RecipientDataPath[] = [];
|
|
422
|
+
// An engine capability is resolved by the engine with the application's own provider account.
|
|
423
|
+
if (declaration.engineCapabilities.size > 0) {
|
|
424
|
+
dataPaths.push({ kind: RecipientDataPathKind.ENGINE_CAPABILITY, ownerScopes: [ExternalProvider_Connection_OwnerScope.APPLICATION], detail: sorted(declaration.engineCapabilities) });
|
|
425
|
+
}
|
|
426
|
+
// A capability role (SSO, captcha, a file picker) is wired by the engine under the application's own registration.
|
|
427
|
+
// Only the roles NO declared engine capability already covers: a provider serving `AI_LLM` and signing people in
|
|
428
|
+
// (`LLM_CHAT` + `SSO_OAUTH2`) reaches the vendor through both, and dropping the second would under-state what the
|
|
429
|
+
// vendor receives (#1709 review).
|
|
430
|
+
// With engine capabilities declared, a provider capability that fills an engine slot is reached only if that slot
|
|
431
|
+
// is declared (and then that slot's engine-capability path carries it), and only a slot-less role adds a path here.
|
|
432
|
+
// With NONE declared, every provider capability counts, slot-filling or not: no engine path carries it, and
|
|
433
|
+
// counting it errs toward naming a recipient.
|
|
434
|
+
const roleCapabilities = declaration.engineCapabilities.size === 0
|
|
435
|
+
? [...declaration.providerCapabilities]
|
|
436
|
+
: [...declaration.providerCapabilities].filter((capability) =>
|
|
437
|
+
(PROVIDER_CAPABILITY_TO_ENGINE_CAPABILITY as Readonly<Record<string, string | undefined>>)[capability] === undefined);
|
|
438
|
+
if (roleCapabilities.length > 0) {
|
|
439
|
+
dataPaths.push({ kind: RecipientDataPathKind.PROVIDER_CAPABILITY, ownerScopes: [ExternalProvider_Connection_OwnerScope.APPLICATION], detail: sorted(roleCapabilities) });
|
|
440
|
+
}
|
|
441
|
+
const operations = asRecord(browserOperations[ref]) ?? {};
|
|
442
|
+
const operationOwnerScopes = new Set<ExternalProvider_Connection_OwnerScope>();
|
|
443
|
+
for (const policy of Object.values(operations)) for (const scope of ownerScopesOfConnections(asRecord(policy)?.connections)) operationOwnerScopes.add(scope);
|
|
444
|
+
if (Object.keys(operations).length > 0) {
|
|
445
|
+
dataPaths.push({ kind: RecipientDataPathKind.BROWSER_OPERATION, ownerScopes: [...operationOwnerScopes], detail: sorted(Object.keys(operations)) });
|
|
446
|
+
}
|
|
447
|
+
// A typed-client call names its connection at run time, so it can spend any account the application admits.
|
|
448
|
+
if (inputs.typedClientSites === undefined) {
|
|
449
|
+
if (dataPaths.length === 0) dataPaths.push({ kind: RecipientDataPathKind.UNSCANNED_CODE, ownerScopes: admitted, detail: [] });
|
|
450
|
+
} else {
|
|
451
|
+
const sites = sitesByRef.get(ref);
|
|
452
|
+
if (sites !== undefined) dataPaths.push({ kind: RecipientDataPathKind.TYPED_CLIENT, ownerScopes: admitted, detail: sorted(sites) });
|
|
453
|
+
}
|
|
454
|
+
const { populationClass, reachableOwnerScopes } = classify(ref, dataPaths, admitted);
|
|
455
|
+
const complianceProfile = profiles?.[ref] ?? null;
|
|
456
|
+
const choice = choices[ref];
|
|
457
|
+
members.push({
|
|
458
|
+
kind: RecipientPopulationMemberKind.CONFIGURED_PROVIDER,
|
|
459
|
+
ref,
|
|
460
|
+
declaredIn: sorted(declaration.declaredIn),
|
|
461
|
+
populationClass,
|
|
462
|
+
dataPaths,
|
|
463
|
+
reachableOwnerScopes,
|
|
464
|
+
deploymentModel: deploymentModelOf(ref),
|
|
465
|
+
complianceProfile,
|
|
466
|
+
complianceChoiceAssessment: profiles === undefined || choice === undefined ? null : assessProviderComplianceChoice(choice, complianceProfile),
|
|
467
|
+
});
|
|
468
|
+
}
|
|
469
|
+
|
|
470
|
+
for (const [name, declaration] of Object.entries(asRecord(inputs.systemsOfRecord) ?? {})) {
|
|
471
|
+
const vendor = asRecord(declaration)?.vendor;
|
|
472
|
+
const dataPaths: RecipientDataPath[] = [{
|
|
473
|
+
kind: RecipientDataPathKind.SYSTEM_OF_RECORD_INSTANCE,
|
|
474
|
+
ownerScopes: [ExternalProvider_Connection_OwnerScope.APPLICATION],
|
|
475
|
+
detail: typeof vendor === "string" ? [`vendor ${vendor}`] : [],
|
|
476
|
+
}];
|
|
477
|
+
const { populationClass, reachableOwnerScopes } = classify(name, dataPaths, ALL_OWNER_SCOPES);
|
|
478
|
+
members.push({
|
|
479
|
+
kind: RecipientPopulationMemberKind.SYSTEM_OF_RECORD,
|
|
480
|
+
ref: name,
|
|
481
|
+
declaredIn: ["systemsOfRecord"],
|
|
482
|
+
populationClass,
|
|
483
|
+
dataPaths,
|
|
484
|
+
reachableOwnerScopes,
|
|
485
|
+
deploymentModel: deploymentModelOf(name),
|
|
486
|
+
complianceProfile: null,
|
|
487
|
+
complianceChoiceAssessment: null,
|
|
488
|
+
});
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
members.sort((left, right) => (left.ref === right.ref ? left.kind.localeCompare(right.kind) : left.ref.localeCompare(right.ref)));
|
|
492
|
+
const refsOf = (populationClass: RecipientPopulationClass): string[] => sorted(members.filter((member) => member.populationClass === populationClass).map((member) => member.ref));
|
|
493
|
+
const memberRefs = new Set(members.map((member) => member.ref));
|
|
494
|
+
return {
|
|
495
|
+
members,
|
|
496
|
+
operatorRunRefs: refsOf(RecipientPopulationClass.OPERATOR_RUN),
|
|
497
|
+
operatorSubProcessorRefs: refsOf(RecipientPopulationClass.OPERATOR_SUB_PROCESSOR),
|
|
498
|
+
tenantRecipientRefs: refsOf(RecipientPopulationClass.TENANT_RECIPIENT),
|
|
499
|
+
declaredWithoutDataPathRefs: refsOf(RecipientPopulationClass.DECLARED_WITHOUT_DATA_PATH),
|
|
500
|
+
operatorSubProcessorsWithoutComplianceChoice: sorted(members
|
|
501
|
+
.filter((member) => member.populationClass === RecipientPopulationClass.OPERATOR_SUB_PROCESSOR && member.deploymentModel === null)
|
|
502
|
+
.map((member) => member.ref)),
|
|
503
|
+
authoringScopeProviderRefs: sorted([...authoringRefs].filter((ref) => !memberRefs.has(ref))),
|
|
504
|
+
complianceChoicesNamingNoMember: sorted(Object.keys(choices).filter((ref) => !memberRefs.has(ref) && !authoringRefs.has(ref))),
|
|
505
|
+
...complianceProfileFindings(members, choices, profiles),
|
|
506
|
+
};
|
|
507
|
+
}
|
|
508
|
+
|
|
509
|
+
/**
|
|
510
|
+
* The #1708 half of the population: each provider member's profile against the operator's choice. Kept apart from
|
|
511
|
+
* the class computation on purpose — a profile never changes who is a recipient (the operator's choice decides
|
|
512
|
+
* that, per the choice schema), it only says whether the choice can be checked and what research is owed.
|
|
513
|
+
*/
|
|
514
|
+
function complianceProfileFindings(
|
|
515
|
+
members: readonly RecipientPopulationMember[],
|
|
516
|
+
choices: ApplicationProviderComplianceChoices,
|
|
517
|
+
profiles: Readonly<Record<string, ProviderComplianceProfile>> | undefined,
|
|
518
|
+
): Pick<RecipientPopulation, "complianceProfilesRead" | "complianceChoiceAssessments" | "operatorSubProcessorsWithUndeterminedProfile" | "operatorSubProcessorsWithoutProfile"> {
|
|
519
|
+
if (profiles === undefined) {
|
|
520
|
+
return { complianceProfilesRead: false, complianceChoiceAssessments: [], operatorSubProcessorsWithUndeterminedProfile: [], operatorSubProcessorsWithoutProfile: [] };
|
|
521
|
+
}
|
|
522
|
+
const providerMembers = members.filter((member) => member.kind === RecipientPopulationMemberKind.CONFIGURED_PROVIDER);
|
|
523
|
+
const providerRefs = new Set(providerMembers.map((member) => member.ref));
|
|
524
|
+
const subProcessors = providerMembers.filter((member) => member.populationClass === RecipientPopulationClass.OPERATOR_SUB_PROCESSOR);
|
|
525
|
+
return {
|
|
526
|
+
complianceProfilesRead: true,
|
|
527
|
+
complianceChoiceAssessments: assessProviderComplianceChoices({
|
|
528
|
+
choices: Object.fromEntries(Object.entries(choices).filter(([ref]) => providerRefs.has(ref))),
|
|
529
|
+
profilesByProviderRef: profiles,
|
|
530
|
+
}),
|
|
531
|
+
operatorSubProcessorsWithUndeterminedProfile: sorted(subProcessors
|
|
532
|
+
.filter((member) => member.complianceProfile?.determination === ProviderComplianceDetermination.UNDETERMINED)
|
|
533
|
+
.map((member) => member.ref)),
|
|
534
|
+
operatorSubProcessorsWithoutProfile: sorted(subProcessors.filter((member) => member.complianceProfile === null).map((member) => member.ref)),
|
|
535
|
+
};
|
|
536
|
+
}
|
|
537
|
+
|
|
538
|
+
/** The population joined to the operator's processor register. Every list is sorted. */
|
|
539
|
+
export interface RecipientRegisterJoin {
|
|
540
|
+
/** Operator sub-processors the register does not establish: in use, identity not established. */
|
|
541
|
+
readonly undeclaredProviderRefs: readonly string[];
|
|
542
|
+
/** Register entries naming a ref that is no operator sub-processor and no tenant recipient: they receive nothing from this operator. */
|
|
543
|
+
readonly staleProviderRefs: readonly string[];
|
|
544
|
+
/**
|
|
545
|
+
* Register entries naming a TENANT recipient. The operator did not engage that vendor, so listing it as the
|
|
546
|
+
* operator's sub-processor is a false statement.
|
|
547
|
+
*/
|
|
548
|
+
readonly registeredTenantRecipientRefs: readonly string[];
|
|
549
|
+
readonly operatorRunProviderRefs: readonly string[];
|
|
550
|
+
readonly tenantRecipientRefs: readonly string[];
|
|
551
|
+
readonly declaredWithoutDataPathRefs: readonly string[];
|
|
552
|
+
}
|
|
553
|
+
|
|
554
|
+
/**
|
|
555
|
+
* Join the population to the register, in both directions.
|
|
556
|
+
*
|
|
557
|
+
* Only the register's CONFIGURED-PROVIDER arm joins: an authored entry (the operator's hosting company) is by
|
|
558
|
+
* construction absent from every configuration, so reading it as stale would drown the real gaps.
|
|
559
|
+
*/
|
|
560
|
+
export function joinRecipientPopulationToRegister(
|
|
561
|
+
population: RecipientPopulation,
|
|
562
|
+
register: ApplicationProcessorRegister | undefined,
|
|
563
|
+
): RecipientRegisterJoin {
|
|
564
|
+
const registered = new Set((register?.processors ?? [])
|
|
565
|
+
.flatMap((processor) => (processor.kind === ProcessorRegisterEntryKind.CONFIGURED_PROVIDER ? [processor.providerRef] : [])));
|
|
566
|
+
const subProcessors = new Set(population.operatorSubProcessorRefs);
|
|
567
|
+
const tenantRecipients = new Set(population.tenantRecipientRefs);
|
|
568
|
+
return {
|
|
569
|
+
undeclaredProviderRefs: population.operatorSubProcessorRefs.filter((ref) => !registered.has(ref)),
|
|
570
|
+
staleProviderRefs: sorted([...registered].filter((ref) => !subProcessors.has(ref) && !tenantRecipients.has(ref))),
|
|
571
|
+
registeredTenantRecipientRefs: sorted([...registered].filter((ref) => tenantRecipients.has(ref))),
|
|
572
|
+
operatorRunProviderRefs: population.operatorRunRefs,
|
|
573
|
+
tenantRecipientRefs: population.tenantRecipientRefs,
|
|
574
|
+
declaredWithoutDataPathRefs: population.declaredWithoutDataPathRefs,
|
|
575
|
+
};
|
|
576
|
+
}
|
|
577
|
+
```
|