@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
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 +321 -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.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -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 +253 -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 +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- 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 +279 -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 +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -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 +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -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 +43 -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 +5957 -1729
- 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: configure-billing
|
|
3
|
-
description: Enable billing (or make any backend-reachable external provider resolve) across the full multi-surface config chain. Use when the user says "enable billing", "turn on Stripe", "billing crash-loops the backend", "wire up subscriptions/checkout", "the billing provider won't resolve at startup",
|
|
3
|
+
description: Enable billing (or make any backend-reachable external provider resolve) across the full multi-surface config chain, and write the application's billing catalogue — the plans and typed prices the backend sells and the public website lists. Use when the user says "enable billing", "turn on Stripe", "add a pricing plan", "set the plan prices", "billing crash-loops the backend", "wire up subscriptions/checkout", "the billing provider won't resolve at startup", or "make <provider> work on the backend host". Covers the 5 config surfaces, the product catalogue (money in minor units; recommended, price disclosure and availability), the auto-registered webhook route, and the failure-reason → surface debugging map.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Configure Billing
|
|
@@ -48,6 +49,7 @@ narrow case only — a provider module your application itself ships.
|
|
|
48
49
|
| Backend provider scope | `./wildo.saas.config.ts` (`providers.scopes.backend.providers.<ref>`) |
|
|
49
50
|
| Per-env secrets | `./infrastructure/<env>/secrets/secrets.json` (`providerEnv`) |
|
|
50
51
|
| Generated artifact (do NOT hand-edit) | `./backend-api/src/generated/wildo-provider-runtime.generated.ts` |
|
|
52
|
+
| Billing catalogue — the plans and prices the backend sells and the website lists | `./shared-lib/src/engine/product.ts` (`CUSTOM_PRODUCT_CATALOG`) |
|
|
51
53
|
|
|
52
54
|
## When to Use
|
|
53
55
|
|
|
@@ -56,15 +58,40 @@ narrow case only — a provider module your application itself ships.
|
|
|
56
58
|
- Making any provider that runs server-side (email, LLM, SMS, audit sink)
|
|
57
59
|
reachable on the backend host
|
|
58
60
|
- A provider "works in the frontend" but the backend can't resolve it
|
|
61
|
+
- Turning on a referral program, or choosing what the referrer and the referred customer receive
|
|
62
|
+
- Writing or changing the billing catalogue: a plan, its price, and whether it is recommended,
|
|
63
|
+
fully priced, or on sale yet
|
|
59
64
|
|
|
60
65
|
## When NOT to Use
|
|
61
66
|
|
|
62
67
|
- Pure provider-scope authoring with no billing / backend-reachability angle →
|
|
63
68
|
`config-saas` (owns `providers.scopes` generally)
|
|
64
|
-
-
|
|
65
|
-
`providers.scopes.frontendServices.<app>` surface, a different scope
|
|
69
|
+
- Browser-side provider code (a file picker, error monitoring, analytics) → that is the
|
|
70
|
+
`providers.scopes.frontendServices.<app>` surface, a different scope. Billing has
|
|
71
|
+
NO browser part: checkout and the customer portal are hosted redirects, and a
|
|
72
|
+
frontend module may not declare `BILLING` (it is refused when projected)
|
|
66
73
|
- Editing environment topology / backing services → `infra-environment-config`
|
|
67
|
-
- Authoring
|
|
74
|
+
- Authoring feature entitlements (feature identifiers, profiles, unavailability policy) →
|
|
75
|
+
`engine-product-definitions`. The catalogue's own entries — the plans and their prices — are this
|
|
76
|
+
skill's.
|
|
77
|
+
|
|
78
|
+
## Authoring the catalogue
|
|
79
|
+
|
|
80
|
+
The catalogue is the ONE place a price lives. The backend syncs it to the billing provider, and the
|
|
81
|
+
public website reads it at build time for its pricing page, so a price written anywhere else (a
|
|
82
|
+
website file, a product specification's prose) is a copy that will disagree with it.
|
|
83
|
+
|
|
84
|
+
- **Each entry's `key` is a string literal** (`key: 'team'`), and when a build task produces the product it
|
|
85
|
+
is exactly the task's `productKey`: the build loop recognises a landed product by that literal, so a key
|
|
86
|
+
held in a constant or an enum member reads as not landed and the task is dispatched again.
|
|
87
|
+
- **Every entry is in the exported `CUSTOM_PRODUCT_CATALOG` array** — a plan declared and not listed there
|
|
88
|
+
is sold nowhere and shown nowhere.
|
|
89
|
+
- **Money is in MINOR units**: `$4` is `{ amount: 400n, decimals: 2, currency: 'USD' }`, never `4n`.
|
|
90
|
+
- **Per member or flat**: `PricingModel.PER_UNIT` for a per-seat price, `FLAT` for a whole price.
|
|
91
|
+
- **The three pricing-surface facts** — `isRecommended`, `priceDisclosure`, `availability` — say how
|
|
92
|
+
every pricing surface presents the plan; see `references/framework-product-catalog-api.md`.
|
|
93
|
+
- **Product specifications describe what a price MEANS** (monthly and yearly, a discount, a sub-cent
|
|
94
|
+
metered amount), never the amount itself.
|
|
68
95
|
|
|
69
96
|
## Workflow
|
|
70
97
|
|
|
@@ -126,9 +153,13 @@ declaration is not merely redundant but a source of disagreement.
|
|
|
126
153
|
|
|
127
154
|
### Step 6: Surface 4 — populate the secrets
|
|
128
155
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
156
|
+
Set the env-var-named keys the provider's `secretsContract` declares
|
|
157
|
+
(`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`) with `wildo secrets set
|
|
158
|
+
STRIPE_SECRET_KEY` (a masked prompt; `--env <environment>` for a remote one).
|
|
159
|
+
It writes `./infrastructure/<env>/secrets/secrets.json` → `providerEnv`,
|
|
160
|
+
regenerates the runtimes' env files and restarts the backend, and refuses a
|
|
161
|
+
name no scoped provider declares — so run it after Step 5's scope is authored.
|
|
162
|
+
`wildo secrets list` shows which are still `needed`. Missing → `SECRET_MISSING`.
|
|
132
163
|
See `references/example-backend-provider-module-shape.md` for where these
|
|
133
164
|
names come from.
|
|
134
165
|
|
|
@@ -139,6 +170,9 @@ Run `wildo config sync` (apps-manager must be up). Confirm `<ref>` appears in
|
|
|
139
170
|
boots without a billing-resolution fatal. The webhook route
|
|
140
171
|
`POST /api/v1/webhooks/stripe/billing` is auto-registered from
|
|
141
172
|
`WEBHOOK_ORIGINATOR`; forward local events with `stripe listen --forward-to`.
|
|
173
|
+
Each event is stored, retried for up to three days and replayable from the
|
|
174
|
+
inbound deliveries list — see "What happens to a billing event after it is
|
|
175
|
+
verified" in `references/config-chain-and-failure-map.md`.
|
|
142
176
|
|
|
143
177
|
## Worked Example
|
|
144
178
|
|
|
@@ -164,9 +198,11 @@ and `WEBHOOK_ORIGINATOR` is what registers the inbound route:
|
|
|
164
198
|
// selection aligned with discovery prevents the provider from being
|
|
165
199
|
// registered under a capability no runtime selects.
|
|
166
200
|
// WEBHOOK_ORIGINATOR is required so the webhook auto-controller
|
|
167
|
-
// registers POST /api/v1/webhooks/stripe/billing.
|
|
168
|
-
//
|
|
169
|
-
//
|
|
201
|
+
// registers POST /api/v1/webhooks/stripe/billing. This is the ONLY
|
|
202
|
+
// place Stripe is declared: checkout and the customer portal are
|
|
203
|
+
// hosted redirects, so no Stripe code runs in the browser and there
|
|
204
|
+
// is no frontend-scope entry to add. The billing components show the
|
|
205
|
+
// vendor's name from `billing.providerRef` (#1701).
|
|
170
206
|
stripe: {
|
|
171
207
|
engineCapabilities: [EngineCapability.BILLING],
|
|
172
208
|
providerCapabilities: ['BILLING'],
|
|
@@ -174,14 +210,18 @@ and `WEBHOOK_ORIGINATOR` is what registers the inbound route:
|
|
|
174
210
|
},
|
|
175
211
|
```
|
|
176
212
|
|
|
177
|
-
Note the
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
213
|
+
Note what the comment says: the backend scope is the ONLY place the billing
|
|
214
|
+
provider is declared. There is no frontend-scope entry for it — no Stripe code
|
|
215
|
+
runs in the browser, and the billing components (portal link, invoice history,
|
|
216
|
+
subscription status) show the vendor's name from `billing.providerRef` through
|
|
217
|
+
`useBilling().billingProviderRef` and the generated `providers.<ref>.displayName`
|
|
218
|
+
label. A billing ref authored under `frontendServices` is refused by discovery,
|
|
219
|
+
since no browser module contributes `BILLING`.
|
|
181
220
|
|
|
182
221
|
## References
|
|
183
222
|
- `references/framework-billing-frontend-api.md` — `useBilling()`, `openCheckout`, `openCustomerPortal`: the frontend surface a bespoke purchase flow is built on
|
|
184
|
-
- `references/framework-product-catalog-api.md` — source-backed
|
|
223
|
+
- `references/framework-product-catalog-api.md` — how to write the catalogue: money in minor units, the three pricing-surface facts (recommended, price disclosure, availability), source-backed vocabularies and sync results, local retirement versus provider retirement
|
|
224
|
+
- `references/framework-referral-program.md` — `billing.referrals`: issuing and redeeming referral codes, what each reward kind does and when it is delivered, and who may redeem
|
|
185
225
|
- `references/framework-subscription-behavior-policy.md` — `behaviorPolicy` on a product: what trial, proration, cancellation and timing actually control, and the two fields that constrain nothing
|
|
186
226
|
- `references/config-chain-and-failure-map.md` — the 6-surface checklist, the failure-reason → surface map, the webhook route, and the generalization to non-billing providers
|
|
187
227
|
- `references/framework-backend-provider-reachability-api.md` — source: the backend registry catalog→artifact filter (why a mis-scoped provider is dropped)
|
|
@@ -211,13 +251,13 @@ Run from the app root (substitute `<ref>` / `<env>`):
|
|
|
211
251
|
| **Ref authored in BACKEND scope** (must return a hit) | `rg -n "backend:\s*\{" -A80 wildo.saas.config.ts \| rg "<ref>:"` |
|
|
212
252
|
| **No second declaration** (must return NOTHING for an engine-shipped or package-shipped provider) | `rg -n "<ref>" backend-api/src/provider-contributions.ts` |
|
|
213
253
|
| Billing scope declares both protocols | `rg -n "'BILLING_PROVIDER'.*'WEBHOOK_ORIGINATOR'\|'WEBHOOK_ORIGINATOR'.*'BILLING_PROVIDER'" wildo.saas.config.ts` |
|
|
214
|
-
| Secrets populated | `
|
|
254
|
+
| Secrets populated (both listed under `SET`, none under `NEEDED`) | `wildo secrets list --env <env>` |
|
|
215
255
|
| **Ref materialized in the artifact** (must return a hit after sync) | `rg -n "<ref>" backend-api/src/generated/wildo-provider-runtime.generated.ts` |
|
|
216
|
-
| **
|
|
256
|
+
| **No frontend-scope billing entry** (must return NOTHING — billing has no browser part) | `rg -n "frontendServices:" -A60 wildo.saas.config.ts \| rg "<ref>:"` |
|
|
217
257
|
|
|
218
258
|
The high-signal pair: **"ref authored in BACKEND scope"** returning empty while
|
|
219
|
-
**"frontend-
|
|
220
|
-
signature.
|
|
259
|
+
**"no frontend-scope billing entry"** returns a hit is the exact billing crash-loop
|
|
260
|
+
signature: the ref was declared where nothing can serve it.
|
|
221
261
|
|
|
222
262
|
## Common Rationalizations
|
|
223
263
|
|
|
@@ -225,7 +265,8 @@ signature.
|
|
|
225
265
|
|-----------------|---------|
|
|
226
266
|
| "I set `billing.enabled` + `providerRef` and the secret — that's everything." | That is only surfaces 2 and 4. Without engine activation (1), backend-scope authoring (3) and the regeneration that materializes it (5), exposure or provider resolution remains incomplete. |
|
|
227
267
|
| "The engine ships the Stripe integration, so I don't need any npm package." | The engine ships the ADAPTER; it lazy-`require`s the provider's SDK at runtime. You must add the SDK package (`stripe`) to `backend-api/package.json` and install it. Missing SDK fails when the adapter instantiates — a require/module-not-found error, distinct from the classified billing-resolution fatals. |
|
|
228
|
-
| "Stripe is already in `frontendServices` — the backend will find it." |
|
|
268
|
+
| "Stripe is already in `frontendServices` — the backend will find it." | Billing has no browser part: checkout and the portal are hosted redirects, and no frontend module contributes `BILLING`, so discovery refuses the frontend entry. The backend host reads only `providers.scopes.backend`. |
|
|
269
|
+
| "I need a frontend Stripe module so the billing screens can name the provider." | The name comes from the ref: `useBilling().billingProviderRef` (your `billing.providerRef`) and the generated `providers.<ref>.displayName` label. A browser module is for code that runs in the page. |
|
|
229
270
|
| "The fatal says secret missing, so I'll rotate the key." | Only if the reason is `SECRET_MISSING`. `PROVIDER_NOT_REACHABLE_ON_BACKEND` looks similar but is a scope/contribution gap — read the classified reason before touching the secret. |
|
|
230
271
|
| "Stripe is engine-shipped, so I still need to project it into `provider-contributions.ts`." | You do not, and doing so is a second declaration that can disagree with the engine. Discovery admits the engine's own provider package by name and reads its `./companion` barrel; the scope supplies the runtime target. Hand-author a contribution only for a provider module your application itself ships. |
|
|
231
272
|
| "I'll edit the generated `wildo-provider-runtime.generated.ts` to add the ref." | Generated artifact — hand edits are overwritten on the next sync and mask the real authoring gap. Fix surfaces 3/4 and re-run `wildo config sync`. |
|
|
@@ -240,9 +281,8 @@ signature.
|
|
|
240
281
|
- `billing.providerRef` set but no matching entry under
|
|
241
282
|
`providers.scopes.backend` (catch with the **Ref authored in BACKEND scope**
|
|
242
283
|
grep — must return a hit).
|
|
243
|
-
- Ref under `frontendServices
|
|
244
|
-
the **
|
|
245
|
-
is empty).
|
|
284
|
+
- Ref under `frontendServices`, where no browser module can serve billing (catch
|
|
285
|
+
with the **No frontend-scope billing entry** grep returning a hit).
|
|
246
286
|
- An engine- or package-shipped ref ALSO hand-authored in
|
|
247
287
|
`backend-api/src/provider-contributions.ts` (catch with the **No second
|
|
248
288
|
declaration** grep — must return nothing). Discovery already supplies it; the
|
|
@@ -262,5 +302,5 @@ signature.
|
|
|
262
302
|
surface 5 lives beside
|
|
263
303
|
- `local-environment-bootstrap` — drives `wildo config sync` and the local stack
|
|
264
304
|
that materializes the authored truth
|
|
265
|
-
- `engine-product-definitions` —
|
|
305
|
+
- `engine-product-definitions` — feature entitlements the catalogue's products grant
|
|
266
306
|
(the layer above provider wiring)
|
|
@@ -31,8 +31,9 @@ authored but the provider still cannot be constructed.
|
|
|
31
31
|
|
|
32
32
|
Surface 3 is the **classic trap**: authoring the provider only in a frontend
|
|
33
33
|
scope (`providers.scopes.frontendServices.<app>`) looks done, but that surface
|
|
34
|
-
|
|
35
|
-
|
|
34
|
+
holds browser-side provider code, and billing has none — checkout and the
|
|
35
|
+
customer portal are hosted redirects, and a frontend module may not declare
|
|
36
|
+
`BILLING`. The backend host runs the billing SDK and verifies inbound webhooks. The
|
|
36
37
|
backend registry only exposes refs authored under `providers.scopes.backend`.
|
|
37
38
|
|
|
38
39
|
**There is no sixth surface projecting the provider into the backend package,
|
|
@@ -84,6 +85,38 @@ For local dev, forward Stripe events to the running backend:
|
|
|
84
85
|
stripe listen --forward-to localhost:<backend-port>/api/v1/webhooks/stripe/billing
|
|
85
86
|
```
|
|
86
87
|
|
|
88
|
+
### What happens to a billing event after it is verified
|
|
89
|
+
|
|
90
|
+
Billing events travel the framework's durable inbound path, the same one an
|
|
91
|
+
application's own inbound handlers use:
|
|
92
|
+
|
|
93
|
+
- **Stored once, answered `200`.** Each verified event is written to the
|
|
94
|
+
application's inbound deliveries (Settings → inbound deliveries) keyed by the
|
|
95
|
+
provider event id, and Stripe is answered `200` straight away. A redelivery of
|
|
96
|
+
the same event is recognised and not run again.
|
|
97
|
+
- **Run with a dedicated role.** The framework's billing handler writes the
|
|
98
|
+
subscription, invoice, credit-pool and billing-account records with a role that
|
|
99
|
+
grants exactly those writes, in the one organization (or, for personal billing,
|
|
100
|
+
the one person) the event's customer belongs to. No person, API key or OAuth
|
|
101
|
+
client can be given that role.
|
|
102
|
+
- **Retried for three days, then `DEAD`.** A failed attempt is retried with
|
|
103
|
+
growing delays (one minute, doubling to six hours) for up to three days — as
|
|
104
|
+
long as Stripe itself would have retried. After that the delivery is `DEAD`,
|
|
105
|
+
and an administrator can replay it with a written reason once the cause is
|
|
106
|
+
fixed. Replaying an event that already took effect does not take effect twice.
|
|
107
|
+
- **Events for one subscription run in order.** Events naming the same
|
|
108
|
+
subscription (or, without one, the same customer) run one at a time in the
|
|
109
|
+
order they arrived, and each subscription change is decided against a fresh
|
|
110
|
+
read of the subscription at Stripe.
|
|
111
|
+
- **An event whose customer matches no billing account is `UNROUTABLE`**: it is
|
|
112
|
+
recorded and answered `200`, never run, and never applied to the application
|
|
113
|
+
as a whole.
|
|
114
|
+
|
|
115
|
+
To test replay safely, use a test-mode key (`sk_test_…`) — the Stripe CLI uses
|
|
116
|
+
your live account unless told otherwise — and replay from the inbound deliveries
|
|
117
|
+
list rather than with `stripe events resend`, which only re-sends an event the
|
|
118
|
+
application already stored once.
|
|
119
|
+
|
|
87
120
|
## Generalizing beyond billing
|
|
88
121
|
|
|
89
122
|
Surfaces 1 and 3 → 5 are provider-agnostic: they are how ANY backend-reachable
|
package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md
CHANGED
|
@@ -24,6 +24,20 @@ resolvable on the backend host.
|
|
|
24
24
|
// To disable: set `enabled: false` (providerRef then becomes inert).
|
|
25
25
|
enabled: true,
|
|
26
26
|
providerRef: 'stripe',
|
|
27
|
+
/**
|
|
28
|
+
* The referral program. An organization owner issues a code from the organization's referrals page, a new
|
|
29
|
+
* customer redeems it on their billing account, and the customer's first paid invoice converts it and grants
|
|
30
|
+
* both rewards once.
|
|
31
|
+
*
|
|
32
|
+
* The referrer's credits go to a dedicated pool, created on the first grant and counted as granted rather
|
|
33
|
+
* than purchased. The new customer's reward is a coupon on their subscription: 20% off for three months.
|
|
34
|
+
*/
|
|
35
|
+
referrals: {
|
|
36
|
+
enabled: true,
|
|
37
|
+
referrerReward: { type: ReferrerRewardType.CREDIT, credits: 500, creditPoolKey: 'referral_credits' },
|
|
38
|
+
referredReward: { type: ReferredRewardType.DISCOUNT, percentOff: 20, discountDuration: PromotionDuration.REPEATING, discountDurationInMonths: 3 },
|
|
39
|
+
codeValidityDays: 30,
|
|
40
|
+
},
|
|
27
41
|
},
|
|
28
42
|
```
|
|
29
43
|
|
package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md
CHANGED
|
@@ -50,6 +50,9 @@ export const StripeBackendProvider: BackendProviderModule = {
|
|
|
50
50
|
deploymentModels: [ProviderDeploymentModel.VENDOR_HOSTED],
|
|
51
51
|
processingRegions: ['us-east-1', 'eu-west-1'],
|
|
52
52
|
vendorLegalEntityName: 'Stripe, Inc.',
|
|
53
|
+
// Stripe keeps the customer and its payment records; the engine's billing subject-erasure effect deletes the
|
|
54
|
+
// customer and detaches its payment methods, and names this provider as the recipient it answers for (#1710).
|
|
55
|
+
subjectErasure: { stance: HttpApiErasureStance.EXTERNAL_ERASURE_OPERATION },
|
|
53
56
|
},
|
|
54
57
|
providerCapabilities: [
|
|
55
58
|
BUILTIN_PROVIDER_CAPABILITY.BILLING,
|
package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md
CHANGED
|
@@ -111,7 +111,16 @@ export interface BillingContextType {
|
|
|
111
111
|
// ── Configuration ──
|
|
112
112
|
isEnabled: boolean;
|
|
113
113
|
billingConfiguration: BillingConfiguration | undefined;
|
|
114
|
-
|
|
114
|
+
/**
|
|
115
|
+
* The configured billing provider's REF (`billing.providerRef`), or null when billing is off or
|
|
116
|
+
* names none. Surfaces show the vendor's name from it (`providers.<ref>.displayName`, #1895).
|
|
117
|
+
*
|
|
118
|
+
* It used to be a frontend provider MODULE, resolved from the registry by ref or by the `BILLING`
|
|
119
|
+
* capability. The only such module was Stripe's, which loaded no Stripe code — checkout and the
|
|
120
|
+
* customer portal are hosted redirects — and existed only to carry that name (#1701). The ref is the
|
|
121
|
+
* fact the application configured; a module was a second place that had to agree with it.
|
|
122
|
+
*/
|
|
123
|
+
billingProviderRef: string | null;
|
|
115
124
|
|
|
116
125
|
// ── Billing State ──
|
|
117
126
|
billingAccount: BillingAccount | null;
|
|
@@ -125,6 +134,15 @@ export interface BillingContextType {
|
|
|
125
134
|
productDefinitions: ProductDefinition[];
|
|
126
135
|
getPricesForProduct: (productId: string) => Price[];
|
|
127
136
|
getProductByKey: (key: string) => Product | undefined;
|
|
137
|
+
/**
|
|
138
|
+
* May this product be bought, or moved onto, right now? Answered from the billing state's
|
|
139
|
+
* `acquirableProductKeys` — the set the backend derives with the SAME predicate its checkout,
|
|
140
|
+
* plan-change and add-on doors enforce — so a surface never re-derives it from `isActive` and can
|
|
141
|
+
* never offer a plan the backend refuses (a retired one, or an announced-but-upcoming one, #1835).
|
|
142
|
+
* Fails closed: a state that did not carry the set answers `false`, because an unknown answer must
|
|
143
|
+
* not offer a checkout.
|
|
144
|
+
*/
|
|
145
|
+
isProductAcquirable: (key: string) => boolean;
|
|
128
146
|
|
|
129
147
|
// ── Scope ──
|
|
130
148
|
currentScope: ResourcePrimaryScope | null;
|
|
@@ -137,7 +155,7 @@ export interface BillingContextType {
|
|
|
137
155
|
|
|
138
156
|
// ── Usage & Credits ──
|
|
139
157
|
usage: UsageSummary;
|
|
140
|
-
creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;
|
|
158
|
+
creditPools: Record<string, { available: number; totalPurchased: number; totalGranted: number; totalConsumed: number }>;
|
|
141
159
|
|
|
142
160
|
// ── Actions ──
|
|
143
161
|
openCheckout: (productKey: string, priceId: string, options?: {
|
|
@@ -150,6 +168,11 @@ export interface BillingContextType {
|
|
|
150
168
|
previewPlanChange: (target: BillingPlanChangeTarget, options?: { signal?: AbortSignal }) => Promise<BillingPlanChangePreviewResponse>;
|
|
151
169
|
/** Confirm only the server token returned for the displayed preview. Successful mutation refreshes billing state. */
|
|
152
170
|
confirmPlanChange: (confirmation: BillingPlanChangeConfirmation) => Promise<void>;
|
|
171
|
+
/**
|
|
172
|
+
* Withdraw the plan change pending at the end of the period (`subscription.pendingPlanChange`, #1868), so the subscription renews
|
|
173
|
+
* on its current plan. Successful withdrawal refreshes billing state.
|
|
174
|
+
*/
|
|
175
|
+
cancelPendingPlanChange: () => Promise<void>;
|
|
153
176
|
|
|
154
177
|
// ── State ──
|
|
155
178
|
isLoading: boolean;
|
|
@@ -52,6 +52,25 @@ does not block a sync and does not reach the provider either.
|
|
|
52
52
|
so any price authored at a scale other than the currency's synced at the wrong magnitude. Notes older
|
|
53
53
|
than that describe the previous behaviour.)
|
|
54
54
|
|
|
55
|
+
## What a pricing surface needs from a plan
|
|
56
|
+
|
|
57
|
+
Three optional fields decide how every pricing surface presents a product — the application's own
|
|
58
|
+
pricing table AND its public website, which reads this same catalogue at build time and never keeps a
|
|
59
|
+
copy of its prices. Set them here, and nowhere else:
|
|
60
|
+
|
|
61
|
+
| Field | Omitted means | Set it when |
|
|
62
|
+
|---|---|---|
|
|
63
|
+
| `isRecommended` | not recommended | the plan is the one you recommend to the audience the product is designed for. It is shown as a recommendation — never as "most popular", which nothing measured. Recommend at most one plan per audience |
|
|
64
|
+
| `priceDisclosure` (`ProductPriceDisclosure`) | `LISTED` — the prices are the whole offer | `STARTING_AT`: part of the total is quoted (a platform fee, a volume term), so the price reads "From …" and is not published as the offer. `ON_REQUEST`: no price is shown and the action leads to sales |
|
|
65
|
+
| `availability` (`ProductAvailability`) | `AVAILABLE` | `UPCOMING`: the plan is announced on pricing surfaces but cannot be bought yet — checkout, plan changes and add-on purchases refuse it with `BILLING_PRODUCT_NOT_YET_AVAILABLE`, and it is not created at the billing provider, until you put it on sale |
|
|
66
|
+
|
|
67
|
+
`priceDisclosure` changes only what is SHOWN: an on-request plan can still be checked out through a link
|
|
68
|
+
a salesperson sends. `availability` changes what can be BOUGHT. Retiring a plan is neither — remove it
|
|
69
|
+
from the array.
|
|
70
|
+
|
|
71
|
+
A plan still needs a real `prices` entry in every case, because the catalogue syncs to the billing
|
|
72
|
+
provider; the disclosure is how you say that price is not the public offer.
|
|
73
|
+
|
|
55
74
|
## `grantedLimits` composes, and the mode decides how
|
|
56
75
|
|
|
57
76
|
A plan seeds its base limits from the declared grant values. For an add-on, `LimitGrantMode.ADD`
|
|
@@ -116,6 +135,10 @@ export enum ProductType {
|
|
|
116
135
|
ITEM = 'item',
|
|
117
136
|
}
|
|
118
137
|
|
|
138
|
+
// ProductPriceDisclosure / ProductAvailability: declared in `./public-pricing-catalog.shared.atoms`
|
|
139
|
+
// (#1835) — import-free so the website's browser bundle can name them through
|
|
140
|
+
// `@wildo-ai/saas-models/public-runtime`. Not re-exported here; the package root exports the atom.
|
|
141
|
+
|
|
119
142
|
/**
|
|
120
143
|
* Limit grant mode: how this product's limits compose with other products.
|
|
121
144
|
* - SET: absolute value (replaces, used for PLAN base limits)
|
|
@@ -136,7 +159,9 @@ export enum LimitGrantMode {
|
|
|
136
159
|
// request contract has to be able to name the type — see TaxDisplayMode for the same reasoning.
|
|
137
160
|
|
|
138
161
|
/**
|
|
139
|
-
* Billing timing: when
|
|
162
|
+
* Billing timing: when a cancellation takes effect (`behaviorPolicy.cancellation.defaultBehavior`), and when a plan
|
|
163
|
+
* change takes effect (`behaviorPolicy.upgrade.timing` / `downgrade.timing`, #1868). A plan change `at_period_end` is
|
|
164
|
+
* carried as the subscription's `pendingPlanChange` and applied at renewal through a provider subscription schedule.
|
|
140
165
|
*/
|
|
141
166
|
export enum BillingTiming {
|
|
142
167
|
IMMEDIATE = 'immediate',
|
|
@@ -144,6 +169,53 @@ export enum BillingTiming {
|
|
|
144
169
|
}
|
|
145
170
|
```
|
|
146
171
|
|
|
172
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
173
|
+
|
|
174
|
+
```typescript
|
|
175
|
+
/**
|
|
176
|
+
* How much of a product's price a pricing surface may state.
|
|
177
|
+
*
|
|
178
|
+
* The catalogue always carries typed prices — a product cannot sync to the billing provider
|
|
179
|
+
* without one — but a commercial offer is not always fully decided by them. A plan sold as "per
|
|
180
|
+
* member, plus a platform fee we quote" has a real unit price and an unsettled total; an
|
|
181
|
+
* enterprise plan sold by a sales conversation may carry a placeholder price nobody should read.
|
|
182
|
+
* Before this vocabulary existed, every pricing surface either printed that price as if it were
|
|
183
|
+
* the whole offer, or kept its own hand-written list of exceptions (#1835).
|
|
184
|
+
*
|
|
185
|
+
* This is a DISPLAY fact and deliberately NOT an acquisition gate: a customer handed a checkout
|
|
186
|
+
* link for an on-request plan by a salesperson must still be able to pay it, for the same reason a
|
|
187
|
+
* private-but-active plan stays purchasable. Whether the product can
|
|
188
|
+
* be bought today is {@link ProductAvailability}'s question.
|
|
189
|
+
*/
|
|
190
|
+
export enum ProductPriceDisclosure {
|
|
191
|
+
/** The listed prices ARE the offer: a pricing page states them, and structured data may publish them. */
|
|
192
|
+
LISTED = 'listed',
|
|
193
|
+
/**
|
|
194
|
+
* The listed price is a FLOOR: part of the total is not settled (a quoted fee, a volume term).
|
|
195
|
+
* A pricing page states it as a starting price, and structured data must not publish it as the
|
|
196
|
+
* price, because a search engine would show it as the whole offer.
|
|
197
|
+
*/
|
|
198
|
+
STARTING_AT = 'starting_at',
|
|
199
|
+
/** No price is stated: the offer is quoted on request (a "contact sales" plan). */
|
|
200
|
+
ON_REQUEST = 'on_request',
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* Whether a product can be bought today.
|
|
205
|
+
*
|
|
206
|
+
* Distinct from `Product.isActive`, which is RETIREMENT — a product the catalogue withdrew, no
|
|
207
|
+
* longer sold and no longer offered. An UPCOMING product is the opposite end of the same life: it is
|
|
208
|
+
* announced on pricing surfaces so a visitor can see where the product is going, and it cannot be
|
|
209
|
+
* bought yet. Folding it into `isActive: false` would hide it from the very pages that announce it.
|
|
210
|
+
*/
|
|
211
|
+
export enum ProductAvailability {
|
|
212
|
+
/** On sale: the acquisition doors accept it (subject to retirement). */
|
|
213
|
+
AVAILABLE = 'available',
|
|
214
|
+
/** Announced, not yet on sale: listed on pricing surfaces, refused at every acquisition door. */
|
|
215
|
+
UPCOMING = 'upcoming',
|
|
216
|
+
}
|
|
217
|
+
```
|
|
218
|
+
|
|
147
219
|
## Complete synchronization result
|
|
148
220
|
|
|
149
221
|
The backend result contract below is extracted from the owning synchronization service. It describes
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Framework Referral Program
|
|
2
|
+
|
|
3
|
+
`billing.referrals` in the backend config turns on a referral program: an organization issues a code,
|
|
4
|
+
a new customer redeems it, and when that customer pays its first invoice both sides receive the
|
|
5
|
+
rewards the application declared.
|
|
6
|
+
|
|
7
|
+
Read it before declaring a reward. A reward is a promise of money or access, and each kind is
|
|
8
|
+
delivered at a different moment.
|
|
9
|
+
|
|
10
|
+
## The contract
|
|
11
|
+
|
|
12
|
+
## Import Origins
|
|
13
|
+
|
|
14
|
+
- `@wildo-ai/saas-models`
|
|
15
|
+
|
|
16
|
+
## Source Excerpts
|
|
17
|
+
|
|
18
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
19
|
+
|
|
20
|
+
```typescript
|
|
21
|
+
/**
|
|
22
|
+
* The referral program (#1802): whether organizations may issue referral codes, and what each side
|
|
23
|
+
* receives when a referral converts (the referred account's first paid invoice).
|
|
24
|
+
*
|
|
25
|
+
* The rewards are copied onto each referral when its code is issued, so changing them here affects
|
|
26
|
+
* codes issued afterwards and never re-prices a referral already made. A reward's `featureKey` must
|
|
27
|
+
* name a registered boolean feature; startup WARNS about one that does not, like every other feature
|
|
28
|
+
* reference, and a feature nobody registered grants nothing.
|
|
29
|
+
*/
|
|
30
|
+
referrals: z.object({
|
|
31
|
+
/** Off by default: issuing codes that promise rewards is a commercial decision the application makes. */
|
|
32
|
+
enabled: z.boolean().default(false).describe('Whether organizations may issue referral codes. Redeeming and converting codes already issued keeps working when this is turned off.'),
|
|
33
|
+
referrerReward: ReferrerRewardSchema.optional().describe('What the referrer receives when a referral converts. Absent means nothing.'),
|
|
34
|
+
referredReward: ReferredRewardSchema.optional().describe('What the referred account receives. Absent means nothing.'),
|
|
35
|
+
codeValidityDays: z.number().int().min(1).default(30).describe('How many days a referral code can be redeemed after it is issued. Defaults to 30.'),
|
|
36
|
+
}).default(() => ({ enabled: false, codeValidityDays: 30 })),
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
40
|
+
|
|
41
|
+
```typescript
|
|
42
|
+
/** What the referrer receives when the referral converts. */
|
|
43
|
+
export const ReferrerRewardSchema = z.object({
|
|
44
|
+
type: z.enum(ReferrerRewardType).systemEnum('ReferrerRewardType').describe('What the referrer receives: `credit`, `discount` or `feature`.'),
|
|
45
|
+
...rewardFields,
|
|
46
|
+
}).superRefine(refineRewardShape);
|
|
47
|
+
export type ReferrerReward = z.infer<typeof ReferrerRewardSchema>;
|
|
48
|
+
|
|
49
|
+
/** What the referred account receives. */
|
|
50
|
+
export const ReferredRewardSchema = z.object({
|
|
51
|
+
type: z.enum(ReferredRewardType).systemEnum('ReferredRewardType').describe('What the referred account receives: `credit`, `discount`, `feature` or `trial_extension`.'),
|
|
52
|
+
...rewardFields,
|
|
53
|
+
trialExtensionDays: z.number().int().min(1).optional().describe('For a `trial_extension` reward: the days added to the trial of a subscription checkout the referred account opens while the referral is accepted.'),
|
|
54
|
+
}).superRefine(refineRewardShape);
|
|
55
|
+
export type ReferredReward = z.infer<typeof ReferredRewardSchema>;
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
## Declaring the program
|
|
59
|
+
|
|
60
|
+
```ts
|
|
61
|
+
billing: {
|
|
62
|
+
// …
|
|
63
|
+
referrals: {
|
|
64
|
+
enabled: true,
|
|
65
|
+
referrerReward: { type: ReferrerRewardType.CREDIT, credits: 500, creditPoolKey: 'ai_tokens' },
|
|
66
|
+
referredReward: { type: ReferredRewardType.TRIAL_EXTENSION, trialExtensionDays: 14 },
|
|
67
|
+
codeValidityDays: 30,
|
|
68
|
+
},
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
- **Off by default.** Issuing codes that promise rewards is the application's commercial decision.
|
|
73
|
+
- **Rewards are server policy.** Nobody can send a reward with a request. The rewards are copied onto
|
|
74
|
+
each referral when its code is issued, so a later change here applies to codes issued afterwards and
|
|
75
|
+
never re-prices a referral already made.
|
|
76
|
+
- **Each reward kind takes its own fields, and only those.** Startup refuses a `credit` reward without
|
|
77
|
+
`creditPoolKey`, and a `discount` reward carrying a `featureKey`. The table below lists the fields.
|
|
78
|
+
- **A `featureKey` must name a registered boolean feature.** Startup warns about one that does not,
|
|
79
|
+
and an unregistered feature grants nothing.
|
|
80
|
+
- Turning `enabled` off stops new codes. Codes already issued can still be redeemed and converted.
|
|
81
|
+
|
|
82
|
+
## What each reward does, and when
|
|
83
|
+
|
|
84
|
+
| kind | fields | delivered |
|
|
85
|
+
|---|---|---|
|
|
86
|
+
| `credit` | `credits`, `creditPoolKey` | at conversion, as a credit-pool top-up counted in `totalGranted` (not `totalPurchased`). The pool is created if the account has none |
|
|
87
|
+
| `feature` | `featureKey`, `durationDays?` | from conversion, for `durationDays` (or for good when absent). It is derived rather than stored, and the hourly reconciliation run removes it within the hour after it lapses |
|
|
88
|
+
| `discount` | `percentOff`, `discountDuration`, `discountDurationInMonths` (for `repeating` only) | at conversion, as a provider coupon on the account's active subscription. An account with no active subscription keeps the reward waiting, and gets it as soon as a subscription appears. The discounts the subscription already carries are kept, and the subscription's `discounts` lists every one of them in the order the provider applies them, so a referral coupon added beside a promotion appears as a second entry |
|
|
89
|
+
| `trial_extension` | `trialExtensionDays` | referred side only. Added to the trial of every subscription checkout the account opens while its referral is accepted, so it has already been used by the time the account pays |
|
|
90
|
+
|
|
91
|
+
The referrer side has no `trial_extension`: the referrer is an existing customer.
|
|
92
|
+
There is no commission reward. The framework has no way to pay one out.
|
|
93
|
+
|
|
94
|
+
## The lifecycle
|
|
95
|
+
|
|
96
|
+
| step | who | operation |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| issue a code | an owner of the referring organization | `ISSUE` on the organization's referrals |
|
|
99
|
+
| redeem it | the new customer's billing account (organization owner/admin, or the user) | `REDEEM_REFERRAL` on the billing account, body `{ referralCode }` |
|
|
100
|
+
| convert | the billing provider, through the first paid invoice with a total above zero | automatic |
|
|
101
|
+
| grant | the framework, once for each side, even when the provider sends the invoice again | automatic |
|
|
102
|
+
| cancel | an owner of the referring organization, while the referral is pending or accepted | `CANCEL` on the referral |
|
|
103
|
+
|
|
104
|
+
A redemption is refused (`BILLING_REFERRAL_CODE_INVALID`) for an unknown, used, cancelled or expired
|
|
105
|
+
code. It is refused (`BILLING_REFERRAL_ACCOUNT_NOT_ELIGIBLE`) when the account issued the code itself,
|
|
106
|
+
already has a subscription, has already paid an invoice, or has already been referred. A referral
|
|
107
|
+
program is for NEW customers, and each account can be referred once.
|
|
108
|
+
|
|
109
|
+
Only an organization can issue codes, because the referral row belongs to the referring organization.
|
|
110
|
+
The referred account can be an organization or a user.
|
package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md
CHANGED
|
@@ -3,8 +3,8 @@
|
|
|
3
3
|
`behaviorPolicy` on a product definition — trial, upgrade, downgrade, cancellation — plus
|
|
4
4
|
`billing.defaultBehaviorPolicy` in the backend config for the application-wide values.
|
|
5
5
|
|
|
6
|
-
Read it before declaring one
|
|
7
|
-
money depends on
|
|
6
|
+
Read it before declaring one: a downgrade takes effect at the end of the period unless you say
|
|
7
|
+
otherwise, an upgrade takes effect at once, and money depends on knowing which.
|
|
8
8
|
|
|
9
9
|
```ts
|
|
10
10
|
behaviorPolicy: {
|
|
@@ -19,7 +19,8 @@ behaviorPolicy: {
|
|
|
19
19
|
|
|
20
20
|
| field | effect |
|
|
21
21
|
|---|---|
|
|
22
|
-
| `upgrade.proration` / `downgrade.proration` | passed to the provider as a request field. A downgrade declared `NONE` is not prorated |
|
|
22
|
+
| `upgrade.proration` / `downgrade.proration` | passed to the provider as a request field for an IMMEDIATE change. A downgrade declared `NONE` is not prorated |
|
|
23
|
+
| `upgrade.timing` / `downgrade.timing` | when the change takes effect. `immediate` applies it on confirmation; `at_period_end` schedules it at the provider and applies it at renewal. Defaults: upgrade `immediate`, downgrade `at_period_end` |
|
|
23
24
|
| `cancellation.allowImmediate: false` | a **REFUSAL**. Effective immediate timing gets a `409`, whether requested explicitly or inherited from a default; it is never silently downgraded to period-end |
|
|
24
25
|
| `cancellation.defaultBehavior` | decides the timing when the caller expresses NO preference (`cancelImmediately` absent) |
|
|
25
26
|
| `trial.days` / `trial.requirePaymentMethod` | both reach the provider |
|
|
@@ -33,15 +34,29 @@ is permitted even when a default is immediate. Do not author `defaultBehavior: I
|
|
|
33
34
|
contradiction. The runtime also protects previously stored or unparsed policies and application
|
|
34
35
|
fallbacks.
|
|
35
36
|
|
|
36
|
-
##
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
37
|
+
## When a plan change takes effect
|
|
38
|
+
|
|
39
|
+
The NEW plan's `timing` decides it, for the direction of the move: `upgrade.timing` for a move onto
|
|
40
|
+
this plan from a lower tier (or from no plan), `downgrade.timing` for a move from a higher or equal
|
|
41
|
+
tier.
|
|
42
|
+
|
|
43
|
+
- **`immediate`** (the upgrade default): the change applies on confirmation, and `proration` settles
|
|
44
|
+
the unused part of the period. For a downgrade, `NONE` gives the customer no credit for the higher
|
|
45
|
+
plan they paid for, and `CREATE_PRORATIONS` credits it on the next invoice.
|
|
46
|
+
- **`at_period_end`** (the downgrade default): confirming changes nothing now. The provider is given a
|
|
47
|
+
schedule, the subscription carries the change as `pendingPlanChange` (the plan, `effectiveAt`, the
|
|
48
|
+
lines it will then have), and renewal applies it: the items move, entitlements follow, and the
|
|
49
|
+
pending change is cleared. The preview shows the renewal invoice on the new plan, and says
|
|
50
|
+
`timing: at_period_end` with the `effectiveAt` date — show both to the customer.
|
|
51
|
+
|
|
52
|
+
While a change is pending, another plan change, an add-on change and a cancellation are refused
|
|
53
|
+
(`409 billing_subscription_plan_change_pending`). `CANCEL_PLAN_CHANGE` withdraws the pending change,
|
|
54
|
+
and the subscription then renews on its current plan — until five minutes before `effectiveAt`, after
|
|
55
|
+
which it is refused (`409 billing_subscription_plan_change_taking_effect`): the change is landing.
|
|
56
|
+
A deferred change is refused while a cancellation is pending
|
|
57
|
+
(`409 billing_plan_change_subscription_pending_cancellation`: resume first), and when the lines the
|
|
58
|
+
subscription would then carry do not share one billing interval
|
|
59
|
+
(`409 billing_plan_change_billing_interval_mismatch`: a yearly add-on beside a monthly plan).
|
|
45
60
|
|
|
46
61
|
**`defaultCurrency` and `supportedCurrencies` constrain nothing.** No billing path reads either. The
|
|
47
62
|
currency that reaches the provider is the one on the price's own money value, so an application can
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: configure-coding-agent
|
|
3
|
-
description: Configure the autonomous coding agent that edits this application's own workspace — which agent runs, how much it may do without asking, and how much of the host's agent configuration it inherits. Use when the user says "set up the coding agent", "let the AI edit my app", "switch to Codex / OpenCode", "use a different model for coding tasks", "the coding agent can't start", "execution profile not found", "my coding run changed nothing", or "the agent asked for permission and there was nobody to answer", "the research step can't find its profile", or "config sync says the workspace-mutation lock is held". Covers authoring the ACP execution profile, choosing a ceiling that works for a dispatched run, and the per-agent limits you cannot configure away.
|
|
3
|
+
description: Configure the autonomous coding agent that edits this application's own workspace — which agent runs, how much it may do without asking, and how much of the host's agent configuration it inherits. Use when the user says "set up the coding agent", "let the AI edit my app", "switch to Codex / OpenCode", "use a different model for coding tasks", "the coding agent can't start", "the coding agent is not signed in", "execution profile not found", "my coding run changed nothing", or "the agent asked for permission and there was nobody to answer", "the research step can't find its profile", or "config sync says the workspace-mutation lock is held". Covers authoring the ACP execution profile, choosing a ceiling that works for a dispatched run, and the per-agent limits you cannot configure away.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Configuring the coding agent
|
|
@@ -54,7 +55,10 @@ three, because the others are self-explanatory and these are not.
|
|
|
54
55
|
### Step 1 — Decide whether you need to author anything
|
|
55
56
|
|
|
56
57
|
A scaffolded application already has a working `claude-code-acp` profile. If you
|
|
57
|
-
are not changing the agent, the model, or the autonomy, **stop here
|
|
58
|
+
are not changing the agent, the model, or the autonomy, **stop here** — after
|
|
59
|
+
checking that the agent is signed in on this machine: `wildo local doctor`
|
|
60
|
+
names the selected agent and fails when it is not (see
|
|
61
|
+
`references/agent-selection.md` for switching agents and signing in).
|
|
58
62
|
|
|
59
63
|
### Step 2 — Author the profile
|
|
60
64
|
|
|
@@ -211,6 +215,8 @@ read — evidence for a later step to work from, not a validated artifact.
|
|
|
211
215
|
|
|
212
216
|
## Verification
|
|
213
217
|
|
|
218
|
+
- [ ] The selected agent is signed in on this machine (`wildo local doctor`
|
|
219
|
+
passes its coding-agent line).
|
|
214
220
|
- [ ] The profile's key is the ref the coding lane resolves (`claude-code-acp`
|
|
215
221
|
unless you deliberately renamed it and updated the selection).
|
|
216
222
|
- [ ] `allowedApplicationEnvironments` lists DEVELOPMENT only.
|
|
@@ -239,6 +245,9 @@ rg -U 'AGENT_CLIENT_PROTOCOL' -A 200 wildo.saas.config.ts | rg -c 'modelDestinat
|
|
|
239
245
|
|
|
240
246
|
# The research steps resolve this exact profile ref. No match = every research step is refused.
|
|
241
247
|
rg "'claude-code-acp-research':" wildo.saas.config.ts
|
|
248
|
+
|
|
249
|
+
# The selected agent is signed in on this machine (the coding-agent line must pass).
|
|
250
|
+
wildo local doctor
|
|
242
251
|
```
|
|
243
252
|
|
|
244
253
|
## Common Rationalizations
|