@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
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: website-section-contact
|
|
3
|
-
description: Author a Contact section that renders the engine's `InboundContactForm`, submitting an `InboundContact` through the site's `WebsiteAnonymousSessionClient`. Use `defineWebsiteSection({ category: WebsiteSectionCategory.CONTACT, … })`. Use when the user says "add a contact section", "wire a contact form to inbound contacts", "compose a contact-us section with email
|
|
3
|
+
description: Author a Contact section that renders the engine's `InboundContactForm`, submitting an `InboundContact` through the site's `WebsiteAnonymousSessionClient`. Use `defineWebsiteSection({ category: WebsiteSectionCategory.CONTACT, … })`. Use when the user says "add a contact section", "wire a contact form to inbound contacts", "compose a contact-us section with an email field", or "build a sales-contact landing form".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Website Section: Contact
|
|
@@ -102,7 +103,8 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
|
|
|
102
103
|
## Section definition (the contract `defineWebsiteSection` produces)
|
|
103
104
|
|
|
104
105
|
The schema declares the **observable contract** the page-manifest
|
|
105
|
-
registration, label-pack validator, and
|
|
106
|
+
registration, the label-pack validator, `renderPageStructuredData` and
|
|
107
|
+
the structured-data audit depend on. The
|
|
106
108
|
factory layer adds type-preserving generics on top so JSX usage keeps
|
|
107
109
|
compile-time prop checking.
|
|
108
110
|
|
|
@@ -121,7 +123,8 @@ compile-time prop checking.
|
|
|
121
123
|
* `core/define-website-section.tsx` module in Phase 2 because it carries
|
|
122
124
|
* React types in its inputs). The shape is declared in `schemas/`
|
|
123
125
|
* because it is the **observable contract** the page-manifest
|
|
124
|
-
* registration, label-pack validator, and
|
|
126
|
+
* registration, the label-pack validator, `renderPageStructuredData` and the
|
|
127
|
+
* structured-data audit depend on.
|
|
125
128
|
*
|
|
126
129
|
* **Shape rationale** (each field carries semantic weight — see
|
|
127
130
|
* `design-philosophy.mdc`):
|
|
@@ -131,7 +134,8 @@ compile-time prop checking.
|
|
|
131
134
|
* (a section can be reused with the same `sectionRef` across pages
|
|
132
135
|
* when its label-key root is intentionally shared).
|
|
133
136
|
* - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
|
|
134
|
-
* for
|
|
137
|
+
* for skill-mapping and analytics labelling. It does NOT select the
|
|
138
|
+
* section's structured data.
|
|
135
139
|
* - `expectedLabelKeys` — the **fully-composed** label keys the section
|
|
136
140
|
* commits to consuming. The plan originally proposed leaf-relative
|
|
137
141
|
* keys (`'headline'`) resolved at runtime against the
|
|
@@ -144,9 +148,13 @@ compile-time prop checking.
|
|
|
144
148
|
* graph — `wildo website audit` can list a page's required keys
|
|
145
149
|
* without booting React.
|
|
146
150
|
* 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
|
|
147
|
-
* survive
|
|
148
|
-
*
|
|
149
|
-
* `expectedLabelKeys
|
|
151
|
+
* survive — the hook composes the leaf with the page+section
|
|
152
|
+
* context and looks the result up in the active pack. It does
|
|
153
|
+
* NOT check the key against `expectedLabelKeys`: a leaf the
|
|
154
|
+
* section never declared renders its key (with a console warning)
|
|
155
|
+
* and is caught by nothing until a reviewer reads the page. The
|
|
156
|
+
* build and `wildo website audit` check the pack against the
|
|
157
|
+
* DECLARED keys, so declare every slot the component reads.
|
|
150
158
|
* - `Component` — the React component that renders the section. Typed
|
|
151
159
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
152
160
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -156,8 +164,9 @@ compile-time prop checking.
|
|
|
156
164
|
* - `getStructuredData?` — optional pure function the SEO/AEO/GEO
|
|
157
165
|
* builder library invokes at static-build time to materialize JSON-LD
|
|
158
166
|
* for the section. The return type is intentionally `unknown` here;
|
|
159
|
-
*
|
|
160
|
-
* `
|
|
167
|
+
* nothing narrows it by `category` — the section returns whatever
|
|
168
|
+
* vocabulary it emits, and `wildo website audit` reconciles that
|
|
169
|
+
* against the application's Schema.org catalog.
|
|
161
170
|
*
|
|
162
171
|
* **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
|
|
163
172
|
* cannot meaningfully validate "is a React component" beyond
|
|
@@ -304,9 +313,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
|
|
|
304
313
|
* **Why a factory instead of constructing the literal directly**:
|
|
305
314
|
* - Consumers don't have to remember to parse refs / keys
|
|
306
315
|
* themselves before assembling the literal.
|
|
307
|
-
* - The schema parse provides a single audited validation chokepoint
|
|
308
|
-
*
|
|
309
|
-
* without re-entering the React graph.
|
|
316
|
+
* - The schema parse provides a single audited validation chokepoint,
|
|
317
|
+
* and the parsed `expectedLabelKeys` are what `wildo website audit`
|
|
318
|
+
* checks every locale pack against, without re-entering the React graph.
|
|
310
319
|
* - The factory is the documented authoring API the
|
|
311
320
|
* `website_factory_authoring` skill targets — keeping the
|
|
312
321
|
* authoring surface narrow lets the framework evolve the
|
|
@@ -603,8 +612,11 @@ WebsiteSection.displayName = 'WebsiteSection';
|
|
|
603
612
|
|
|
604
613
|
## Overview
|
|
605
614
|
|
|
606
|
-
A Contact section is the canonical lead-capture surface:
|
|
607
|
-
|
|
615
|
+
A Contact section is the canonical lead-capture surface: email, first
|
|
616
|
+
and last name, phone and an optional marketing opt-in →
|
|
617
|
+
`InboundContact` CREATE call. The form has no topic and no message
|
|
618
|
+
field; a form that needs them is a custom one built with
|
|
619
|
+
`website-inbound-contact-forms`. The
|
|
608
620
|
section is **interactive** (a React island under the Astro adapter)
|
|
609
621
|
and depends on:
|
|
610
622
|
|
|
@@ -622,9 +634,9 @@ and depends on:
|
|
|
622
634
|
(`privacy.consentedPurposes`), not by the site's visitor consent panel
|
|
623
635
|
— see `website-consent-gate-overrides`.
|
|
624
636
|
|
|
625
|
-
|
|
637
|
+
What the category does — and, for structured data, does not — decide:
|
|
626
638
|
|
|
627
|
-
1. **SEO/AEO/GEO
|
|
639
|
+
1. **SEO/AEO/GEO** — `category: CONTACT` does not own a
|
|
628
640
|
dedicated JSON-LD vocabulary in the framework. (`ContactPoint`
|
|
629
641
|
under page-level `Organization` is the standard placement.)
|
|
630
642
|
2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.CONTACT`.
|
|
@@ -635,13 +647,13 @@ The category drives:
|
|
|
635
647
|
|
|
636
648
|
| Surface | Glob (relative to app root) |
|
|
637
649
|
|---|---|
|
|
638
|
-
| Section component + factory call | `website/src/sections
|
|
650
|
+
| Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
|
|
639
651
|
| Page composition | `website/src/pages-impl/contact.page.tsx` |
|
|
640
652
|
| Label pack (per locale) | `website/src/i18n/<locale>.json` |
|
|
641
653
|
|
|
642
654
|
## When to Use
|
|
643
655
|
|
|
644
|
-
- Visitor lead capture (
|
|
656
|
+
- Visitor lead capture (email, name, phone, marketing opt-in).
|
|
645
657
|
- Form posts directly into `InboundContact` (no third-party form
|
|
646
658
|
service, no manual email forwarding).
|
|
647
659
|
- The marketing site needs the cross-app anonymous-session UUID +
|
|
@@ -662,8 +674,8 @@ The category drives:
|
|
|
662
674
|
|
|
663
675
|
### Step 1: Decide the form's typed shape
|
|
664
676
|
|
|
665
|
-
Beyond the
|
|
666
|
-
you may extend `marketingMetadata.extra` with ICP-specific fields
|
|
677
|
+
Beyond the form's own fields (email, first and last name, phone and
|
|
678
|
+
the marketing opt-in), you may extend `marketingMetadata.extra` with ICP-specific fields
|
|
667
679
|
(company size, industry, etc.) — see
|
|
668
680
|
`website-marketing-metadata-extension`.
|
|
669
681
|
|
|
@@ -677,6 +689,15 @@ visible misconfiguration message when it is absent.
|
|
|
677
689
|
|
|
678
690
|
### Step 3: Label every field, and word the opt-in as a real choice
|
|
679
691
|
|
|
692
|
+
`InboundContactForm` carries no words of its own: every entry of
|
|
693
|
+
`InboundContactFormLabels` is required — field labels, the submit and
|
|
694
|
+
sending states, the success, error and anti-spam refusal notes, and the
|
|
695
|
+
sentence shown beside an invalid email address. Resolve each one with
|
|
696
|
+
`useWebsiteLabel` and list its key in `expectedLabelKeys`. Leaving one
|
|
697
|
+
out is a type error in your section, and a key your pack does not carry
|
|
698
|
+
renders as the key itself, so a missing label is visible rather than
|
|
699
|
+
silently English.
|
|
700
|
+
|
|
680
701
|
`marketingConsentLabel` is a separate, unticked checkbox. Word it as the
|
|
681
702
|
purpose it grants ("Keep me updated about news and offers"), never as a
|
|
682
703
|
condition of sending the form.
|
|
@@ -686,11 +707,11 @@ condition of sending the form.
|
|
|
686
707
|
The page lives at `/contact` (typically) with this section as the
|
|
687
708
|
sole or primary band.
|
|
688
709
|
|
|
689
|
-
**Stop** after the contact form mounts in dev and submits
|
|
690
|
-
|
|
710
|
+
**Stop** after the contact form mounts in dev and submits an
|
|
711
|
+
`InboundContact` through the shared client; if the
|
|
691
712
|
`expectedLabelKeys` audit fails (label-pack validator), **return
|
|
692
|
-
to Step 3** — every form
|
|
693
|
-
|
|
713
|
+
to Step 3** — every one of the form's labels is a leaf of your
|
|
714
|
+
section's pack, and a missing leaf renders as the key string.
|
|
694
715
|
|
|
695
716
|
## Structured data (AEO)
|
|
696
717
|
|
|
@@ -705,7 +726,7 @@ instead of inventing a section-local payload.
|
|
|
705
726
|
routing metadata, or speculative `ContactPoint` payloads not backed by
|
|
706
727
|
the current catalog.
|
|
707
728
|
- **Verification grep**:
|
|
708
|
-
`rg -n "getStructuredData|contactPoint" website/src/sections
|
|
729
|
+
`rg -n "getStructuredData|contactPoint" website/src/sections/<page>.sections.tsx`
|
|
709
730
|
(should usually return 0 today unless the page-level entity explicitly
|
|
710
731
|
owns the contact data).
|
|
711
732
|
|
|
@@ -725,7 +746,7 @@ Contact-section authoring contributes the engagement-routing sentence in
|
|
|
725
746
|
|
|
726
747
|
<!-- TIER C WAIVER: the dogfood contact section is the source of this shape, but it is not yet anchored; it shows the three pillars Workflow Steps 1–3 enumerate (a shared `WebsiteAnonymousSessionClient`, `InboundContactForm` with injected labels, and `defineWebsiteSection` with the section's `expectedLabelKeys`). Keep it as Tier C until the application usage is anchored. -->
|
|
727
748
|
```tsx
|
|
728
|
-
// website/src/sections
|
|
749
|
+
// website/src/sections/<page>.sections.tsx
|
|
729
750
|
import type { ReactNode } from 'react';
|
|
730
751
|
import {
|
|
731
752
|
defineWebsiteSection,
|
|
@@ -744,7 +765,7 @@ const key = (slot: string) => `website.contact.contact-form.${slot}`;
|
|
|
744
765
|
|
|
745
766
|
function ContactFormBody(): ReactNode {
|
|
746
767
|
const { apiOrigin } = useWebsiteRuntime();
|
|
747
|
-
const labels:
|
|
768
|
+
const labels: InboundContactFormLabels = {
|
|
748
769
|
emailLabel: useWebsiteLabel('field.email-label'),
|
|
749
770
|
firstNameLabel: useWebsiteLabel('field.first-name-label'),
|
|
750
771
|
lastNameLabel: useWebsiteLabel('field.last-name-label'),
|
|
@@ -754,6 +775,8 @@ function ContactFormBody(): ReactNode {
|
|
|
754
775
|
submittingLabel: useWebsiteLabel('submitting'),
|
|
755
776
|
successMessage: useWebsiteLabel('success-note'),
|
|
756
777
|
errorMessage: useWebsiteLabel('error-note'),
|
|
778
|
+
challengeRefusedMessage: useWebsiteLabel('challenge-refused-note'),
|
|
779
|
+
invalidEmailMessage: useWebsiteLabel('field.email-invalid-note'),
|
|
757
780
|
};
|
|
758
781
|
const heading = useWebsiteLabel('heading');
|
|
759
782
|
const unavailable = useWebsiteLabel('unavailable');
|
|
@@ -776,7 +799,8 @@ export const CONTACT_FORM_SECTION = defineWebsiteSection<Record<string, never>>(
|
|
|
776
799
|
expectedLabelKeys: [
|
|
777
800
|
'heading', 'unavailable',
|
|
778
801
|
'field.email-label', 'field.first-name-label', 'field.last-name-label', 'field.phone-label',
|
|
779
|
-
'field.marketing-consent-label', '
|
|
802
|
+
'field.marketing-consent-label', 'field.email-invalid-note', 'submit', 'submitting',
|
|
803
|
+
'success-note', 'error-note', 'challenge-refused-note',
|
|
780
804
|
].map(key),
|
|
781
805
|
Component: ContactFormBody,
|
|
782
806
|
});
|
|
@@ -812,8 +836,8 @@ canonical block.
|
|
|
812
836
|
|
|
813
837
|
The installed `ORGANIZATION_CATALOG_ENTRY` contract hosts `contactPoint`
|
|
814
838
|
and lists it in
|
|
815
|
-
`optionalFields`; `recommendOptionals: true
|
|
816
|
-
when
|
|
839
|
+
`optionalFields`; `recommendOptionals: true`, so `wildo website audit` lists the missing ones as recommendations (information, never a finding, never failing `--strict`)
|
|
840
|
+
when a top-level `Organization` payload lacks it).
|
|
817
841
|
|
|
818
842
|
**What earns its place in this section's emission**:
|
|
819
843
|
|
|
@@ -837,7 +861,7 @@ when the field is missing on contact-bearing pages).
|
|
|
837
861
|
|
|
838
862
|
| Invariant | Command |
|
|
839
863
|
|---|---|
|
|
840
|
-
| Section does NOT emit standalone ContactPoint | `rg -n "'ContactPoint'" website/src/sections
|
|
864
|
+
| Section does NOT emit standalone ContactPoint | `rg -n "'ContactPoint'" website/src/sections/<page>.sections.tsx` (must return 0) |
|
|
841
865
|
| Page manifest emits Organization with contactPoint | `rg -n "contactPoint" website/src/pages-impl/*.page.tsx` (must return ≥1 on contact-bearing pages) |
|
|
842
866
|
|
|
843
867
|
## References
|
|
@@ -855,16 +879,17 @@ when the field is missing on contact-bearing pages).
|
|
|
855
879
|
- [ ] The form is NOT wrapped in a consent gate with a purpose — sending
|
|
856
880
|
it is essential; its marketing opt-in is an unticked checkbox.
|
|
857
881
|
- [ ] All visible strings via `useWebsiteLabel`.
|
|
858
|
-
- [ ]
|
|
859
|
-
|
|
882
|
+
- [ ] Every `InboundContactFormLabels` entry is passed, resolved with
|
|
883
|
+
`useWebsiteLabel`, and listed in `expectedLabelKeys`.
|
|
860
884
|
|
|
861
885
|
### Grep invariants
|
|
862
886
|
|
|
863
887
|
| Invariant | Command |
|
|
864
888
|
|---|---|
|
|
865
889
|
| Engine form used (no ad-hoc fetch) | `rg -n "InboundContactForm" website/src/sections/` (must return ≥1) |
|
|
866
|
-
| No bare fetch | `rg -n "fetch\\('/api/inbound-contacts" website/src/sections
|
|
867
|
-
| Form not gated on optional consent | `rg -n "WebsiteConsentGate purpose" website/src/sections
|
|
890
|
+
| No bare fetch | `rg -n "fetch\\('/api/inbound-contacts" website/src/sections/<page>.sections.tsx` (must return empty) |
|
|
891
|
+
| Form not gated on optional consent | `rg -n "WebsiteConsentGate purpose" website/src/sections/<page>.sections.tsx` (must return empty) |
|
|
892
|
+
| Every form label passed | `rg -n "Partial<InboundContactFormLabels>" website/src/sections/` (must return empty; the full type makes an omitted label a type error) |
|
|
868
893
|
|
|
869
894
|
## Common Rationalizations
|
|
870
895
|
|
|
@@ -872,7 +897,7 @@ when the field is missing on contact-bearing pages).
|
|
|
872
897
|
|---|---|
|
|
873
898
|
| "I'll call `fetch('/api/inbound-contacts')` directly" | Bypasses anonymous-session UUID + first-touch metadata propagation; the resulting `InboundContact` row is orphaned from the visitor's session. |
|
|
874
899
|
| "Gate the form behind the consent banner to be safe" | Sending a form the visitor chose to fill in is essential. Gating it on optional consent blocks every visitor who declined analytics from contacting you. |
|
|
875
|
-
| "
|
|
900
|
+
| "I'll pass the labels I care about; the form has sensible defaults" | It has none. Every `InboundContactFormLabels` entry is required, so an omission does not compile, and the form would otherwise show English to every locale with no key anyone could find. |
|
|
876
901
|
| "I'll hard-redirect to `/thank-you` on success" | The `status === 'success'` branch renders in-place so the same `<WebsiteSection>` wrapper records the funnel-completion analytics impression; a redirect drops the impression AND severs the cross-frontend handoff context any post-submit nurture flow needs. |
|
|
877
902
|
|
|
878
903
|
## Red Flags
|
|
@@ -885,6 +910,10 @@ when the field is missing on contact-bearing pages).
|
|
|
885
910
|
- A "contact form" section that POSTs into a third-party service
|
|
886
911
|
(Mailchimp, Hubspot) — out of scope for this category. Build a
|
|
887
912
|
bespoke section using `website-factory-advanced`.
|
|
913
|
+
- A section that builds its form labels as a `Partial` or spreads a
|
|
914
|
+
set of default words into them — the form has no defaults, and a
|
|
915
|
+
fallback there is English in every locale. Catch it with the
|
|
916
|
+
"Every form label passed" grep above.
|
|
888
917
|
|
|
889
918
|
## Related Skills
|
|
890
919
|
|
package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md
CHANGED
|
@@ -85,7 +85,8 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
|
|
|
85
85
|
## Section definition (the contract `defineWebsiteSection` produces)
|
|
86
86
|
|
|
87
87
|
The schema declares the **observable contract** the page-manifest
|
|
88
|
-
registration, label-pack validator, and
|
|
88
|
+
registration, the label-pack validator, `renderPageStructuredData` and
|
|
89
|
+
the structured-data audit depend on. The
|
|
89
90
|
factory layer adds type-preserving generics on top so JSX usage keeps
|
|
90
91
|
compile-time prop checking.
|
|
91
92
|
|
|
@@ -104,7 +105,8 @@ compile-time prop checking.
|
|
|
104
105
|
* `core/define-website-section.tsx` module in Phase 2 because it carries
|
|
105
106
|
* React types in its inputs). The shape is declared in `schemas/`
|
|
106
107
|
* because it is the **observable contract** the page-manifest
|
|
107
|
-
* registration, label-pack validator, and
|
|
108
|
+
* registration, the label-pack validator, `renderPageStructuredData` and the
|
|
109
|
+
* structured-data audit depend on.
|
|
108
110
|
*
|
|
109
111
|
* **Shape rationale** (each field carries semantic weight — see
|
|
110
112
|
* `design-philosophy.mdc`):
|
|
@@ -114,7 +116,8 @@ compile-time prop checking.
|
|
|
114
116
|
* (a section can be reused with the same `sectionRef` across pages
|
|
115
117
|
* when its label-key root is intentionally shared).
|
|
116
118
|
* - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
|
|
117
|
-
* for
|
|
119
|
+
* for skill-mapping and analytics labelling. It does NOT select the
|
|
120
|
+
* section's structured data.
|
|
118
121
|
* - `expectedLabelKeys` — the **fully-composed** label keys the section
|
|
119
122
|
* commits to consuming. The plan originally proposed leaf-relative
|
|
120
123
|
* keys (`'headline'`) resolved at runtime against the
|
|
@@ -127,9 +130,13 @@ compile-time prop checking.
|
|
|
127
130
|
* graph — `wildo website audit` can list a page's required keys
|
|
128
131
|
* without booting React.
|
|
129
132
|
* 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
|
|
130
|
-
* survive
|
|
131
|
-
*
|
|
132
|
-
* `expectedLabelKeys
|
|
133
|
+
* survive — the hook composes the leaf with the page+section
|
|
134
|
+
* context and looks the result up in the active pack. It does
|
|
135
|
+
* NOT check the key against `expectedLabelKeys`: a leaf the
|
|
136
|
+
* section never declared renders its key (with a console warning)
|
|
137
|
+
* and is caught by nothing until a reviewer reads the page. The
|
|
138
|
+
* build and `wildo website audit` check the pack against the
|
|
139
|
+
* DECLARED keys, so declare every slot the component reads.
|
|
133
140
|
* - `Component` — the React component that renders the section. Typed
|
|
134
141
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
135
142
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -139,8 +146,9 @@ compile-time prop checking.
|
|
|
139
146
|
* - `getStructuredData?` — optional pure function the SEO/AEO/GEO
|
|
140
147
|
* builder library invokes at static-build time to materialize JSON-LD
|
|
141
148
|
* for the section. The return type is intentionally `unknown` here;
|
|
142
|
-
*
|
|
143
|
-
* `
|
|
149
|
+
* nothing narrows it by `category` — the section returns whatever
|
|
150
|
+
* vocabulary it emits, and `wildo website audit` reconciles that
|
|
151
|
+
* against the application's Schema.org catalog.
|
|
144
152
|
*
|
|
145
153
|
* **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
|
|
146
154
|
* cannot meaningfully validate "is a React component" beyond
|
|
@@ -287,9 +295,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
|
|
|
287
295
|
* **Why a factory instead of constructing the literal directly**:
|
|
288
296
|
* - Consumers don't have to remember to parse refs / keys
|
|
289
297
|
* themselves before assembling the literal.
|
|
290
|
-
* - The schema parse provides a single audited validation chokepoint
|
|
291
|
-
*
|
|
292
|
-
* without re-entering the React graph.
|
|
298
|
+
* - The schema parse provides a single audited validation chokepoint,
|
|
299
|
+
* and the parsed `expectedLabelKeys` are what `wildo website audit`
|
|
300
|
+
* checks every locale pack against, without re-entering the React graph.
|
|
293
301
|
* - The factory is the documented authoring API the
|
|
294
302
|
* `website_factory_authoring` skill targets — keeping the
|
|
295
303
|
* authoring surface narrow lets the framework evolve the
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: website-section-cta
|
|
3
3
|
description: Author a mid-page call-to-action band using `defineWebsiteSection({ category: WebsiteSectionCategory.CTA, … })`. Use when the user says "add a CTA section", "write a 'sign up' band", "compose a mid-page CTA with headline + button", or "customize the conversion CTA layout".
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Website Section: CTA
|
|
@@ -102,7 +103,8 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
|
|
|
102
103
|
## Section definition (the contract `defineWebsiteSection` produces)
|
|
103
104
|
|
|
104
105
|
The schema declares the **observable contract** the page-manifest
|
|
105
|
-
registration, label-pack validator, and
|
|
106
|
+
registration, the label-pack validator, `renderPageStructuredData` and
|
|
107
|
+
the structured-data audit depend on. The
|
|
106
108
|
factory layer adds type-preserving generics on top so JSX usage keeps
|
|
107
109
|
compile-time prop checking.
|
|
108
110
|
|
|
@@ -121,7 +123,8 @@ compile-time prop checking.
|
|
|
121
123
|
* `core/define-website-section.tsx` module in Phase 2 because it carries
|
|
122
124
|
* React types in its inputs). The shape is declared in `schemas/`
|
|
123
125
|
* because it is the **observable contract** the page-manifest
|
|
124
|
-
* registration, label-pack validator, and
|
|
126
|
+
* registration, the label-pack validator, `renderPageStructuredData` and the
|
|
127
|
+
* structured-data audit depend on.
|
|
125
128
|
*
|
|
126
129
|
* **Shape rationale** (each field carries semantic weight — see
|
|
127
130
|
* `design-philosophy.mdc`):
|
|
@@ -131,7 +134,8 @@ compile-time prop checking.
|
|
|
131
134
|
* (a section can be reused with the same `sectionRef` across pages
|
|
132
135
|
* when its label-key root is intentionally shared).
|
|
133
136
|
* - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
|
|
134
|
-
* for
|
|
137
|
+
* for skill-mapping and analytics labelling. It does NOT select the
|
|
138
|
+
* section's structured data.
|
|
135
139
|
* - `expectedLabelKeys` — the **fully-composed** label keys the section
|
|
136
140
|
* commits to consuming. The plan originally proposed leaf-relative
|
|
137
141
|
* keys (`'headline'`) resolved at runtime against the
|
|
@@ -144,9 +148,13 @@ compile-time prop checking.
|
|
|
144
148
|
* graph — `wildo website audit` can list a page's required keys
|
|
145
149
|
* without booting React.
|
|
146
150
|
* 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
|
|
147
|
-
* survive
|
|
148
|
-
*
|
|
149
|
-
* `expectedLabelKeys
|
|
151
|
+
* survive — the hook composes the leaf with the page+section
|
|
152
|
+
* context and looks the result up in the active pack. It does
|
|
153
|
+
* NOT check the key against `expectedLabelKeys`: a leaf the
|
|
154
|
+
* section never declared renders its key (with a console warning)
|
|
155
|
+
* and is caught by nothing until a reviewer reads the page. The
|
|
156
|
+
* build and `wildo website audit` check the pack against the
|
|
157
|
+
* DECLARED keys, so declare every slot the component reads.
|
|
150
158
|
* - `Component` — the React component that renders the section. Typed
|
|
151
159
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
152
160
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -156,8 +164,9 @@ compile-time prop checking.
|
|
|
156
164
|
* - `getStructuredData?` — optional pure function the SEO/AEO/GEO
|
|
157
165
|
* builder library invokes at static-build time to materialize JSON-LD
|
|
158
166
|
* for the section. The return type is intentionally `unknown` here;
|
|
159
|
-
*
|
|
160
|
-
* `
|
|
167
|
+
* nothing narrows it by `category` — the section returns whatever
|
|
168
|
+
* vocabulary it emits, and `wildo website audit` reconciles that
|
|
169
|
+
* against the application's Schema.org catalog.
|
|
161
170
|
*
|
|
162
171
|
* **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
|
|
163
172
|
* cannot meaningfully validate "is a React component" beyond
|
|
@@ -304,9 +313,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
|
|
|
304
313
|
* **Why a factory instead of constructing the literal directly**:
|
|
305
314
|
* - Consumers don't have to remember to parse refs / keys
|
|
306
315
|
* themselves before assembling the literal.
|
|
307
|
-
* - The schema parse provides a single audited validation chokepoint
|
|
308
|
-
*
|
|
309
|
-
* without re-entering the React graph.
|
|
316
|
+
* - The schema parse provides a single audited validation chokepoint,
|
|
317
|
+
* and the parsed `expectedLabelKeys` are what `wildo website audit`
|
|
318
|
+
* checks every locale pack against, without re-entering the React graph.
|
|
310
319
|
* - The factory is the documented authoring API the
|
|
311
320
|
* `website_factory_authoring` skill targets — keeping the
|
|
312
321
|
* authoring surface narrow lets the framework evolve the
|
|
@@ -611,9 +620,9 @@ Authors should think of it as "one thing to ask for" — one primary
|
|
|
611
620
|
button, optionally one secondary low-commitment alternative. Anything
|
|
612
621
|
more belongs in a different section type.
|
|
613
622
|
|
|
614
|
-
|
|
623
|
+
What the category does — and, for structured data, does not — decide:
|
|
615
624
|
|
|
616
|
-
1. **SEO/AEO/GEO
|
|
625
|
+
1. **SEO/AEO/GEO** — `category: CTA` does not have a
|
|
617
626
|
dedicated structured-data vocabulary; emit `WebPage` `mainEntity`
|
|
618
627
|
only when the CTA represents the page's primary action.
|
|
619
628
|
2. **Skill mapping** — 1:1 with `WebsiteSectionCategory.CTA`.
|
|
@@ -624,7 +633,7 @@ The category drives:
|
|
|
624
633
|
|
|
625
634
|
| Surface | Glob (relative to app root) |
|
|
626
635
|
|---|---|
|
|
627
|
-
| Section component + factory call | `website/src/sections
|
|
636
|
+
| Section component + factory call, and its entry in the page's `<PAGE>_SECTIONS` list | `website/src/sections/<page>.sections.tsx` (one file per page, holding all its sections) |
|
|
628
637
|
| Page composition | `website/src/pages-impl/<page-ref>.page.tsx` |
|
|
629
638
|
| Label pack (per locale) | `website/src/i18n/<locale>.json` |
|
|
630
639
|
|
|
@@ -697,7 +706,7 @@ inside the relevant page block in `website/src/content/llms.txt`.
|
|
|
697
706
|
|
|
698
707
|
<!-- TIER C WAIVER: This block IS the canonical mid-page CTA contract — `category: WebsiteSectionCategory.CTA`, the `variant: 'banner' | 'boxed' | 'split'` typed-prop pattern called out in Step 3, the `primaryHref` cross-frontend handoff prop, and the `expectedLabelKeys` rooted at `website.<page>.<sectionRef>.<leaf>` shape that the Verification + Common Rationalizations sections below name explicitly. Keep it as Tier C until a stable application usage example is deliberately anchored. -->
|
|
699
708
|
```tsx
|
|
700
|
-
// website/src/sections
|
|
709
|
+
// website/src/sections/<page>.sections.tsx
|
|
701
710
|
import {
|
|
702
711
|
defineWebsiteSection,
|
|
703
712
|
useWebsiteLabel,
|
|
@@ -754,9 +763,10 @@ export const CTA_SECTION = defineWebsiteSection<CtaSectionProps>({
|
|
|
754
763
|
The `CTA` category does not own a dedicated JSON-LD vocabulary. If the
|
|
755
764
|
CTA represents the page's primary user action, the page-level
|
|
756
765
|
`getStructuredData` (on `WebPage`) may reference it via
|
|
757
|
-
`potentialAction`/`mainEntity`.
|
|
758
|
-
(`Product`, `FAQPage`, etc.)
|
|
759
|
-
|
|
766
|
+
`potentialAction`/`mainEntity`. Keep unrelated vocabularies
|
|
767
|
+
(`Product`, `FAQPage`, etc.) in the sections that own them — nothing
|
|
768
|
+
rejects them here, since the audit checks each payload against the
|
|
769
|
+
catalog and never against the section's category.
|
|
760
770
|
|
|
761
771
|
In practice: leave `getStructuredData` undefined unless you have a
|
|
762
772
|
specific page-level action you want crawlers to surface.
|
|
@@ -780,10 +790,10 @@ specific page-level action you want crawlers to surface.
|
|
|
780
790
|
|
|
781
791
|
| Invariant | Command |
|
|
782
792
|
|---|---|
|
|
783
|
-
| Factory used | `rg -n "defineWebsiteSection<" website/src/sections
|
|
784
|
-
| Category enum (no string literal) | `rg -n "category: 'cta'" website/src/sections
|
|
785
|
-
| No hardcoded sign-up URL outside the cross-frontend carrier | `rg -n "href=\"https?://" website/src/sections
|
|
786
|
-
| Labels via leaf-relative hook | `rg -n "useWebsiteLabel\\(" website/src/sections
|
|
793
|
+
| Factory used | `rg -n "defineWebsiteSection<" website/src/sections/<page>.sections.tsx` (must return ≥1 — a page's sections file holds each of its sections) |
|
|
794
|
+
| Category enum (no string literal) | `rg -n "category: 'cta'" website/src/sections/<page>.sections.tsx` (must return empty) |
|
|
795
|
+
| No hardcoded sign-up URL outside the cross-frontend carrier | `rg -n "href=\"https?://" website/src/sections/<page>.sections.tsx` (must return empty — pass URLs as props) |
|
|
796
|
+
| Labels via leaf-relative hook | `rg -n "useWebsiteLabel\\(" website/src/sections/<page>.sections.tsx` (must return ≥1 per visible string) |
|
|
787
797
|
|
|
788
798
|
## Common Rationalizations
|
|
789
799
|
|
|
@@ -85,7 +85,8 @@ export const WebsiteSectionCategorySchema: z.ZodEnum<typeof WebsiteSectionCatego
|
|
|
85
85
|
## Section definition (the contract `defineWebsiteSection` produces)
|
|
86
86
|
|
|
87
87
|
The schema declares the **observable contract** the page-manifest
|
|
88
|
-
registration, label-pack validator, and
|
|
88
|
+
registration, the label-pack validator, `renderPageStructuredData` and
|
|
89
|
+
the structured-data audit depend on. The
|
|
89
90
|
factory layer adds type-preserving generics on top so JSX usage keeps
|
|
90
91
|
compile-time prop checking.
|
|
91
92
|
|
|
@@ -104,7 +105,8 @@ compile-time prop checking.
|
|
|
104
105
|
* `core/define-website-section.tsx` module in Phase 2 because it carries
|
|
105
106
|
* React types in its inputs). The shape is declared in `schemas/`
|
|
106
107
|
* because it is the **observable contract** the page-manifest
|
|
107
|
-
* registration, label-pack validator, and
|
|
108
|
+
* registration, the label-pack validator, `renderPageStructuredData` and the
|
|
109
|
+
* structured-data audit depend on.
|
|
108
110
|
*
|
|
109
111
|
* **Shape rationale** (each field carries semantic weight — see
|
|
110
112
|
* `design-philosophy.mdc`):
|
|
@@ -114,7 +116,8 @@ compile-time prop checking.
|
|
|
114
116
|
* (a section can be reused with the same `sectionRef` across pages
|
|
115
117
|
* when its label-key root is intentionally shared).
|
|
116
118
|
* - `category` — see `WebsiteSectionCategory` JSDoc; tags the section
|
|
117
|
-
* for
|
|
119
|
+
* for skill-mapping and analytics labelling. It does NOT select the
|
|
120
|
+
* section's structured data.
|
|
118
121
|
* - `expectedLabelKeys` — the **fully-composed** label keys the section
|
|
119
122
|
* commits to consuming. The plan originally proposed leaf-relative
|
|
120
123
|
* keys (`'headline'`) resolved at runtime against the
|
|
@@ -127,9 +130,13 @@ compile-time prop checking.
|
|
|
127
130
|
* graph — `wildo website audit` can list a page's required keys
|
|
128
131
|
* without booting React.
|
|
129
132
|
* 3. The leaf-relative ergonomics (`useWebsiteLabel('headline')`)
|
|
130
|
-
* survive
|
|
131
|
-
*
|
|
132
|
-
* `expectedLabelKeys
|
|
133
|
+
* survive — the hook composes the leaf with the page+section
|
|
134
|
+
* context and looks the result up in the active pack. It does
|
|
135
|
+
* NOT check the key against `expectedLabelKeys`: a leaf the
|
|
136
|
+
* section never declared renders its key (with a console warning)
|
|
137
|
+
* and is caught by nothing until a reviewer reads the page. The
|
|
138
|
+
* build and `wildo website audit` check the pack against the
|
|
139
|
+
* DECLARED keys, so declare every slot the component reads.
|
|
133
140
|
* - `Component` — the React component that renders the section. Typed
|
|
134
141
|
* as `ComponentType<unknown>` here because schema-layer cannot lock
|
|
135
142
|
* the component's prop shape (props vary per section). The factory
|
|
@@ -139,8 +146,9 @@ compile-time prop checking.
|
|
|
139
146
|
* - `getStructuredData?` — optional pure function the SEO/AEO/GEO
|
|
140
147
|
* builder library invokes at static-build time to materialize JSON-LD
|
|
141
148
|
* for the section. The return type is intentionally `unknown` here;
|
|
142
|
-
*
|
|
143
|
-
* `
|
|
149
|
+
* nothing narrows it by `category` — the section returns whatever
|
|
150
|
+
* vocabulary it emits, and `wildo website audit` reconciles that
|
|
151
|
+
* against the application's Schema.org catalog.
|
|
144
152
|
*
|
|
145
153
|
* **Why not `z.custom<ComponentType>(…)`**: a `z.custom` predicate
|
|
146
154
|
* cannot meaningfully validate "is a React component" beyond
|
|
@@ -287,9 +295,9 @@ export interface TypedWebsiteSectionDefinition<TProps>
|
|
|
287
295
|
* **Why a factory instead of constructing the literal directly**:
|
|
288
296
|
* - Consumers don't have to remember to parse refs / keys
|
|
289
297
|
* themselves before assembling the literal.
|
|
290
|
-
* - The schema parse provides a single audited validation chokepoint
|
|
291
|
-
*
|
|
292
|
-
* without re-entering the React graph.
|
|
298
|
+
* - The schema parse provides a single audited validation chokepoint,
|
|
299
|
+
* and the parsed `expectedLabelKeys` are what `wildo website audit`
|
|
300
|
+
* checks every locale pack against, without re-entering the React graph.
|
|
293
301
|
* - The factory is the documented authoring API the
|
|
294
302
|
* `website_factory_authoring` skill targets — keeping the
|
|
295
303
|
* authoring surface narrow lets the framework evolve the
|