@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
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
# saas.frontend.app-shell.building-blocks
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
/**
|
|
13
|
+
* # App shell building blocks
|
|
14
|
+
*
|
|
15
|
+
* The signed-in shell is a LAYOUT — where the regions sit — over parts that do not depend on the layout: the
|
|
16
|
+
* region components themselves (each resolved from the component registry by its wrapper), the content area,
|
|
17
|
+
* the overlays, and two providers every region reads. These building blocks are those parts, so a layout
|
|
18
|
+
* preset only decides the ARRANGEMENT. `AppLayoutPreset_MainContainer_Default` is composed from them, and any
|
|
19
|
+
* other layout container an application registers should be too — a different arrangement of the same regions,
|
|
20
|
+
* or, later, an alternative rendering that draws decoration around them.
|
|
21
|
+
*
|
|
22
|
+
* A layout preset uses them like this:
|
|
23
|
+
*
|
|
24
|
+
* ```tsx
|
|
25
|
+
* const layout = useAppShellLayout();
|
|
26
|
+
* const hasBeenReady = useAppShellFirstReady(layout.isLayoutReady);
|
|
27
|
+
* if (!layout.isLayoutReady && !hasBeenReady) return <AppShellLoadingState />;
|
|
28
|
+
* return (
|
|
29
|
+
* <AppShellProviders layout={layout}>
|
|
30
|
+
* <div className="my-arrangement">
|
|
31
|
+
* <AppShellRegionOutlet region={ShellRegion.SIDEBAR} placement={HorizontalPlacement.START} />
|
|
32
|
+
* <AppShellRegionOutlet region={ShellRegion.MENUBAR} />
|
|
33
|
+
* <AppShellContentOutlet className="flex-1 relative min-w-0">{children}</AppShellContentOutlet>
|
|
34
|
+
* <AppShellOverlaysOutlet />
|
|
35
|
+
* </div>
|
|
36
|
+
* </AppShellProviders>
|
|
37
|
+
* );
|
|
38
|
+
* ```
|
|
39
|
+
*
|
|
40
|
+
* Four rules keep a custom layout correct:
|
|
41
|
+
*
|
|
42
|
+
* - **Render `AppShellProviders` exactly once, around the whole shell.** It owns the single open state and the
|
|
43
|
+
* single hotkey registration of the command menu, notification center and quick switcher; two copies would
|
|
44
|
+
* make one shortcut open two dialogs.
|
|
45
|
+
* - **Place every region the application configures.** An outlet renders nothing when its region is not
|
|
46
|
+
* configured, so placing an outlet is always safe; leaving one out silently drops a region.
|
|
47
|
+
* - **Render `AppShellContentOutlet` exactly once.** It is the `<main>` landmark, and overlays portal into it —
|
|
48
|
+
* unless the layout also renders `AppShellOverlayPortalLayer`, which then takes the overlays instead. A layout that
|
|
49
|
+
* transforms its regions (a 3D placement) must render that layer OUTSIDE the transformed subtree: a transformed
|
|
50
|
+
* ancestor is the containing block of every `position: fixed` descendant, so a dialog in `<main>` would be confined
|
|
51
|
+
* to the pane and a menu would be placed in the wrong coordinates.
|
|
52
|
+
* - **Give the root `position: relative`, not `isolation: isolate`,** when the theme may declare a background
|
|
53
|
+
* layer. That layer is painted in its own stacking context above ordinary in-flow content, so shell text with
|
|
54
|
+
* no positioned ancestor is painted UNDER it; positioning the root lifts the whole shell above it. `isolate`
|
|
55
|
+
* would also lift it, but would make the shell one stacking context, so an overlay outside the shell with a
|
|
56
|
+
* lower z-index (a consent prompt) would paint over the shell's own dialogs.
|
|
57
|
+
*/
|
|
58
|
+
|
|
59
|
+
/** The layout decisions `useAppShellLayout()` computed, shared with every outlet below the providers. */
|
|
60
|
+
const AppShellLayoutContext = createContext<AppShellLayoutInfo | null>(null);
|
|
61
|
+
|
|
62
|
+
/** Lets the content outlet hand its `<main>` element to the providers, which expose it as the portal container. */
|
|
63
|
+
const AppShellPortalTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);
|
|
64
|
+
|
|
65
|
+
/** Lets `AppShellOverlayPortalLayer` hand its element to the providers, which then prefer it over `<main>`. */
|
|
66
|
+
const AppShellOverlayLayerTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);
|
|
67
|
+
|
|
68
|
+
function useAppShellLayoutContext(consumer: string): AppShellLayoutInfo {
|
|
69
|
+
const layout = useContext(AppShellLayoutContext);
|
|
70
|
+
if (!layout) {
|
|
71
|
+
throw new Error(`${consumer} must be rendered inside <AppShellProviders>, which supplies the layout it places regions from.`);
|
|
72
|
+
}
|
|
73
|
+
return layout;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/**
|
|
77
|
+
* Latches the FIRST time the shell becomes ready.
|
|
78
|
+
*
|
|
79
|
+
* `isLayoutReady` derives from configuration presence and can drop transiently after bootstrap (an
|
|
80
|
+
* organization switch reloading config, for example). Replacing the mounted shell with a loading state on such
|
|
81
|
+
* a drop would unmount every provider and zone below it and destroy navigation state — the failure mode
|
|
82
|
+
* `AppLoadingGate` documents. So a layout shows its loading state only while this returns `false`.
|
|
83
|
+
*/
|
|
84
|
+
export function useAppShellFirstReady(isLayoutReady: boolean): boolean {
|
|
85
|
+
const [hasLayoutBeenReady, setHasLayoutBeenReady] = useState(false);
|
|
86
|
+
useEffect(() => {
|
|
87
|
+
if (isLayoutReady) setHasLayoutBeenReady(true);
|
|
88
|
+
}, [isLayoutReady]);
|
|
89
|
+
return hasLayoutBeenReady;
|
|
90
|
+
}
|
|
91
|
+
|
|
92
|
+
/**
|
|
93
|
+
* The shell's loading state: a centred spinner on the page background, announced politely. What every layout
|
|
94
|
+
* shows while `useAppShellFirstReady` says the shell has never been ready — one component rather than a copy per
|
|
95
|
+
* layout, so the loading state is the same whatever the disposal.
|
|
96
|
+
*/
|
|
97
|
+
export function AppShellLoadingState(): React.JSX.Element {
|
|
98
|
+
return (
|
|
99
|
+
<Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>
|
|
100
|
+
<div className="h-screen w-screen bg-background flex items-center justify-center" role="status" aria-live="polite">
|
|
101
|
+
<div className="text-center">
|
|
102
|
+
<LoadingSpinner size={32} className="text-primary mx-auto mb-field" aria-hidden="true" />
|
|
103
|
+
</div>
|
|
104
|
+
</div>
|
|
105
|
+
</Surface>
|
|
106
|
+
);
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export interface AppShellProvidersProps {
|
|
110
|
+
/** The result of `useAppShellLayout()`, computed once by the layout and shared with every outlet. */
|
|
111
|
+
layout: AppShellLayoutInfo;
|
|
112
|
+
children: React.ReactNode;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
/**
|
|
116
|
+
* The providers every shell region reads, and nothing else — they render no DOM of their own:
|
|
117
|
+
*
|
|
118
|
+
* - `PortalContainerContext`, holding the `<main>` element `AppShellContentOutlet` registers, so overlays opened
|
|
119
|
+
* from any region portal into the content area — or, when the layout renders `AppShellOverlayPortalLayer`, that
|
|
120
|
+
* layer instead;
|
|
121
|
+
* - `HostedComponentInteractionsProvider`, the single owner of the open state and the open hotkey of the
|
|
122
|
+
* interactive hosted components (command menu, notification center, quick switcher), which may be hosted in the
|
|
123
|
+
* menubar and the sidebar at once.
|
|
124
|
+
*/
|
|
125
|
+
export function AppShellProviders({ layout, children }: AppShellProvidersProps): React.JSX.Element {
|
|
126
|
+
const [portalContainer, setPortalContainer] = useState<HTMLElement | null>(null);
|
|
127
|
+
const [overlayLayer, setOverlayLayer] = useState<HTMLElement | null>(null);
|
|
128
|
+
const registerPortalTarget = useCallback((node: HTMLElement | null) => {
|
|
129
|
+
setPortalContainer(node);
|
|
130
|
+
}, []);
|
|
131
|
+
const registerOverlayLayer = useCallback((node: HTMLElement | null) => {
|
|
132
|
+
setOverlayLayer(node);
|
|
133
|
+
}, []);
|
|
134
|
+
return (
|
|
135
|
+
<AppShellLayoutContext.Provider value={layout}>
|
|
136
|
+
<AppShellPortalTargetContext.Provider value={registerPortalTarget}>
|
|
137
|
+
<AppShellOverlayLayerTargetContext.Provider value={registerOverlayLayer}>
|
|
138
|
+
{/* The dedicated overlay layer wins when a layout renders one; otherwise overlays stay in `<main>`. */}
|
|
139
|
+
<PortalContainerContext.Provider value={overlayLayer ?? portalContainer}>
|
|
140
|
+
<HostedComponentInteractionsProvider>{children}</HostedComponentInteractionsProvider>
|
|
141
|
+
</PortalContainerContext.Provider>
|
|
142
|
+
</AppShellOverlayLayerTargetContext.Provider>
|
|
143
|
+
</AppShellPortalTargetContext.Provider>
|
|
144
|
+
</AppShellLayoutContext.Provider>
|
|
145
|
+
);
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* A dedicated layer every overlay (dialog, sheet, menu, popover, tooltip) portals into, for a layout whose regions
|
|
150
|
+
* are TRANSFORMED — a 3D placement. Render it once, inside the providers but OUTSIDE the transformed subtree; the
|
|
151
|
+
* providers then prefer it to `<main>`. A layout that transforms nothing does not need it.
|
|
152
|
+
*
|
|
153
|
+
* It is a zero-size, untransformed box at the shell root's origin (the root fills the viewport), with NO z-index and
|
|
154
|
+
* NOT `position: fixed`: either would make it a stacking context and cap every overlay inside it below anything
|
|
155
|
+
* positioned outside the shell — a consent prompt would paint over the shell's own dialogs (the reordering #1830
|
|
156
|
+
* measured and avoided). So each overlay keeps its own global z-index. An overlay positioned `fixed` still resolves
|
|
157
|
+
* against the viewport (nothing between it and the viewport is transformed), one positioned `absolute` against the
|
|
158
|
+
* root's origin, so floating content lands where its trigger is on screen. The layout's root must be positioned.
|
|
159
|
+
*/
|
|
160
|
+
export function AppShellOverlayPortalLayer(): React.JSX.Element {
|
|
161
|
+
const register = useContext(AppShellOverlayLayerTargetContext);
|
|
162
|
+
if (!register) {
|
|
163
|
+
throw new Error('AppShellOverlayPortalLayer must be rendered inside <AppShellProviders>, which exposes it as the portal container.');
|
|
164
|
+
}
|
|
165
|
+
return <div ref={register} data-shell-overlay-layer="" className="absolute left-0 top-0 h-0 w-0" />;
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* Which region to render, and — for a region that sits at an edge — at which edge. The content area is not
|
|
170
|
+
* among them: it has its own outlet, because it owns `<main>` and the page.
|
|
171
|
+
*
|
|
172
|
+
* `placement` renders the region only when the application configured THAT placement. A layout that places the
|
|
173
|
+
* same region at two positions — as the default layout does for the sidebar's start and end edges — renders one
|
|
174
|
+
* outlet per edge. Omitted, the region renders at whatever placement is configured. The type admits only the
|
|
175
|
+
* placement axis the region has, so a sidebar cannot be asked for a vertical edge and render nothing.
|
|
176
|
+
*/
|
|
177
|
+
export type AppShellRegionOutletProps =
|
|
178
|
+
| { region: ShellRegion.SIDEBAR | ShellRegion.UTILITY_PANEL; placement?: HorizontalPlacement.START | HorizontalPlacement.END }
|
|
179
|
+
| { region: ShellRegion.STATUS_BAR; placement?: StatusBarPlacement }
|
|
180
|
+
| { region: ShellRegion.ACTIVITY_BAR | ShellRegion.MENUBAR | ShellRegion.TOOLBAR; placement?: never };
|
|
181
|
+
|
|
182
|
+
/**
|
|
183
|
+
* Renders one shell region's component — the registry-resolved wrapper, with its placement prop — when the
|
|
184
|
+
* application configures that region (and, if `placement` is given, at that placement). Renders nothing
|
|
185
|
+
* otherwise, so placing an outlet for every region is always safe.
|
|
186
|
+
*/
|
|
187
|
+
export function AppShellRegionOutlet(props: AppShellRegionOutletProps): React.JSX.Element | null {
|
|
188
|
+
const layout = useAppShellLayoutContext('AppShellRegionOutlet');
|
|
189
|
+
const { region, placement } = props;
|
|
190
|
+
const at = <T extends HorizontalPlacement | VerticalPlacement>(configured: T): T | null =>
|
|
191
|
+
placement === undefined || placement === configured ? configured : null;
|
|
192
|
+
|
|
193
|
+
switch (region) {
|
|
194
|
+
case ShellRegion.ACTIVITY_BAR:
|
|
195
|
+
return layout.hasActivityBar ? <ApplicationLevel_ActivityBar /> : null;
|
|
196
|
+
case ShellRegion.MENUBAR:
|
|
197
|
+
return layout.hasMenubar ? <ApplicationLevel_MenuBar /> : null;
|
|
198
|
+
case ShellRegion.TOOLBAR:
|
|
199
|
+
return layout.hasToolbar ? <ApplicationLevel_Toolbar /> : null;
|
|
200
|
+
case ShellRegion.SIDEBAR: {
|
|
201
|
+
const sidebarPlacement = at(layout.sidebarPlacement);
|
|
202
|
+
return layout.hasSidebar && sidebarPlacement ? <ApplicationLevel_Sidebar placement={sidebarPlacement} /> : null;
|
|
203
|
+
}
|
|
204
|
+
case ShellRegion.UTILITY_PANEL: {
|
|
205
|
+
const utilityPanelPlacement = at(layout.utilityPanelPlacement);
|
|
206
|
+
return layout.hasUtilityPanel && utilityPanelPlacement ? <ApplicationLevel_UtilityPanel position={utilityPanelPlacement} /> : null;
|
|
207
|
+
}
|
|
208
|
+
case ShellRegion.STATUS_BAR: {
|
|
209
|
+
const statusBarPlacement = at(layout.statusBarPlacement);
|
|
210
|
+
return layout.hasStatusBar && statusBarPlacement ? <ApplicationLevel_StatusBar placement={statusBarPlacement} /> : null;
|
|
211
|
+
}
|
|
212
|
+
default: {
|
|
213
|
+
const unhandled: never = region;
|
|
214
|
+
throw new Error(`AppShellRegionOutlet has no rendering for region "${String(unhandled)}".`);
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
|
|
219
|
+
export interface AppShellContentOutletProps {
|
|
220
|
+
/** Classes for the `<main>` element — the layout decides how the content area sizes within its arrangement. */
|
|
221
|
+
className?: string;
|
|
222
|
+
/** The route outlet the layout container receives; rendered by the navigation zones while their stack is empty. */
|
|
223
|
+
children?: React.ReactNode;
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
/**
|
|
227
|
+
* The content area: the `<main>` landmark carrying `ShellRegion.CONTENT`, the navigation zones, and the floating
|
|
228
|
+
* quick-action button when configured. Its element is registered with `AppShellProviders` as the portal
|
|
229
|
+
* container, so it must be rendered exactly once, inside the providers.
|
|
230
|
+
*/
|
|
231
|
+
export function AppShellContentOutlet({ className, children }: AppShellContentOutletProps): React.JSX.Element {
|
|
232
|
+
const layout = useAppShellLayoutContext('AppShellContentOutlet');
|
|
233
|
+
const registerPortalTarget = useContext(AppShellPortalTargetContext);
|
|
234
|
+
return (
|
|
235
|
+
<main ref={registerPortalTarget ?? undefined} data-component-area={ShellRegion.CONTENT} className={className}>
|
|
236
|
+
<NavigationContentAreas routerChildren={children} />
|
|
237
|
+
|
|
238
|
+
{/* Floating Quick Action Button */}
|
|
239
|
+
{layout.hasQuickActionButton && <ApplicationLevel_QuickActionButton placement="floating" />}
|
|
240
|
+
</main>
|
|
241
|
+
);
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
/** The shell's overlay layer: navigation dialogs and sheets, then guidance (tours, tooltips, highlights). */
|
|
245
|
+
export function AppShellOverlaysOutlet(): React.JSX.Element {
|
|
246
|
+
return (
|
|
247
|
+
<>
|
|
248
|
+
<NavigationOverlays />
|
|
249
|
+
<GuidanceRenderer />
|
|
250
|
+
</>
|
|
251
|
+
);
|
|
252
|
+
}
|
|
253
|
+
```
|
|
@@ -50,7 +50,16 @@ export interface BillingContextType {
|
|
|
50
50
|
// ── Configuration ──
|
|
51
51
|
isEnabled: boolean;
|
|
52
52
|
billingConfiguration: BillingConfiguration | undefined;
|
|
53
|
-
|
|
53
|
+
/**
|
|
54
|
+
* The configured billing provider's REF (`billing.providerRef`), or null when billing is off or
|
|
55
|
+
* names none. Surfaces show the vendor's name from it (`providers.<ref>.displayName`, #1895).
|
|
56
|
+
*
|
|
57
|
+
* It used to be a frontend provider MODULE, resolved from the registry by ref or by the `BILLING`
|
|
58
|
+
* capability. The only such module was Stripe's, which loaded no Stripe code — checkout and the
|
|
59
|
+
* customer portal are hosted redirects — and existed only to carry that name (#1701). The ref is the
|
|
60
|
+
* fact the application configured; a module was a second place that had to agree with it.
|
|
61
|
+
*/
|
|
62
|
+
billingProviderRef: string | null;
|
|
54
63
|
|
|
55
64
|
// ── Billing State ──
|
|
56
65
|
billingAccount: BillingAccount | null;
|
|
@@ -64,6 +73,15 @@ export interface BillingContextType {
|
|
|
64
73
|
productDefinitions: ProductDefinition[];
|
|
65
74
|
getPricesForProduct: (productId: string) => Price[];
|
|
66
75
|
getProductByKey: (key: string) => Product | undefined;
|
|
76
|
+
/**
|
|
77
|
+
* May this product be bought, or moved onto, right now? Answered from the billing state's
|
|
78
|
+
* `acquirableProductKeys` — the set the backend derives with the SAME predicate its checkout,
|
|
79
|
+
* plan-change and add-on doors enforce — so a surface never re-derives it from `isActive` and can
|
|
80
|
+
* never offer a plan the backend refuses (a retired one, or an announced-but-upcoming one, #1835).
|
|
81
|
+
* Fails closed: a state that did not carry the set answers `false`, because an unknown answer must
|
|
82
|
+
* not offer a checkout.
|
|
83
|
+
*/
|
|
84
|
+
isProductAcquirable: (key: string) => boolean;
|
|
67
85
|
|
|
68
86
|
// ── Scope ──
|
|
69
87
|
currentScope: ResourcePrimaryScope | null;
|
|
@@ -76,7 +94,7 @@ export interface BillingContextType {
|
|
|
76
94
|
|
|
77
95
|
// ── Usage & Credits ──
|
|
78
96
|
usage: UsageSummary;
|
|
79
|
-
creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;
|
|
97
|
+
creditPools: Record<string, { available: number; totalPurchased: number; totalGranted: number; totalConsumed: number }>;
|
|
80
98
|
|
|
81
99
|
// ── Actions ──
|
|
82
100
|
openCheckout: (productKey: string, priceId: string, options?: {
|
|
@@ -89,6 +107,11 @@ export interface BillingContextType {
|
|
|
89
107
|
previewPlanChange: (target: BillingPlanChangeTarget, options?: { signal?: AbortSignal }) => Promise<BillingPlanChangePreviewResponse>;
|
|
90
108
|
/** Confirm only the server token returned for the displayed preview. Successful mutation refreshes billing state. */
|
|
91
109
|
confirmPlanChange: (confirmation: BillingPlanChangeConfirmation) => Promise<void>;
|
|
110
|
+
/**
|
|
111
|
+
* Withdraw the plan change pending at the end of the period (`subscription.pendingPlanChange`, #1868), so the subscription renews
|
|
112
|
+
* on its current plan. Successful withdrawal refreshes billing state.
|
|
113
|
+
*/
|
|
114
|
+
cancelPendingPlanChange: () => Promise<void>;
|
|
92
115
|
|
|
93
116
|
// ── State ──
|
|
94
117
|
isLoading: boolean;
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
# saas.frontend.chart-view.resource-chart-data
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/**
|
|
13
|
+
* Read the DATA of a resource's declared chart view, scoped exactly as the rendered chart is.
|
|
14
|
+
*
|
|
15
|
+
* Import from `@wildo-ai/saas-frontend-lib`. Use it when a view needs a chart's numbers without its
|
|
16
|
+
* canvas: KPI tiles, a summary sentence, a count on a badge. It resolves the chart the way an
|
|
17
|
+
* embedded chart does. It finds the resource's `chartViews` entry, turns the entry's declared
|
|
18
|
+
* `primaryScope` (for example the organization) into context from the signed-in session, then
|
|
19
|
+
* fetches.
|
|
20
|
+
*
|
|
21
|
+
* Do not call `useChartData` with a bare `ChartDefinition` for this. That hook is the transport and
|
|
22
|
+
* sends only the context you pass it, so a chart scoped to an organization is refused by the
|
|
23
|
+
* backend with `aggregation_scope_unresolved`.
|
|
24
|
+
*
|
|
25
|
+
* Throws when the resource declares no chart view with that `ref`, the same configuration error an
|
|
26
|
+
* embedded chart raises.
|
|
27
|
+
*
|
|
28
|
+
* @param params.resourceType - the resource whose `chartViews` declares the chart
|
|
29
|
+
* @param params.viewRef - that chart view's `ref`
|
|
30
|
+
* @param params.contextResourceIdentifiers - context you already hold (a parent record's id); merged
|
|
31
|
+
* with what the chart's scope resolves
|
|
32
|
+
* @param params.localErrorOnly - `true` when your view shows the failure itself (a tile), so no
|
|
33
|
+
* page-level error toast is raised
|
|
34
|
+
* @returns `{ data, loading, error, refetch }`; `data.data` holds one row per dimension value, keyed by
|
|
35
|
+
* the query's dimension and measure refs
|
|
36
|
+
*
|
|
37
|
+
* @example
|
|
38
|
+
* const { data, loading, error } = useResourceChartData({
|
|
39
|
+
* resourceType: MyModule_ResourceType.TODOS,
|
|
40
|
+
* viewRef: todosByStatusChartDefinition.ref,
|
|
41
|
+
* localErrorOnly: true,
|
|
42
|
+
* });
|
|
43
|
+
* const total = (data?.data ?? []).reduce((sum, row) => sum + Number(row.count ?? 0), 0);
|
|
44
|
+
*/
|
|
45
|
+
export function useResourceChartData(params: {
|
|
46
|
+
/** The resource whose `frontendConfiguration.chartViews` declares the chart. */
|
|
47
|
+
resourceType: string;
|
|
48
|
+
/** The chart view's `ref` on that resource. */
|
|
49
|
+
viewRef: string;
|
|
50
|
+
/** Context the caller already holds; merged with what the chart's scope resolves. */
|
|
51
|
+
contextResourceIdentifiers?: Record<string, string>;
|
|
52
|
+
inputs?: ChartInputValues;
|
|
53
|
+
urlParamValues?: Record<string, string>;
|
|
54
|
+
/** `true` when the caller shows the failure itself (a tile), so no global error toast is raised. */
|
|
55
|
+
localErrorOnly?: boolean;
|
|
56
|
+
}): ChartDataState {
|
|
57
|
+
const { resourceType, viewRef, contextResourceIdentifiers, inputs, urlParamValues, localErrorOnly = false } = params;
|
|
58
|
+
const { registry } = useResourceRegistry();
|
|
59
|
+
const chartView = registry.resourceConfigurations[resourceType]
|
|
60
|
+
?.frontendConfiguration
|
|
61
|
+
?.chartViews
|
|
62
|
+
?.find((candidate) => candidate.ref === viewRef);
|
|
63
|
+
if (!chartView) {
|
|
64
|
+
throw new Error(`useResourceChartData: resource "${resourceType}" declares no chart view "${viewRef}".`);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const runtimeDescriptor = useMemo(
|
|
68
|
+
() => buildResolvedInsertedChartDescriptor({
|
|
69
|
+
identity: buildResourceInsertedChartIdentity(resourceType, { ref: viewRef }),
|
|
70
|
+
chartView,
|
|
71
|
+
contextResourceIdentifiers: contextResourceIdentifiers ?? {},
|
|
72
|
+
}),
|
|
73
|
+
[resourceType, viewRef, chartView, contextResourceIdentifiers],
|
|
74
|
+
);
|
|
75
|
+
const runtime = useResolvedChartRuntimeDescriptor({
|
|
76
|
+
surfaceDefinition: chartView,
|
|
77
|
+
runtimeDescriptor,
|
|
78
|
+
explicitContextResourceIdentifiers: contextResourceIdentifiers,
|
|
79
|
+
explicitInputs: inputs,
|
|
80
|
+
urlParamValues,
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
return useChartData(
|
|
84
|
+
runtime?.chartDefinition,
|
|
85
|
+
runtime?.executionChartRef,
|
|
86
|
+
runtime?.resolvedInputs,
|
|
87
|
+
runtime?.contextResourceIdentifiers,
|
|
88
|
+
urlParamValues,
|
|
89
|
+
localErrorOnly,
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
```
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# saas.frontend.consent-based-provider-activation
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
/**
|
|
13
|
+
* The consent-based providers currently RUNNING on the application, in registry order (#1704).
|
|
14
|
+
*
|
|
15
|
+
* Empty until the signed-in person grants the purposes a provider rests on, and emptied again on withdrawal or
|
|
16
|
+
* sign-out — immediately, before the providers' `deactivate` has finished. A consumer that dispatches to a
|
|
17
|
+
* provider (`AnalyticsContext` does, for `FRONTEND_PRODUCT_ANALYTICS`) reads this and never holds a handle past it.
|
|
18
|
+
*/
|
|
19
|
+
export function useConsentBasedProviderActivations(): ReadonlyArray<ConsentBasedProviderActivation> {
|
|
20
|
+
return useContext(ConsentBasedProviderActivationsContext);
|
|
21
|
+
}
|
|
22
|
+
```
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
# saas.frontend.form-field-address.lookup-slot
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
/**
|
|
13
|
+
* Props of `FormFieldAddress` (`@wildo-ai/saas-frontend-lib`), the control the framework renders for every
|
|
14
|
+
* field declared with `z_address()`. Forms dispatch to it automatically; an application passes these
|
|
15
|
+
* props itself only when it renders the control directly or fills its lookup slot.
|
|
16
|
+
*/
|
|
17
|
+
export interface FormFieldAddressProps extends Omit<ControlBaseProps, 'value' | 'onChange' | 'defaultValue'> {
|
|
18
|
+
value?: AddressValue;
|
|
19
|
+
/**
|
|
20
|
+
* `undefined` is emitted when the user empties every part of a clearable field — the control's
|
|
21
|
+
* "no address" gesture. A pre-selected country alone is not an entry and does not count.
|
|
22
|
+
*/
|
|
23
|
+
onChange?: (value: AddressValue | undefined) => void;
|
|
24
|
+
defaultValue?: AddressValue;
|
|
25
|
+
/**
|
|
26
|
+
* The resolved, displayable error of each part that has one, keyed by the part's dotted path inside
|
|
27
|
+
* the value (`city`, `coordinates.longitude` — see `listAddressPartPaths`). Resolved by the form,
|
|
28
|
+
* which owns touch/submit visibility; the control only places each message under its input.
|
|
29
|
+
*/
|
|
30
|
+
partErrors?: Readonly<Record<string, string | undefined>>;
|
|
31
|
+
/**
|
|
32
|
+
* Renders an address LOOKUP (a vendor autocomplete) above the parts. Omitted, the field is the plain
|
|
33
|
+
* multi-part control, and it stays fully usable by hand when a lookup is refused or fails. The field
|
|
34
|
+
* decides nothing about which lookup this is and imports no provider code: whoever fills the slot
|
|
35
|
+
* resolves the provider, its consent and its errors, and fills the field through
|
|
36
|
+
* {@link AddressFieldLookupHost.applyAddress}.
|
|
37
|
+
*/
|
|
38
|
+
renderLookup?: (host: AddressFieldLookupHost) => React.ReactNode;
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* What an address field hands to the lookup rendered in its `renderLookup` slot.
|
|
43
|
+
*
|
|
44
|
+
* Deliberately provider-free: every member is the FIELD's own knowledge (its `z_address()` options and
|
|
45
|
+
* its editability) plus one way to fill it. A vendor lookup narrows its suggestions to
|
|
46
|
+
* `countriesAllowed`, ranks by `defaultCountry`, and calls `applyAddress` with the place the person chose.
|
|
47
|
+
*/
|
|
48
|
+
export interface AddressFieldLookupHost {
|
|
49
|
+
/** ISO 3166-1 alpha-2 codes the field accepts, from `z_address({ countriesAllowed })`. Absent means any; never empty. */
|
|
50
|
+
readonly countriesAllowed?: readonly string[];
|
|
51
|
+
/** The field's default country, from `z_address({ defaultCountry })` — a ranking hint for suggestions. */
|
|
52
|
+
readonly defaultCountry?: string;
|
|
53
|
+
/** True while the field is disabled or read-only. A lookup must not offer to fill it then; `applyAddress` ignores the call. */
|
|
54
|
+
readonly disabled: boolean;
|
|
55
|
+
/**
|
|
56
|
+
* Replace every TEXT part and the country with the chosen address, as though the person had typed
|
|
57
|
+
* it, and emit the value.
|
|
58
|
+
*
|
|
59
|
+
* Every text part is replaced, including the ones the chosen address omits: a `line2` left over from
|
|
60
|
+
* the previous address describes a different place, so keeping it would compose an address that exists
|
|
61
|
+
* nowhere.
|
|
62
|
+
*
|
|
63
|
+
* Coordinates are ALWAYS cleared, whatever `address` carries. The previous geocode describes the previous
|
|
64
|
+
* place, and a lookup's geocode is never stored: vendors' terms either forbid storing it or allow it for a
|
|
65
|
+
* limited time, while a stored `coordinates` has no expiry, so nothing would ever delete it on the
|
|
66
|
+
* vendor's clock. The person can still enter coordinates by hand where the field offers them.
|
|
67
|
+
*
|
|
68
|
+
* The value is NOT validated here: it goes through the same form validation as a typed address, so a
|
|
69
|
+
* country outside `countriesAllowed` shows the same error under the country part. A caller that wants to
|
|
70
|
+
* refuse such a value before it reaches the field (the provider path does) validates it first.
|
|
71
|
+
*/
|
|
72
|
+
applyAddress(address: AddressValue): void;
|
|
73
|
+
}
|
|
74
|
+
```
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# saas.frontend.linked-conversations-embed
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
export interface EmbedLinkedConversationsProps {
|
|
13
|
+
className?: string;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* The conversations linked to the host record (#1630) — email threads an inbound channel handler tied to this
|
|
18
|
+
* record with `ctx.thread.link`, newest first. Each opens to its messages in both directions, and an organization
|
|
19
|
+
* administrator can close it.
|
|
20
|
+
*
|
|
21
|
+
* Place it in a READ template or a record composite of the resource your threads are linked to. It is the
|
|
22
|
+
* `conversationThreads` LIST, pinned to this record through `pinnedFilters`: the reader cannot widen it to another
|
|
23
|
+
* record, and it shows only what the reader's own roles may read (organization members read their organization's
|
|
24
|
+
* conversations).
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* // frontend/src/modules/<slug>/resources/matters/MatterReadCustomView.tsx
|
|
28
|
+
* <ResourceLayoutPreset_Read_Default {...props}>
|
|
29
|
+
* <Section name="conversations"><EmbedLinkedConversations /></Section>
|
|
30
|
+
* </ResourceLayoutPreset_Read_Default>
|
|
31
|
+
*/
|
|
32
|
+
export function EmbedLinkedConversations({ className }: EmbedLinkedConversationsProps): React.JSX.Element {
|
|
33
|
+
const { navigationZone, navigationInitiator } = useEmbeddedResourceHostContext();
|
|
34
|
+
const compositeResourceContext = useEmbeddedResourceContext();
|
|
35
|
+
const { hostResourceType, hostResourceId } = compositeResourceContext;
|
|
36
|
+
|
|
37
|
+
const resourceContext = useMemo((): FrontendResourceOperationContext => {
|
|
38
|
+
if (!hostResourceId) {
|
|
39
|
+
throw buildResourceEmbedConfigurationError(
|
|
40
|
+
'EmbedLinkedConversations() needs a host RECORD: place it on a READ surface, where the record it lists conversations for exists.',
|
|
41
|
+
{ hostResourceType },
|
|
42
|
+
);
|
|
43
|
+
}
|
|
44
|
+
const threads = compositeResourceContext.buildOperationContext({
|
|
45
|
+
resourceType: CoreResourceType.CONVERSATION_THREADS,
|
|
46
|
+
operationLike: CoreResourceOperation.LIST,
|
|
47
|
+
requireAddressable: false,
|
|
48
|
+
});
|
|
49
|
+
return {
|
|
50
|
+
...threads,
|
|
51
|
+
pinnedFilters: {
|
|
52
|
+
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_TYPE]: hostResourceType,
|
|
53
|
+
[CONVERSATION_THREAD_LINKED_RESOURCE_FILTER.RESOURCE_ID]: hostResourceId,
|
|
54
|
+
},
|
|
55
|
+
};
|
|
56
|
+
}, [compositeResourceContext, hostResourceType, hostResourceId]);
|
|
57
|
+
|
|
58
|
+
return renderEmbeddedResourceOperation(resourceContext, navigationZone, navigationInitiator, className);
|
|
59
|
+
}
|
|
60
|
+
```
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
|
|
11
11
|
```typescript
|
|
12
12
|
*
|
|
13
|
-
* Per-operation navigation chrome: transition, overlay
|
|
13
|
+
* Per-operation navigation chrome: transition, overlay appearance, source zone.
|
|
14
14
|
*
|
|
15
15
|
* **How to use:** attach fragments of this shape under
|
|
16
16
|
* `ResourceOperationFrontendConfig.navigationOverrides` in `resourceUIBehavior()`.
|
|
@@ -20,10 +20,12 @@
|
|
|
20
20
|
*/
|
|
21
21
|
export const NavigationOperationOverrideSchema = z.object({
|
|
22
22
|
transition: TransitionConfigSchema,
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
23
|
+
/**
|
|
24
|
+
* The overlay chrome this operation wants. Overlay-only since `SplitAppearance` was removed
|
|
25
|
+
* (2026-09-25): a pane's presentation is `SplitConfig` geometry on the layout, not a per-operation
|
|
26
|
+
* choice — see the removal note in `navigation.shared.schemas.ts`.
|
|
27
|
+
*/
|
|
28
|
+
appearance: viewportDiscriminatedSchema(z.enum(OverlayAppearance)).optional(),
|
|
27
29
|
fromZone: z.union([z.enum(NavigationZoneName), z.literal('appLevel')]).optional(),
|
|
28
30
|
viewport: z.enum(ViewportBreakpoint).optional(),
|
|
29
31
|
/**
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# saas.frontend.notifications.publish-badge-count
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* Publish the count of a `FRONTEND_PRODUCED` notification badge — import from `@wildo-ai/saas-frontend-lib`.
|
|
14
|
+
*
|
|
15
|
+
* - `badgeKey`: the badge KEY, `<scope>:<identifier>` — build it with `buildNotificationBadgeKey` from
|
|
16
|
+
* `@wildo-ai/saas-models`, the same key the navigation item's `notificationBadgeRef` names.
|
|
17
|
+
* - `count`: the current count, or `null` while it is not known yet (nothing is published then — a 0
|
|
18
|
+
* would say "nothing is waiting").
|
|
19
|
+
*
|
|
20
|
+
* Publishes nothing for a key whose definition is not `FRONTEND_PRODUCED` (the backend owns that
|
|
21
|
+
* count) or that no definition declares. Call it from a component mounted wherever the navigation
|
|
22
|
+
* showing the badge is — for a menubar or sidebar badge, a shell companion passed as
|
|
23
|
+
* `shellCompanions` to `ApplicationMainProvider`, which the signed-in shell mounts on every page. A
|
|
24
|
+
* badge that mounts later still reads the last published count.
|
|
25
|
+
*
|
|
26
|
+
* @example
|
|
27
|
+
* export function PublishReviewsOwed(): null {
|
|
28
|
+
* const reviews = useReviewsOwedRows(); // rows the page already reads
|
|
29
|
+
* usePublishNotificationBadgeCount(REVIEWS_OWED_BADGE_KEY, reviews === null ? null : reviews.length);
|
|
30
|
+
* return null;
|
|
31
|
+
* }
|
|
32
|
+
*/
|
|
33
|
+
export function usePublishNotificationBadgeCount(badgeKey: string, count: number | null): void {
|
|
34
|
+
const { emit } = useEventBus();
|
|
35
|
+
const { registry } = useResourceRegistry();
|
|
36
|
+
const reported = useRef(false);
|
|
37
|
+
|
|
38
|
+
const definition = registry.notificationBadgeDefinitions.find((candidate) => notificationBadgeIdentityKey(candidate) === badgeKey);
|
|
39
|
+
const publishable = definition?.source.kind === NotificationBadgeSourceKind.FRONTEND_PRODUCED;
|
|
40
|
+
|
|
41
|
+
useEffect(() => {
|
|
42
|
+
if (!publishable) {
|
|
43
|
+
if (!reported.current && envLoader.isDevelopment()) {
|
|
44
|
+
reported.current = true;
|
|
45
|
+
console.warn(definition
|
|
46
|
+
? `[usePublishNotificationBadgeCount] "${badgeKey}" is a ${definition.source.kind} badge; its count is the backend's, so this page does not publish one.`
|
|
47
|
+
: `[usePublishNotificationBadgeCount] "${badgeKey}" names no registered notification badge definition; nothing would draw it.`);
|
|
48
|
+
}
|
|
49
|
+
return;
|
|
50
|
+
}
|
|
51
|
+
if (count === null) return;
|
|
52
|
+
const parsed = parseNotificationBadgeKey(badgeKey);
|
|
53
|
+
if (!parsed) return;
|
|
54
|
+
publishNotificationBadgeCount(emit, {
|
|
55
|
+
badgeReference: buildNotificationBadgeReference(parsed.scope, FRONTEND_PRODUCED_BADGE_SCOPE_ID, parsed.identifier),
|
|
56
|
+
badgeCount: Math.max(0, Math.trunc(count)),
|
|
57
|
+
});
|
|
58
|
+
}, [badgeKey, count, publishable, definition, emit]);
|
|
59
|
+
}
|
|
60
|
+
```
|