@wildo-ai/framework-knowledge 1.1.5 → 1.1.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +320 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +213 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +95 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +250 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1238 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3191 -1126
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +276 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +176 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +223 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +103 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +256 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +29 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5887 -1695
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md
ADDED
|
@@ -0,0 +1,276 @@
|
|
|
1
|
+
# Framework App Shell Building Blocks
|
|
2
|
+
|
|
3
|
+
The signed-in shell's layout container (`AppLayoutPreset_MainContainer_Default`) decides only WHERE the
|
|
4
|
+
regions sit. Everything else — the region components, the content area, the overlays and the providers the
|
|
5
|
+
regions read — comes from building blocks exported by `@wildo-ai/saas-frontend-lib`. A custom layout composes
|
|
6
|
+
the same blocks in a different arrangement.
|
|
7
|
+
|
|
8
|
+
Read this when:
|
|
9
|
+
|
|
10
|
+
- registering a custom layout container (a different arrangement of the sidebar, bars and content);
|
|
11
|
+
- a region appears in the default shell but not in yours — you have probably left its outlet out;
|
|
12
|
+
- dialogs or sheets opened from a region render outside the content area — `AppShellContentOutlet` is
|
|
13
|
+
missing, rendered twice, or outside `AppShellProviders`.
|
|
14
|
+
|
|
15
|
+
Rules worth keeping:
|
|
16
|
+
|
|
17
|
+
- Compute `useAppShellLayout()` once and hand it to `AppShellProviders`; every outlet reads it from there.
|
|
18
|
+
- Place an `AppShellRegionOutlet` for every region the application might configure. An outlet renders
|
|
19
|
+
nothing for a region that is not configured, so placing one is always safe; omitting one drops the region.
|
|
20
|
+
- For a region that sits at an edge (sidebar, utility panel, status bar), pass `placement` when your layout
|
|
21
|
+
puts that edge somewhere specific, and place one outlet per edge it may sit at.
|
|
22
|
+
- Render `AppShellContentOutlet` exactly once: it is the `<main>` landmark and the container overlays portal
|
|
23
|
+
into.
|
|
24
|
+
- Show a loading state only while `useAppShellFirstReady(...)` is `false`. Replacing a mounted shell with a
|
|
25
|
+
spinner on a later readiness drop unmounts the navigation zones and loses their state.
|
|
26
|
+
- Keep the layout's root `position: relative` (not `isolate`) when the theme may paint a background layer,
|
|
27
|
+
or shell text without a positioned ancestor is painted under it.
|
|
28
|
+
|
|
29
|
+
## Import Origins
|
|
30
|
+
|
|
31
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
32
|
+
|
|
33
|
+
## Source Excerpts
|
|
34
|
+
|
|
35
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
36
|
+
|
|
37
|
+
```tsx
|
|
38
|
+
/**
|
|
39
|
+
* # App shell building blocks
|
|
40
|
+
*
|
|
41
|
+
* The signed-in shell is a LAYOUT — where the regions sit — over parts that do not depend on the layout: the
|
|
42
|
+
* region components themselves (each resolved from the component registry by its wrapper), the content area,
|
|
43
|
+
* the overlays, and two providers every region reads. These building blocks are those parts, so a layout
|
|
44
|
+
* preset only decides the ARRANGEMENT. `AppLayoutPreset_MainContainer_Default` is composed from them, and any
|
|
45
|
+
* other layout container an application registers should be too — a different arrangement of the same regions,
|
|
46
|
+
* or, later, an alternative rendering that draws decoration around them.
|
|
47
|
+
*
|
|
48
|
+
* A layout preset uses them like this:
|
|
49
|
+
*
|
|
50
|
+
* ```tsx
|
|
51
|
+
* const layout = useAppShellLayout();
|
|
52
|
+
* const hasBeenReady = useAppShellFirstReady(layout.isLayoutReady);
|
|
53
|
+
* if (!layout.isLayoutReady && !hasBeenReady) return <AppShellLoadingState />;
|
|
54
|
+
* return (
|
|
55
|
+
* <AppShellProviders layout={layout}>
|
|
56
|
+
* <div className="my-arrangement">
|
|
57
|
+
* <AppShellRegionOutlet region={ShellRegion.SIDEBAR} placement={HorizontalPlacement.START} />
|
|
58
|
+
* <AppShellRegionOutlet region={ShellRegion.MENUBAR} />
|
|
59
|
+
* <AppShellContentOutlet className="flex-1 relative min-w-0">{children}</AppShellContentOutlet>
|
|
60
|
+
* <AppShellOverlaysOutlet />
|
|
61
|
+
* </div>
|
|
62
|
+
* </AppShellProviders>
|
|
63
|
+
* );
|
|
64
|
+
* ```
|
|
65
|
+
*
|
|
66
|
+
* Four rules keep a custom layout correct:
|
|
67
|
+
*
|
|
68
|
+
* - **Render `AppShellProviders` exactly once, around the whole shell.** It owns the single open state and the
|
|
69
|
+
* single hotkey registration of the command menu, notification center and quick switcher; two copies would
|
|
70
|
+
* make one shortcut open two dialogs.
|
|
71
|
+
* - **Place every region the application configures.** An outlet renders nothing when its region is not
|
|
72
|
+
* configured, so placing an outlet is always safe; leaving one out silently drops a region.
|
|
73
|
+
* - **Render `AppShellContentOutlet` exactly once.** It is the `<main>` landmark, and overlays portal into it —
|
|
74
|
+
* unless the layout also renders `AppShellOverlayPortalLayer`, which then takes the overlays instead. A layout that
|
|
75
|
+
* transforms its regions (a 3D placement) must render that layer OUTSIDE the transformed subtree: a transformed
|
|
76
|
+
* ancestor is the containing block of every `position: fixed` descendant, so a dialog in `<main>` would be confined
|
|
77
|
+
* to the pane and a menu would be placed in the wrong coordinates.
|
|
78
|
+
* - **Give the root `position: relative`, not `isolation: isolate`,** when the theme may declare a background
|
|
79
|
+
* layer. That layer is painted in its own stacking context above ordinary in-flow content, so shell text with
|
|
80
|
+
* no positioned ancestor is painted UNDER it; positioning the root lifts the whole shell above it. `isolate`
|
|
81
|
+
* would also lift it, but would make the shell one stacking context, so an overlay outside the shell with a
|
|
82
|
+
* lower z-index (a consent prompt) would paint over the shell's own dialogs.
|
|
83
|
+
*/
|
|
84
|
+
|
|
85
|
+
/** The layout decisions `useAppShellLayout()` computed, shared with every outlet below the providers. */
|
|
86
|
+
const AppShellLayoutContext = createContext<AppShellLayoutInfo | null>(null);
|
|
87
|
+
|
|
88
|
+
/** Lets the content outlet hand its `<main>` element to the providers, which expose it as the portal container. */
|
|
89
|
+
const AppShellPortalTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);
|
|
90
|
+
|
|
91
|
+
/** Lets `AppShellOverlayPortalLayer` hand its element to the providers, which then prefer it over `<main>`. */
|
|
92
|
+
const AppShellOverlayLayerTargetContext = createContext<((node: HTMLElement | null) => void) | null>(null);
|
|
93
|
+
|
|
94
|
+
function useAppShellLayoutContext(consumer: string): AppShellLayoutInfo {
|
|
95
|
+
const layout = useContext(AppShellLayoutContext);
|
|
96
|
+
if (!layout) {
|
|
97
|
+
throw new Error(`${consumer} must be rendered inside <AppShellProviders>, which supplies the layout it places regions from.`);
|
|
98
|
+
}
|
|
99
|
+
return layout;
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
/**
|
|
103
|
+
* Latches the FIRST time the shell becomes ready.
|
|
104
|
+
*
|
|
105
|
+
* `isLayoutReady` derives from configuration presence and can drop transiently after bootstrap (an
|
|
106
|
+
* organization switch reloading config, for example). Replacing the mounted shell with a loading state on such
|
|
107
|
+
* a drop would unmount every provider and zone below it and destroy navigation state — the failure mode
|
|
108
|
+
* `AppLoadingGate` documents. So a layout shows its loading state only while this returns `false`.
|
|
109
|
+
*/
|
|
110
|
+
export function useAppShellFirstReady(isLayoutReady: boolean): boolean {
|
|
111
|
+
const [hasLayoutBeenReady, setHasLayoutBeenReady] = useState(false);
|
|
112
|
+
useEffect(() => {
|
|
113
|
+
if (isLayoutReady) setHasLayoutBeenReady(true);
|
|
114
|
+
}, [isLayoutReady]);
|
|
115
|
+
return hasLayoutBeenReady;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* The shell's loading state: a centred spinner on the page background, announced politely. What every layout
|
|
120
|
+
* shows while `useAppShellFirstReady` says the shell has never been ready — one component rather than a copy per
|
|
121
|
+
* layout, so the loading state is the same whatever the disposal.
|
|
122
|
+
*/
|
|
123
|
+
export function AppShellLoadingState(): React.JSX.Element {
|
|
124
|
+
return (
|
|
125
|
+
<Surface asChild emitPolicyVars={false} variant={SurfaceVariant.SHELL} policyOverride={NON_CANONICAL_SHELL_SURFACE_POLICY_OVERRIDE}>
|
|
126
|
+
<div className="h-screen w-screen bg-background flex items-center justify-center" role="status" aria-live="polite">
|
|
127
|
+
<div className="text-center">
|
|
128
|
+
<LoadingSpinner size={32} className="text-primary mx-auto mb-field" aria-hidden="true" />
|
|
129
|
+
</div>
|
|
130
|
+
</div>
|
|
131
|
+
</Surface>
|
|
132
|
+
);
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
export interface AppShellProvidersProps {
|
|
136
|
+
/** The result of `useAppShellLayout()`, computed once by the layout and shared with every outlet. */
|
|
137
|
+
layout: AppShellLayoutInfo;
|
|
138
|
+
children: React.ReactNode;
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
* The providers every shell region reads, and nothing else — they render no DOM of their own:
|
|
143
|
+
*
|
|
144
|
+
* - `PortalContainerContext`, holding the `<main>` element `AppShellContentOutlet` registers, so overlays opened
|
|
145
|
+
* from any region portal into the content area — or, when the layout renders `AppShellOverlayPortalLayer`, that
|
|
146
|
+
* layer instead;
|
|
147
|
+
* - `HostedComponentInteractionsProvider`, the single owner of the open state and the open hotkey of the
|
|
148
|
+
* interactive hosted components (command menu, notification center, quick switcher), which may be hosted in the
|
|
149
|
+
* menubar and the sidebar at once.
|
|
150
|
+
*/
|
|
151
|
+
export function AppShellProviders({ layout, children }: AppShellProvidersProps): React.JSX.Element {
|
|
152
|
+
const [portalContainer, setPortalContainer] = useState<HTMLElement | null>(null);
|
|
153
|
+
const [overlayLayer, setOverlayLayer] = useState<HTMLElement | null>(null);
|
|
154
|
+
const registerPortalTarget = useCallback((node: HTMLElement | null) => {
|
|
155
|
+
setPortalContainer(node);
|
|
156
|
+
}, []);
|
|
157
|
+
const registerOverlayLayer = useCallback((node: HTMLElement | null) => {
|
|
158
|
+
setOverlayLayer(node);
|
|
159
|
+
}, []);
|
|
160
|
+
return (
|
|
161
|
+
<AppShellLayoutContext.Provider value={layout}>
|
|
162
|
+
<AppShellPortalTargetContext.Provider value={registerPortalTarget}>
|
|
163
|
+
<AppShellOverlayLayerTargetContext.Provider value={registerOverlayLayer}>
|
|
164
|
+
{/* The dedicated overlay layer wins when a layout renders one; otherwise overlays stay in `<main>`. */}
|
|
165
|
+
<PortalContainerContext.Provider value={overlayLayer ?? portalContainer}>
|
|
166
|
+
<HostedComponentInteractionsProvider>{children}</HostedComponentInteractionsProvider>
|
|
167
|
+
</PortalContainerContext.Provider>
|
|
168
|
+
</AppShellOverlayLayerTargetContext.Provider>
|
|
169
|
+
</AppShellPortalTargetContext.Provider>
|
|
170
|
+
</AppShellLayoutContext.Provider>
|
|
171
|
+
);
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/**
|
|
175
|
+
* A dedicated layer every overlay (dialog, sheet, menu, popover, tooltip) portals into, for a layout whose regions
|
|
176
|
+
* are TRANSFORMED — a 3D placement. Render it once, inside the providers but OUTSIDE the transformed subtree; the
|
|
177
|
+
* providers then prefer it to `<main>`. A layout that transforms nothing does not need it.
|
|
178
|
+
*
|
|
179
|
+
* It is a zero-size, untransformed, fixed box at the viewport's origin: an overlay positioned `fixed` resolves
|
|
180
|
+
* against the viewport, one positioned `absolute` against the viewport's origin, so floating content lands where its
|
|
181
|
+
* trigger is on screen. It carries the stacking tier overlays need above a layout's own layers.
|
|
182
|
+
*/
|
|
183
|
+
export function AppShellOverlayPortalLayer(): React.JSX.Element {
|
|
184
|
+
const register = useContext(AppShellOverlayLayerTargetContext);
|
|
185
|
+
if (!register) {
|
|
186
|
+
throw new Error('AppShellOverlayPortalLayer must be rendered inside <AppShellProviders>, which exposes it as the portal container.');
|
|
187
|
+
}
|
|
188
|
+
return <div ref={register} data-shell-overlay-layer="" className="fixed left-0 top-0 z-50 h-0 w-0" />;
|
|
189
|
+
}
|
|
190
|
+
|
|
191
|
+
/**
|
|
192
|
+
* Which region to render, and — for a region that sits at an edge — at which edge. The content area is not
|
|
193
|
+
* among them: it has its own outlet, because it owns `<main>` and the page.
|
|
194
|
+
*
|
|
195
|
+
* `placement` renders the region only when the application configured THAT placement. A layout that places the
|
|
196
|
+
* same region at two positions — as the default layout does for the sidebar's start and end edges — renders one
|
|
197
|
+
* outlet per edge. Omitted, the region renders at whatever placement is configured. The type admits only the
|
|
198
|
+
* placement axis the region has, so a sidebar cannot be asked for a vertical edge and render nothing.
|
|
199
|
+
*/
|
|
200
|
+
export type AppShellRegionOutletProps =
|
|
201
|
+
| { region: ShellRegion.SIDEBAR | ShellRegion.UTILITY_PANEL; placement?: HorizontalPlacement.START | HorizontalPlacement.END }
|
|
202
|
+
| { region: ShellRegion.STATUS_BAR; placement?: StatusBarPlacement }
|
|
203
|
+
| { region: ShellRegion.ACTIVITY_BAR | ShellRegion.MENUBAR | ShellRegion.TOOLBAR; placement?: never };
|
|
204
|
+
|
|
205
|
+
/**
|
|
206
|
+
* Renders one shell region's component — the registry-resolved wrapper, with its placement prop — when the
|
|
207
|
+
* application configures that region (and, if `placement` is given, at that placement). Renders nothing
|
|
208
|
+
* otherwise, so placing an outlet for every region is always safe.
|
|
209
|
+
*/
|
|
210
|
+
export function AppShellRegionOutlet(props: AppShellRegionOutletProps): React.JSX.Element | null {
|
|
211
|
+
const layout = useAppShellLayoutContext('AppShellRegionOutlet');
|
|
212
|
+
const { region, placement } = props;
|
|
213
|
+
const at = <T extends HorizontalPlacement | VerticalPlacement>(configured: T): T | null =>
|
|
214
|
+
placement === undefined || placement === configured ? configured : null;
|
|
215
|
+
|
|
216
|
+
switch (region) {
|
|
217
|
+
case ShellRegion.ACTIVITY_BAR:
|
|
218
|
+
return layout.hasActivityBar ? <ApplicationLevel_ActivityBar /> : null;
|
|
219
|
+
case ShellRegion.MENUBAR:
|
|
220
|
+
return layout.hasMenubar ? <ApplicationLevel_MenuBar /> : null;
|
|
221
|
+
case ShellRegion.TOOLBAR:
|
|
222
|
+
return layout.hasToolbar ? <ApplicationLevel_Toolbar /> : null;
|
|
223
|
+
case ShellRegion.SIDEBAR: {
|
|
224
|
+
const sidebarPlacement = at(layout.sidebarPlacement);
|
|
225
|
+
return layout.hasSidebar && sidebarPlacement ? <ApplicationLevel_Sidebar placement={sidebarPlacement} /> : null;
|
|
226
|
+
}
|
|
227
|
+
case ShellRegion.UTILITY_PANEL: {
|
|
228
|
+
const utilityPanelPlacement = at(layout.utilityPanelPlacement);
|
|
229
|
+
return layout.hasUtilityPanel && utilityPanelPlacement ? <ApplicationLevel_UtilityPanel position={utilityPanelPlacement} /> : null;
|
|
230
|
+
}
|
|
231
|
+
case ShellRegion.STATUS_BAR: {
|
|
232
|
+
const statusBarPlacement = at(layout.statusBarPlacement);
|
|
233
|
+
return layout.hasStatusBar && statusBarPlacement ? <ApplicationLevel_StatusBar placement={statusBarPlacement} /> : null;
|
|
234
|
+
}
|
|
235
|
+
default: {
|
|
236
|
+
const unhandled: never = region;
|
|
237
|
+
throw new Error(`AppShellRegionOutlet has no rendering for region "${String(unhandled)}".`);
|
|
238
|
+
}
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
export interface AppShellContentOutletProps {
|
|
243
|
+
/** Classes for the `<main>` element — the layout decides how the content area sizes within its arrangement. */
|
|
244
|
+
className?: string;
|
|
245
|
+
/** The route outlet the layout container receives; rendered by the navigation zones while their stack is empty. */
|
|
246
|
+
children?: React.ReactNode;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/**
|
|
250
|
+
* The content area: the `<main>` landmark carrying `ShellRegion.CONTENT`, the navigation zones, and the floating
|
|
251
|
+
* quick-action button when configured. Its element is registered with `AppShellProviders` as the portal
|
|
252
|
+
* container, so it must be rendered exactly once, inside the providers.
|
|
253
|
+
*/
|
|
254
|
+
export function AppShellContentOutlet({ className, children }: AppShellContentOutletProps): React.JSX.Element {
|
|
255
|
+
const layout = useAppShellLayoutContext('AppShellContentOutlet');
|
|
256
|
+
const registerPortalTarget = useContext(AppShellPortalTargetContext);
|
|
257
|
+
return (
|
|
258
|
+
<main ref={registerPortalTarget ?? undefined} data-component-area={ShellRegion.CONTENT} className={className}>
|
|
259
|
+
<NavigationContentAreas routerChildren={children} />
|
|
260
|
+
|
|
261
|
+
{/* Floating Quick Action Button */}
|
|
262
|
+
{layout.hasQuickActionButton && <ApplicationLevel_QuickActionButton placement="floating" />}
|
|
263
|
+
</main>
|
|
264
|
+
);
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
/** The shell's overlay layer: navigation dialogs and sheets, then guidance (tours, tooltips, highlights). */
|
|
268
|
+
export function AppShellOverlaysOutlet(): React.JSX.Element {
|
|
269
|
+
return (
|
|
270
|
+
<>
|
|
271
|
+
<NavigationOverlays />
|
|
272
|
+
<GuidanceRenderer />
|
|
273
|
+
</>
|
|
274
|
+
);
|
|
275
|
+
}
|
|
276
|
+
```
|
package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md
ADDED
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Framework Shell Region Markers
|
|
2
|
+
|
|
3
|
+
`ShellRegion` (from `@wildo-ai/presets-components-models`) names the painted regions of the signed-in shell.
|
|
4
|
+
Every region's ROOT element carries one as `data-component-area`, with its placement beside it as
|
|
5
|
+
`data-placement`.
|
|
6
|
+
|
|
7
|
+
Read this when:
|
|
8
|
+
|
|
9
|
+
- replacing a shell region's preset (a custom sidebar, menubar, toolbar, status bar…) — the replacement must
|
|
10
|
+
set the same marker on its root, or anything that locates regions stops finding it;
|
|
11
|
+
- writing a browser test or a guidance step that needs to find a region without depending on its markup;
|
|
12
|
+
- building an alternative layout rendering that measures the shell's regions.
|
|
13
|
+
|
|
14
|
+
Rules worth keeping:
|
|
15
|
+
|
|
16
|
+
- Use the enum, never a string: `data-component-area={ShellRegion.SIDEBAR}`.
|
|
17
|
+
- Put the marker on the region's outermost element — the one that tiles the shell — not on an inner child.
|
|
18
|
+
- Placement is not part of the value. A sidebar at the end edge is still `ShellRegion.SIDEBAR`, with
|
|
19
|
+
`data-placement="end"`.
|
|
20
|
+
- The floating quick-action button is not a region; it overlays the content.
|
|
21
|
+
|
|
22
|
+
## Import Origins
|
|
23
|
+
|
|
24
|
+
- `@wildo-ai/presets-components-models`
|
|
25
|
+
|
|
26
|
+
## Source Excerpts
|
|
27
|
+
|
|
28
|
+
### Origin Package: `@wildo-ai/presets-components-models`
|
|
29
|
+
|
|
30
|
+
```typescript
|
|
31
|
+
/**
|
|
32
|
+
* The painted REGIONS of the signed-in application shell — the value of the `data-component-area` attribute
|
|
33
|
+
* every region's ROOT element carries.
|
|
34
|
+
*
|
|
35
|
+
* This is a public contract, not decoration: it is how anything that must find the shell's regions without
|
|
36
|
+
* knowing any preset's markup does so — a browser test, guidance anchoring, and an alternative layout
|
|
37
|
+
* renderer (the optional 3D layout measures each region to draw a surface under it, #1820). A custom 2D preset
|
|
38
|
+
* package that replaces a region preset must set the same marker on its root.
|
|
39
|
+
*
|
|
40
|
+
* Placement is NOT part of the value: it travels separately as `data-placement` (a `HorizontalPlacement` or
|
|
41
|
+
* `VerticalPlacement` value), so one region is one value wherever it sits.
|
|
42
|
+
*
|
|
43
|
+
* Distinct from `ApplicationLevelComponentType`, deliberately: that vocabulary names COMPONENTS an application
|
|
44
|
+
* configures, this one names AREAS the shell paints. The two differ in both directions — the content area
|
|
45
|
+
* (`<main>`) is a region and no component, while the command menu and the hotkey layer are components that own
|
|
46
|
+
* no region. The floating quick-action button is not a region either: it overlays the content, it does not tile.
|
|
47
|
+
*
|
|
48
|
+
* Wire values are kebab-case; `menubar` predates this enum and is selected verbatim by three browser scenarios.
|
|
49
|
+
*/
|
|
50
|
+
export enum ShellRegion {
|
|
51
|
+
/** The top application bar: identity, scope switcher, command-menu trigger, user/organization menu. */
|
|
52
|
+
MENUBAR = 'menubar',
|
|
53
|
+
/** The navigation rail, full height, at the start or end edge (also its mobile drawer, marked `data-mobile-drawer`). */
|
|
54
|
+
SIDEBAR = 'sidebar',
|
|
55
|
+
/** The contextual action bar, above or below the content. */
|
|
56
|
+
TOOLBAR = 'toolbar',
|
|
57
|
+
/** The narrow icon column (or row) of top-level destinations. */
|
|
58
|
+
ACTIVITY_BAR = 'activity-bar',
|
|
59
|
+
/** The full-height column that hosts the utility panel's trigger at the start or end edge. */
|
|
60
|
+
UTILITY_PANEL = 'utility-panel',
|
|
61
|
+
/** The connection/status strip, at the top or bottom edge. */
|
|
62
|
+
STATUS_BAR = 'status-bar',
|
|
63
|
+
/** The `<main>` element: the navigation zones and the page content. */
|
|
64
|
+
CONTENT = 'content',
|
|
65
|
+
}
|
|
66
|
+
```
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: config-design-system
|
|
3
3
|
description: Author or update the design system config (colors, surfaces, surfacePolicies, sidebar, theme materials) and trigger CSS regeneration. Use when the user says "rebrand to <color>", "tweak primary color", "add a new surface token", "configure glass materials", "set the refraction budget", "change SHELL main landmark behavior", "configure surface policy", "switch to a darker sidebar", "regenerate CSS variables", or any change to visual identity / container behavior at the app level rather than a single component.
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Config Design System
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: config-navigation
|
|
3
|
-
description:
|
|
3
|
+
description: Choose and configure how an application navigates — one-thing-at-a-time, list-and-detail, or canvas-with-floating-detail — then declare it as zones, per-operation transitions, viewport overrides and overlay appearance. Use when DECIDING the shape ("how should this app navigate", "should the detail be a page, a pane or a dialog", "design the navigation for these users", "make it work like a tracker / a mailbox / a board") and when CHANGING it ("make creates open in a dialog instead of a new page", "use push instead of overlay on mobile", "add a new navigation zone", "open this resource in the secondary pane").
|
|
4
|
+
user-invocable: false
|
|
4
5
|
---
|
|
5
6
|
|
|
6
7
|
# Config Navigation
|
|
@@ -44,6 +45,7 @@ transition for a click.
|
|
|
44
45
|
|
|
45
46
|
## When to Use
|
|
46
47
|
|
|
48
|
+
- Choosing how a NEW application navigates, from its ICPs and jobs-to-be-done (start at Step 0)
|
|
47
49
|
- Sidebar vs launcher transition behavior changes
|
|
48
50
|
- New navigation zone (multi-pane layout) or overlay policy
|
|
49
51
|
- Viewport-specific responsive navigation policy (mobile push, tablet split)
|
|
@@ -57,6 +59,23 @@ transition for a click.
|
|
|
57
59
|
|
|
58
60
|
## Workflow
|
|
59
61
|
|
|
62
|
+
### Step 0: Decide the SHAPE, if it is not already decided
|
|
63
|
+
|
|
64
|
+
Skip this only when the application already has a navigation layout you are amending. For a new
|
|
65
|
+
application — or when the user is asking how it *should* navigate rather than to change one rule —
|
|
66
|
+
the shape comes first, and it comes from the product rather than from taste.
|
|
67
|
+
|
|
68
|
+
`references/choosing-a-navigation-shape.md`
|
|
69
|
+
|
|
70
|
+
It turns one question — *while the user is reading one record, what else must stay on screen?* —
|
|
71
|
+
into one of three layouts, translates the product shapes you already know (a tracker's peek pane, a
|
|
72
|
+
mailbox's reading pane, a board's floating detail, a dashboard's detail page) into what to declare,
|
|
73
|
+
and names the signals in the ICPs and jobs-to-be-done that move the answer.
|
|
74
|
+
|
|
75
|
+
Two things there decide more than they look like they do: an OVERLAY detail has no URL, so nobody
|
|
76
|
+
can link to it; and the sidebar is app-shell chrome, not a zone, so a "three-pane" product is a
|
|
77
|
+
TWO-zone layout.
|
|
78
|
+
|
|
60
79
|
### Step 1: Locate config
|
|
61
80
|
|
|
62
81
|
Open `frontend/src/config/navigation.config.ts`.
|
|
@@ -70,10 +89,13 @@ Open `frontend/src/config/navigation.config.ts`.
|
|
|
70
89
|
`references/framework-navigation-layout-api.md`
|
|
71
90
|
`references/framework-navigation-zone-declaration-api.md`
|
|
72
91
|
|
|
73
|
-
Understand the **resolution order**
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
92
|
+
Understand the **resolution order** — seven tiers, first answer wins:
|
|
93
|
+
the operation's own `navigationOverrides` → an authored action presentation →
|
|
94
|
+
the relationship transition → the viewport block → the source zone's
|
|
95
|
+
`transitions` → a derived action presentation → the framework fallback — before
|
|
96
|
+
changing any block. Edits to a higher tier silently override lower-tier rules,
|
|
97
|
+
and the first tier is per-resource, so it can outrank a zone map you are
|
|
98
|
+
reading correctly (`references/how-navigation-resolves.md`).
|
|
77
99
|
|
|
78
100
|
### Step 2b: Read a second zone's declaration before adding one
|
|
79
101
|
|
|
@@ -158,9 +180,9 @@ launcher items can target them. Per-resource overrides in
|
|
|
158
180
|
## Worked Example
|
|
159
181
|
|
|
160
182
|
An application `navigationLayoutConfig` can use the canonical full-layout
|
|
161
|
-
shape — a
|
|
162
|
-
the app-level / from-overlay /
|
|
163
|
-
declarative `appearance.overlay`:
|
|
183
|
+
shape — a `primary` zone with explicit per-operation transitions, a
|
|
184
|
+
`secondary` pane for the detail it opens, the app-level / from-overlay /
|
|
185
|
+
mobile-override blocks, and the declarative `appearance.overlay`:
|
|
164
186
|
|
|
165
187
|
|
|
166
188
|
## Usage Example
|
|
@@ -185,11 +207,54 @@ export const navigationLayoutConfig: NavigationLayout = {
|
|
|
185
207
|
overlay: OverlayAppearance.DIALOG,
|
|
186
208
|
},
|
|
187
209
|
},
|
|
210
|
+
|
|
211
|
+
/**
|
|
212
|
+
* The ADJACENT detail pane.
|
|
213
|
+
*
|
|
214
|
+
* ## It is here because a resource ALREADY ASKED FOR IT, and for three months nothing answered
|
|
215
|
+
*
|
|
216
|
+
* `todos.READ` declares `navigationOverrides: [{ transition: SPLIT }]` with a comment saying
|
|
217
|
+
* "the list stays beside it, so 'which one was I comparing this against' survives the click".
|
|
218
|
+
* With no adjacent zone declared, `resolveSplitTarget` escalated every one of those splits to an
|
|
219
|
+
* OVERLAY: the drill-in opened as a DIALOG, and because the operation is ADDRESSABLE the
|
|
220
|
+
* escalation also stripped its URL — the application's main drill-in was unlinkable.
|
|
221
|
+
*
|
|
222
|
+
* Nothing said so. The boot diagnostic reads the LAYOUT and a `navigationOverrides` entry is not
|
|
223
|
+
* in the layout, so it reported clean; the resolver now warns at the decision instead
|
|
224
|
+
* (`useNavigationController`, once per resource+operation), which is the report that would have
|
|
225
|
+
* caught this one.
|
|
226
|
+
*
|
|
227
|
+
* Measured through the real resolver, before and after:
|
|
228
|
+
*
|
|
229
|
+
* before: authored split → { targetZone: overlay, transition: overlay, appearance: dialog }
|
|
230
|
+
* after: authored split → { targetZone: secondary, transition: split, adjustments: [split-opened-free-pane] }
|
|
231
|
+
*
|
|
232
|
+
* ## Why these four fields and not more
|
|
233
|
+
*
|
|
234
|
+
* `onEmpty: COLLAPSE` so the listing keeps the full width until a todo is opened — the pane is
|
|
235
|
+
* an outcome of a click, not a permanent column. `responsiveCollapse: PUSH` at both narrow
|
|
236
|
+
* breakpoints because the content areas render ONE zone on a phone, so a pane that declared
|
|
237
|
+
* nothing there would swallow the drill-in. No `minWidth`: it is a collapse TRIGGER as well as a
|
|
238
|
+
* drag bound, and a floor here would stop the split on a narrow desktop window.
|
|
239
|
+
*/
|
|
240
|
+
secondary: {
|
|
241
|
+
contentModel: NavigationZoneContentModel.SINGLE,
|
|
242
|
+
transitions: {
|
|
243
|
+
/* A reference inside the pane stacks in the pane; back returns to the todo beneath. */
|
|
244
|
+
[CoreResourceOperation.READ]: NavigationTransition.PUSH,
|
|
245
|
+
},
|
|
246
|
+
onEmpty: ZoneEmptyBehavior.COLLAPSE,
|
|
247
|
+
responsiveCollapse: {
|
|
248
|
+
[ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH,
|
|
249
|
+
[ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.PUSH,
|
|
250
|
+
},
|
|
251
|
+
},
|
|
188
252
|
},
|
|
189
253
|
|
|
190
254
|
/**
|
|
191
|
-
* App-level navigation: sidebar clicks, command palette, hotkeys.
|
|
192
|
-
*
|
|
255
|
+
* App-level navigation: sidebar clicks, command palette, hotkeys. It is a layout RESET: LIST and
|
|
256
|
+
* READ replace primary and clear the adjacent pane (all but a pane placed by a `persistent`
|
|
257
|
+
* split), while CREATE opens a dialog over whatever is showing.
|
|
193
258
|
*/
|
|
194
259
|
appLevel: {
|
|
195
260
|
transitions: {
|
|
@@ -246,12 +311,17 @@ What earns its place:
|
|
|
246
311
|
rendering of `OVERLAY` transitions is declared once at the zone
|
|
247
312
|
level, not duplicated per operation.
|
|
248
313
|
- `appLevel.transitions` covers **app-initiated navigation** (sidebar
|
|
249
|
-
clicks, command palette, hotkeys). It
|
|
250
|
-
|
|
314
|
+
clicks, command palette, hotkeys). It is a layout RESET: a destination it
|
|
315
|
+
maps to `REPLACE` replaces primary and clears the adjacent panes (all but a
|
|
316
|
+
`persistent` one), and a destination it maps to `OVERLAY` — CREATE in this
|
|
317
|
+
example — opens a dialog over whatever is showing.
|
|
251
318
|
- `fromOverlay.transitions` covers **navigation initiated from inside
|
|
252
|
-
an overlay** (a link inside a create dialog).
|
|
253
|
-
|
|
254
|
-
|
|
319
|
+
an overlay** (a link inside a create dialog). Read the verbs literally:
|
|
320
|
+
`PUSH` or `REPLACE` from an overlay LEAVES it and lands in primary — the
|
|
321
|
+
whole page changes — while `OVERLAY` stacks a second dialog on the first.
|
|
322
|
+
Nothing keeps a link "inside the dialog"; if that is what you want, the
|
|
323
|
+
target must open as an overlay. A missing entry falls back to primary's
|
|
324
|
+
own map.
|
|
255
325
|
- `[ViewportBreakpoint.MOBILE]` is a **top-level viewport override**.
|
|
256
326
|
Its `transitions` block partially shadows the zone's; on mobile,
|
|
257
327
|
CREATE/UPDATE/DELETE collapse from `OVERLAY` to `PUSH` because
|
|
@@ -269,10 +339,13 @@ What is **not** in this block (and shouldn't be):
|
|
|
269
339
|
|
|
270
340
|
## References
|
|
271
341
|
|
|
342
|
+
- `references/choosing-a-navigation-shape.md` — **read first for a NEW application**: the one question
|
|
343
|
+
the layout answers, the product signals that move it, the industry shapes translated into what to
|
|
344
|
+
declare, and the six engine behaviours that surprise authors
|
|
272
345
|
- `references/navigation-configuration-map.md` — **the inventory**: every configurable aspect, which of
|
|
273
346
|
- `references/framework-content-width-api.md` — the three width caps between a zone and a line of text, who owns each, and the reading-measure tier a display template declares.
|
|
274
347
|
the four levels it is declared at, what it decides, and which fields the runtime does not read
|
|
275
|
-
- `references/how-navigation-resolves.md` — **read first**: the
|
|
348
|
+
- `references/how-navigation-resolves.md` — **read first**: the seven-tier resolution order, where each
|
|
276
349
|
transition puts content, the URL contract, what a layout may declare that the runtime does not read,
|
|
277
350
|
and the fields whose names read backwards
|
|
278
351
|
- `references/framework-navigation-vocabulary-api.md` — the transition verbs and the surface
|
|
@@ -292,6 +365,9 @@ What is **not** in this block (and shouldn't be):
|
|
|
292
365
|
- [ ] Viewport override blocks declare only the keys that actually change
|
|
293
366
|
- [ ] No string-literal `OVERLAY` / `PUSH` / `REPLACE` anywhere
|
|
294
367
|
- [ ] Overlay-emitting transitions have a matching `appearance.overlay` declared at the zone level
|
|
368
|
+
- [ ] Every `SPLIT` has a pane to open — **in the layout AND in every resource's `navigationOverrides`**. A split with no adjacent zone becomes a dialog and, if the operation is `ADDRESSABLE`, loses its URL. The greps below see only the layout; the override case is reported by the runtime (`split-escalated-no-adjacent-zone`)
|
|
369
|
+
- [ ] No `minWidth` / `maxWidth` / `onEmpty` / `responsiveCollapse` on `zones.primary`, where all four are inert
|
|
370
|
+
- [ ] **The application's boot log carries no `Navigation layout:` line** — that is the mechanical form of the two above
|
|
295
371
|
|
|
296
372
|
### Grep invariants
|
|
297
373
|
|
|
@@ -304,11 +380,28 @@ Run from the app root:
|
|
|
304
380
|
| **No string-literal transitions** (must return empty) | `rg -n ":\s+'(OVERLAY\|PUSH\|REPLACE)'" frontend/src/config/navigation.config.ts` |
|
|
305
381
|
| Each zone declares `contentModel` + `transitions` | `rg -n "(contentModel\|transitions):" frontend/src/config/navigation.config.ts` |
|
|
306
382
|
| Viewport override uses the typed key | `rg -n "\[ViewportBreakpoint\." frontend/src/config/navigation.config.ts` |
|
|
383
|
+
| **A SPLIT override has a pane** — if the first returns rows, the second must too | `rg -n "NavigationTransition.SPLIT" --glob '*.ui-behavior.tsx' frontend/src` then `rg -n "secondary:\|companion:" frontend/src/config/navigation.config.ts` |
|
|
307
384
|
|
|
308
385
|
The third invariant (no string-literal transitions) is the high-signal
|
|
309
386
|
one — string literals bypass typecheck, silently misroute, and break
|
|
310
387
|
when transition enum members are renamed.
|
|
311
388
|
|
|
389
|
+
### The two checks the RUNTIME performs for you
|
|
390
|
+
|
|
391
|
+
Neither needs a grep, and both answer questions a static read of the layout cannot.
|
|
392
|
+
|
|
393
|
+
**At boot, the layout is validated and the findings are logged** with their remedies —
|
|
394
|
+
`split-without-adjacent-zone`, `persistent-split-without-companion`, `inert-primary-zone-field`,
|
|
395
|
+
`zone-width-bounds-inverted`. A clean start logs nothing. These are the mistakes that used to produce
|
|
396
|
+
a dialog where a pane was asked for, with no diagnostic anywhere.
|
|
397
|
+
|
|
398
|
+
**At every navigation, the resolution records WHICH TIER decided** and what overruled it afterwards
|
|
399
|
+
(`provenance.transitionSource` / `.authoredTransition` / `.adjustments`, logged by the controller as
|
|
400
|
+
`decidedBy` / `authoredAs` / `adjustments`). When a layout change appears to do nothing, read that
|
|
401
|
+
before doubting the layout: `operation-override` means a resource outranked you, and
|
|
402
|
+
`framework-default` means nothing you declared answered at all. See
|
|
403
|
+
`references/how-navigation-resolves.md`.
|
|
404
|
+
|
|
312
405
|
## Common Rationalizations
|
|
313
406
|
|
|
314
407
|
| Rationalization | Reality |
|
|
@@ -316,10 +409,15 @@ when transition enum members are renamed.
|
|
|
316
409
|
| "Change the route only" | Wildo navigation is zone-aware; there is no "route" without a zone-level transition policy. Skipping the layout decision ships a UX inconsistency. |
|
|
317
410
|
| "I'll use a string `'OVERLAY'`" | Transitions and operations are typed enums (`NavigationTransition.*`, `CoreResourceOperation.*`). String literals bypass typecheck and break renames. |
|
|
318
411
|
| "Viewport overrides should re-declare every transition" | Overrides are sparse on purpose — declare only what changes for that breakpoint, fall through to the zone default for everything else. |
|
|
412
|
+
| "A dialog is fine, the user can always go back" | An overlay has no URL. Nobody can send a colleague to that record, and browser back does not step through selections. Fine for a canvas's node, wrong for a queue people hand to each other |
|
|
413
|
+
| "Three panes like a mailbox, so three zones" | The sidebar is app-shell chrome, not a navigation zone. A three-pane product is sidebar + primary + secondary — a TWO-zone layout |
|
|
414
|
+
| "I'll hold the selection in state and render a panel" | It looks identical and has no URL, no back navigation, no zone semantics and no responsive collapse. If the detail cannot be linked to, that is the tell |
|
|
319
415
|
| "Resource-level navigation overrides aren't real" | They are — `*.ui-behavior.tsx` `navigationOverrides` win over zone defaults. The zone layout is the floor, not the ceiling. |
|
|
320
416
|
|
|
321
417
|
## Red Flags
|
|
322
418
|
|
|
419
|
+
- Most resources carrying a `navigationOverrides` entry — an override is an EXCEPTION, so a layout whose destinations mostly override it is declaring the wrong default (catch with `rg -n "navigationOverrides" --glob '*.ui-behavior.tsx' | wc -l` against the resource count).
|
|
420
|
+
- A detail surface held in component state beside the content instead of in a zone — no URL, no back, no collapse (catch by asking whether the surface can be linked to).
|
|
323
421
|
- Navigation entry pointing at a missing view ref (resolved by `views-app-level` consumers, not this file — but the symptom shows up here as broken transitions).
|
|
324
422
|
- String-literal transition (catch with the **No string-literal transitions** grep — must return empty).
|
|
325
423
|
- Zone declared with `OVERLAY` in `transitions` but no `appearance.overlay` (catch by reading the zone block).
|