@wildo-ai/framework-knowledge 1.1.5 → 1.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claude-marketplace/.claude-plugin/marketplace.json +14 -0
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/agents/wildo-deriver.md +41 -0
- package/dist/claude-marketplace/plugins/wildo/hooks/hooks.json +18 -0
- package/dist/claude-marketplace/plugins/wildo/monitors/monitors.json +8 -0
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +38 -0
- package/dist/{knowledge/skills/journey-run/references/framework-playbook-approval-policy.md → claude-marketplace/plugins/wildo/references/approval-and-failure-policy.md} +10 -8
- package/dist/claude-marketplace/plugins/wildo/references/composites-and-the-loop.md +29 -0
- package/dist/claude-marketplace/plugins/wildo/references/creation-state.md +61 -0
- package/dist/{knowledge/skills/journey-run → claude-marketplace/plugins/wildo}/references/expert-personas-and-deliberations.md +8 -8
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +67 -0
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +43 -0
- package/dist/claude-marketplace/plugins/wildo/skills/answer/SKILL.md +70 -0
- package/dist/claude-marketplace/plugins/wildo/skills/build/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/doctor/SKILL.md +23 -0
- package/dist/claude-marketplace/plugins/wildo/skills/next/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/run/SKILL.md +39 -0
- package/dist/claude-marketplace/plugins/wildo/skills/start/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/status/SKILL.md +38 -0
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +37 -0
- package/dist/esm/framework-knowledge.definitions.d.ts +1 -1
- package/dist/esm/framework-knowledge.definitions.d.ts.map +1 -1
- package/dist/esm/framework-knowledge.definitions.js +321 -11
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +0 -3
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts +12 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js +33 -2
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +8 -5
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js +55 -10
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-dispatch/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js +1 -6
- package/dist/esm/playbooks/bottom_up.build-scale/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.capability-composition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js +7 -3
- package/dist/esm/playbooks/bottom_up.documentation-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts +7 -3
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js +9 -4
- package/dist/esm/playbooks/bottom_up.foundation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +3 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js +4 -3
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js +1 -3
- package/dist/esm/playbooks/bottom_up.maturity-reading/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js +0 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts +10 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js +8 -3
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts +12 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js +33 -5
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts +59 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js +72 -0
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +66 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +115 -0
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts +50 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +54 -0
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.business-model/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts +36 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +67 -17
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts +45 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +46 -0
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -0
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.risk-register/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js +0 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/authority-basis.json +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +8 -8
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +0 -3
- package/dist/knowledge/playbooks/bottom_up.build/method.md +4 -2
- package/dist/knowledge/playbooks/bottom_up.build/playbook.json +31 -7
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.build-decompose/method.md +134 -26
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +7 -4
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +84 -29
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.build-scale/method.md +12 -23
- package/dist/knowledge/playbooks/bottom_up.build-scale/playbook.json +2 -7
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +12 -14
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +20 -2
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +15 -7
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/method.md +8 -6
- package/dist/knowledge/playbooks/bottom_up.documentation-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +3 -4
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +18 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +2 -4
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +8 -5
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +16 -2
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +3 -3
- package/dist/knowledge/playbooks/bottom_up.maturity-reading/playbook.json +1 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +1 -2
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +8 -7
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +11 -4
- package/dist/knowledge/playbooks/cross_cutting.application-creation/playbook.json +27 -5
- package/dist/knowledge/playbooks/cross_cutting.compliance/playbook.json +1 -4
- package/dist/knowledge/playbooks/cross_cutting.feature-development/method.md +42 -0
- package/dist/knowledge/playbooks/cross_cutting.feature-development/playbook.json +73 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +46 -0
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +108 -0
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +112 -21
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +7 -2
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +2 -4
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +48 -0
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +66 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +6 -0
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.compliance-analysis/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +5 -3
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-evidence-adequacy/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.compliance-posture/method.md +0 -4
- package/dist/knowledge/playbooks/top_down.compliance-posture/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.compliance-research/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -4
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +52 -7
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +72 -0
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +57 -0
- package/dist/knowledge/playbooks/top_down.market-analysis/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-evidence-adequacy/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-research/playbook.json +0 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.phase-gate/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +2 -6
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +17 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +2 -5
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -3
- package/dist/knowledge/playbooks/top_down.scope-roadmap/method.md +15 -7
- package/dist/knowledge/playbooks/top_down.scope-roadmap/playbook.json +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/method.md +2 -4
- package/dist/knowledge/playbooks/top_down.value-proposition/playbook.json +1 -2
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +7 -3
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +12 -5
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +212 -0
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +45 -0
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +218 -0
- package/dist/knowledge/references/build-plan.task-graph.config.md +71 -6
- package/dist/knowledge/references/capability-composition.config.md +20 -1
- package/dist/knowledge/references/cli.market.generate-command.md +18 -2
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +7 -22
- package/dist/knowledge/references/engine.saas-technical-doc.provider-component.slot.md +83 -0
- package/dist/knowledge/references/example.authorization.service-provider-organization-wide-access.md +12 -0
- package/dist/knowledge/references/example.backend.addon-wiring.module.md +5 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-postfix.md +7 -3
- package/dist/knowledge/references/example.config.app-shell.command-menu-items.md +7 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +11 -0
- package/dist/knowledge/references/example.config.backend.billing-enable.md +14 -0
- package/dist/knowledge/references/example.config.backend.inbound-email.md +14 -0
- package/dist/knowledge/references/example.config.backend.required-floors.md +7 -0
- package/dist/knowledge/references/example.config.navigation.full.md +45 -2
- package/dist/knowledge/references/example.config.provider-usage-pricing.md +36 -0
- package/dist/knowledge/references/example.config.provider.backend-scope-billing.md +5 -3
- package/dist/knowledge/references/example.config.provider.backend-scope-inbound-email.md +16 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.md +23 -0
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +36 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +26 -3
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +1 -1
- package/dist/knowledge/references/example.inbound.application-endpoint-handler.md +72 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +47 -0
- package/dist/knowledge/references/example.inbound.email-to-todo.md +150 -0
- package/dist/knowledge/references/example.infra.environment-config.local.md +14 -30
- package/dist/knowledge/references/example.layout-3d.own-layout.md +16 -0
- package/dist/knowledge/references/example.layout-3d.registration.md +15 -0
- package/dist/knowledge/references/example.module.companion-exports.full.md +8 -13
- package/dist/knowledge/references/example.module.relationships.discriminator.md +2 -2
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +12 -0
- package/dist/knowledge/references/example.provider.address-lookup.adapter.md +64 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +3 -0
- package/dist/knowledge/references/example.provider.frontend-app.module.md +9 -0
- package/dist/knowledge/references/example.provider.frontend-facet.package-module.md +85 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +14 -13
- package/dist/knowledge/references/example.provider.frontend-file-picker.module.md +18 -0
- package/dist/knowledge/references/example.provider.operation.backend-typed-client.md +11 -11
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +5 -0
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +2 -0
- package/dist/knowledge/references/example.resource.retention-binding.closure-event.md +21 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +1 -2
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +24 -6
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +36 -25
- package/dist/knowledge/references/example.resource.work-unit.declaration.md +13 -0
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +0 -12
- package/dist/knowledge/references/example.views.app-level.composite-views-config.md +1 -1
- package/dist/knowledge/references/example.views.chart-view.resource-owned.md +27 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +4 -1
- package/dist/knowledge/references/example.website.page.manifest.md +30 -0
- package/dist/knowledge/references/experience-plan.config.md +11 -4
- package/dist/knowledge/references/external-connectors.app.frontend-provider-module.md +20 -0
- package/dist/knowledge/references/external-connectors.backend.provider-augmentation.md +75 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-component-declaration.md +85 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +52 -0
- package/dist/knowledge/references/external-connectors.models.connection-rate-budgets.md +113 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +165 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +133 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +44 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +21 -0
- package/dist/knowledge/references/external-connectors.provider-component-load-state.md +45 -0
- package/dist/knowledge/references/external-connectors.provider-component-loader-contribution.md +32 -0
- package/dist/knowledge/references/external-connectors.provider-component-registry.md +190 -0
- package/dist/knowledge/references/external-connectors.techdoc.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/external-connectors.website.frontend-provider-module.md +91 -0
- package/dist/knowledge/references/integration-plan.config.md +34 -2
- package/dist/knowledge/references/market.alternative.config.md +1 -1
- package/dist/knowledge/references/market.buying-journey.config.md +1 -1
- package/dist/knowledge/references/market.category.config.md +1 -1
- package/dist/knowledge/references/market.channel.config.md +1 -1
- package/dist/knowledge/references/market.feature-benefit.config.md +1 -1
- package/dist/knowledge/references/market.gain.config.md +1 -1
- package/dist/knowledge/references/market.icp.config.md +1 -1
- package/dist/knowledge/references/market.job.config.md +1 -1
- package/dist/knowledge/references/market.message-template.config.md +1 -1
- package/dist/knowledge/references/market.objection.config.md +1 -1
- package/dist/knowledge/references/market.pain.config.md +1 -1
- package/dist/knowledge/references/market.persona.config.md +1 -1
- package/dist/knowledge/references/market.positioning.config.md +1 -1
- package/dist/knowledge/references/market.proof.config.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +7 -0
- package/dist/knowledge/references/market.tone-of-voice.config.md +1 -1
- package/dist/knowledge/references/market.trigger.config.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +7 -1
- package/dist/knowledge/references/platform.config.backing-services.md +15 -15
- package/dist/knowledge/references/platform.config.infra-provider-resolution.md +57 -57
- package/dist/knowledge/references/presets.3d.focal-plane-settings.md +45 -0
- package/dist/knowledge/references/presets.3d.frame-style-overrides.md +134 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +235 -0
- package/dist/knowledge/references/presets.3d.register-layout.md +100 -0
- package/dist/knowledge/references/presets.models.labelling.sections.md +5 -0
- package/dist/knowledge/references/presets.models.shell-region.md +47 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -0
- package/dist/knowledge/references/saas.backend.actor-execution-decision-record.md +41 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +1 -1
- package/dist/knowledge/references/saas.backend.authorization.role-ceiling.md +7 -6
- package/dist/knowledge/references/saas.backend.compliance.governed-documents-pdf-template.md +370 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +7 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +93 -15
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +66 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +31 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +200 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-write-tool.md +2 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +73 -0
- package/dist/knowledge/references/saas.backend.providers.connection-target-credential-resolution.md +33 -9
- package/dist/knowledge/references/saas.backend.submission-challenge.md +118 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +98 -0
- package/dist/knowledge/references/saas.backend.system-of-record-action-runner.md +73 -0
- package/dist/knowledge/references/saas.config.providers.augmentations.md +61 -0
- package/dist/knowledge/references/saas.config.providers.packages.md +59 -0
- package/dist/knowledge/references/saas.config.providers.shared-connections.md +84 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +56 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +2 -2
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +253 -0
- package/dist/knowledge/references/saas.frontend.billing-context.md +25 -2
- package/dist/knowledge/references/saas.frontend.chart-view.resource-chart-data.md +92 -0
- package/dist/knowledge/references/saas.frontend.consent-based-provider-activation.md +22 -0
- package/dist/knowledge/references/saas.frontend.form-field-address.lookup-slot.md +74 -0
- package/dist/knowledge/references/saas.frontend.linked-conversations-embed.md +60 -0
- package/dist/knowledge/references/saas.frontend.navigation.operation-override.md +7 -5
- package/dist/knowledge/references/saas.frontend.notifications.publish-badge-count.md +60 -0
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +17 -2
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +49 -0
- package/dist/knowledge/references/saas.frontend.related-resource-sections.md +8 -1
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +9 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +100 -5
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +25 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +61 -0
- package/dist/knowledge/references/saas.market.generation-agent.md +0 -1
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +34 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +45 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +107 -0
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +36 -0
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +50 -0
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +24 -0
- package/dist/knowledge/references/saas.models.audit-trails.actor-attribution.md +97 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +15 -9
- package/dist/knowledge/references/saas.models.auth.service-provider-client-authentication.md +169 -0
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +8 -0
- package/dist/knowledge/references/saas.models.billing.catalog-vocabularies.md +54 -1
- package/dist/knowledge/references/saas.models.billing.referral-program.md +47 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +74 -0
- package/dist/knowledge/references/saas.models.config.tenant-teardown.md +31 -14
- package/dist/knowledge/references/saas.models.conversation-threads.md +242 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +4 -4
- package/dist/knowledge/references/saas.models.engine-capabilities.md +12 -0
- package/dist/knowledge/references/saas.models.engine-capabilities.required-provider-floor.md +5 -1
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +39 -0
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +38 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +667 -6
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +98 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-vocabulary.md +52 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-calendar.md +42 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +84 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +69 -0
- package/dist/knowledge/references/saas.models.frontend-provider-public-config-contract.md +72 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +812 -29
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +81 -0
- package/dist/knowledge/references/saas.models.human-decision-review-marker.md +20 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +277 -0
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +101 -0
- package/dist/knowledge/references/saas.models.inbound-email.md +111 -0
- package/dist/knowledge/references/saas.models.model-cost-accounting-config.md +28 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +87 -0
- package/dist/knowledge/references/saas.models.navigation.layout.md +11 -7
- package/dist/knowledge/references/saas.models.navigation.surface-vocabulary.md +32 -23
- package/dist/knowledge/references/saas.models.navigation.transition-vocabulary.md +8 -4
- package/dist/knowledge/references/saas.models.navigation.zone-declaration.md +22 -20
- package/dist/knowledge/references/saas.models.notifications.badge-vocabularies.md +14 -0
- package/dist/knowledge/references/saas.models.notifications.targets.md +20 -12
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +61 -34
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +9 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +121 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-capability-grants.md +152 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +49 -0
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +567 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +172 -0
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +104 -0
- package/dist/knowledge/references/saas.models.privacy.retention-binding.md +103 -0
- package/dist/knowledge/references/saas.models.privacy.retention-enforcement-record.md +120 -0
- package/dist/knowledge/references/saas.models.privacy.retention-schedule.md +147 -0
- package/dist/knowledge/references/saas.models.privacy.statutory-retention-ground.md +50 -0
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +388 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-contract.md +139 -0
- package/dist/knowledge/references/saas.models.provider-address-lookup-declaration.md +61 -0
- package/dist/knowledge/references/saas.models.provider-capabilities.md +34 -0
- package/dist/knowledge/references/saas.models.provider-credential-identity.md +67 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +139 -0
- package/dist/knowledge/references/saas.models.providers.browser-operation-policy.md +61 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +98 -13
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +57 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +122 -28
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +54 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +6 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +8 -0
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +82 -0
- package/dist/knowledge/references/saas.models.system-of-record-actions.md +226 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +461 -0
- package/dist/knowledge/references/saas.models.systems-of-record.facet-augmentation.md +63 -0
- package/dist/knowledge/references/saas.models.systems-of-record.md +242 -7
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +109 -0
- package/dist/knowledge/references/saas.models.work-unit-ref.md +28 -0
- package/dist/knowledge/references/saas.public-runtime.contract.md +75 -7
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +20 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +106 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +14 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.discriminated-union.md +36 -14
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-aggregate-offer.md +4 -3
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-product.md +4 -4
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.entity-software-application.md +71 -0
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +6 -4
- package/dist/knowledge/references/saas.specifications.compliance.retention-enforcement-state.md +32 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +14 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +77 -0
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +71 -0
- package/dist/knowledge/references/saas.specifications.recipient-population.md +549 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +112 -45
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +13 -1
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +17 -0
- package/dist/knowledge/references/saas.specifications.resource-spec-frontend-prose.md +16 -0
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +98 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +32 -9
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +1 -1
- package/dist/knowledge/references/saas.website.astro.label-loader.md +7 -4
- package/dist/knowledge/references/saas.website.astro.robots-renderer.md +15 -15
- package/dist/knowledge/references/saas.website.astro.site-context.md +5 -2
- package/dist/knowledge/references/saas.website.blog.bridge.md +17 -4
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +61 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +154 -0
- package/dist/knowledge/references/saas.website.consent.banner.md +10 -10
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -4
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +1 -1
- package/dist/knowledge/references/saas.website.factories.define-section.md +3 -3
- package/dist/knowledge/references/saas.website.page-layout.component.md +5 -2
- package/dist/knowledge/references/saas.website.pricing-offer-structured-data.md +140 -0
- package/dist/knowledge/references/saas.website.provider-component.slot.md +99 -0
- package/dist/knowledge/references/saas.website.root-config.schema.md +6 -6
- package/dist/knowledge/references/saas.website.runtime.context.md +23 -4
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +14 -7
- package/dist/knowledge/references/saas.website.seo.robots-config.md +4 -3
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +7 -5
- package/dist/knowledge/references/saas.website.submission-challenge.md +77 -0
- package/dist/knowledge/references/saas.website.use-pricing-catalog.hook.md +36 -0
- package/dist/knowledge/references/saas.website.use-runtime.hook.md +3 -2
- package/dist/knowledge/references/website-plan.config.md +39 -6
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +2 -1
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +21 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +1 -2
- package/dist/knowledge/references/zod.decorators.file-schema.md +11 -10
- package/dist/knowledge/references/zod.decorators.file-vocabularies.md +7 -4
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +8 -2
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +5 -1
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +5 -1
- package/dist/knowledge/references/zod.factories.address.md +7 -7
- package/dist/knowledge/references/zod.factories.code.md +2 -2
- package/dist/knowledge/references/zod.factories.duration.md +4 -4
- package/dist/knowledge/references/zod.factories.money.md +3 -3
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +1248 -54
- package/dist/knowledge/registries/playbooks.json +81 -109
- package/dist/knowledge/registries/source-tags.json +3201 -1118
- package/dist/knowledge/rules/live-context-door.md +29 -0
- package/dist/knowledge/skills/INDEX.md +27 -24
- package/dist/knowledge/skills/agent-work-review/SKILL.md +141 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +38 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +40 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +54 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +28 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +108 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +111 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +43 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +42 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +31 -0
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +1 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +9 -0
- package/dist/knowledge/skills/backend-addon-wiring/SKILL.md +6 -0
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +94 -16
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +21 -8
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +7 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +13 -5
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +30 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +160 -32
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +20 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +14 -2
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +88 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +112 -14
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +209 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +577 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +549 -0
- package/dist/knowledge/skills/config-app-shell/SKILL.md +21 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +2 -2
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +279 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-region-markers-api.md +66 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +1 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +114 -16
- package/dist/knowledge/skills/config-navigation/references/choosing-a-navigation-shape.md +314 -0
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md +11 -7
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-operation-override-api.md +29 -5
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md +40 -27
- package/dist/knowledge/skills/config-navigation/references/framework-navigation-zone-declaration-api.md +22 -20
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +112 -5
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +10 -10
- package/dist/knowledge/skills/config-navigation/references/navigation-zones.md +1 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +3 -1
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +7 -0
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +21 -11
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +5 -1
- package/dist/knowledge/skills/config-saas/references/framework-connection-target-credentials.md +59 -9
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +46 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +251 -12
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +8 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +81 -0
- package/dist/knowledge/skills/config-saas-backend/references/framework-tenant-teardown-api.md +37 -15
- package/dist/knowledge/skills/configure-billing/SKILL.md +64 -24
- package/dist/knowledge/skills/configure-billing/references/config-chain-and-failure-map.md +35 -2
- package/dist/knowledge/skills/configure-billing/references/example-backend-billing-enable-block.md +14 -0
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +3 -0
- package/dist/knowledge/skills/configure-billing/references/framework-billing-frontend-api.md +25 -2
- package/dist/knowledge/skills/configure-billing/references/framework-product-catalog-api.md +73 -1
- package/dist/knowledge/skills/configure-billing/references/framework-referral-program.md +110 -0
- package/dist/knowledge/skills/configure-billing/references/framework-subscription-behavior-policy.md +27 -12
- package/dist/knowledge/skills/configure-coding-agent/SKILL.md +11 -2
- package/dist/knowledge/skills/configure-coding-agent/references/agent-selection.md +26 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +61 -24
- package/dist/knowledge/skills/email-add-template/references/framework-email-attachments-and-limits.md +5 -2
- package/dist/knowledge/skills/email-definition-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/email-labels-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/email-template-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +1 -0
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +6 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +27 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +180 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +56 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +208 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +51 -0
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +27 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +31 -4
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +26 -3
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-audit-agent-attribution-api.md +148 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +287 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +202 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +93 -15
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +96 -11
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +2 -1
- package/dist/knowledge/skills/frontend-cdn-publish/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +1 -0
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -2
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +14 -9
- package/dist/knowledge/skills/guidance-onboarding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +1 -0
- package/dist/knowledge/skills/i18n-label-generation/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +11 -9
- package/dist/knowledge/skills/i18n-rerun-pipeline/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +8 -1
- package/dist/knowledge/skills/i18n-translation-rerun/references/framework-labelling-sections-api.md +5 -0
- package/dist/knowledge/skills/i18n-translation-rerun/references/translation-workflow.md +5 -0
- package/dist/knowledge/skills/inbound-channels/SKILL.md +301 -0
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +133 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +800 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +222 -0
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +231 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +135 -0
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +297 -0
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +150 -44
- package/dist/knowledge/skills/infra-environment-config/references/framework-backing-services-api.md +83 -74
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +180 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-focal-plane-settings-api.md +53 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-frame-style-overrides-api.md +141 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +245 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +108 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +259 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-region-marker-api.md +52 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/layouts-and-transitions.md +43 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/manual-adoption-and-removal.md +25 -0
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +32 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/local-environment-troubleshooting.md +2 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/wildo-cli-bootstrap-commands.md +36 -4
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +2 -1
- package/dist/knowledge/skills/market-add-feature-benefit/references/framework-feature-benefit-api.md +1 -1
- package/dist/knowledge/skills/market-alternatives/SKILL.md +3 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +1 -0
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +7 -0
- package/dist/knowledge/skills/market-category/SKILL.md +2 -1
- package/dist/knowledge/skills/market-channels/SKILL.md +2 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +7 -4
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +6 -4
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +28 -13
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +18 -3
- package/dist/knowledge/skills/market-icp/SKILL.md +2 -1
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +4 -3
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-message-templates-authoring/references/framework-message-template-api.md +1 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/market-positioning-authoring/references/framework-positioning-api.md +1 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +3 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +1 -0
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +2 -1
- package/dist/knowledge/skills/market-triggers-and-journey/SKILL.md +3 -2
- package/dist/knowledge/skills/milestones-and-celebrations/SKILL.md +1 -0
- package/dist/knowledge/skills/minion-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +143 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +211 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +95 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +117 -0
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +677 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +17 -16
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +6 -4
- package/dist/knowledge/skills/module-registration/SKILL.md +2 -1
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +93 -15
- package/dist/knowledge/skills/module-registration/references/framework-notification-badges-api.md +86 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +3 -2
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +34 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +447 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +207 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-field-lookup-slot-api.md +82 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-address-lookup-contract-api.md +214 -0
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +143 -0
- package/dist/knowledge/skills/provider-address-lookup/references/google-places-setup.md +73 -0
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +272 -33
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +227 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-credential-identity-api.md +101 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +245 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +88 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-package-allow-list-api.md +111 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +309 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +132 -23
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +399 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-module-api.md +29 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-public-config-api.md +115 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-provider-component-registry-api.md +386 -0
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +258 -0
- package/dist/knowledge/skills/provider-frontend-module/references/framework-frontend-facet-contracts-api.md +463 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +75 -24
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +3 -3
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +61 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-connection-rate-budgets-api.md +176 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +17 -2
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +15 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +127 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +25 -0
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-add-field/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +1 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +105 -6
- package/dist/knowledge/skills/resource-add-module/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-add-module/references/framework-composition-scenarios-api.md +2 -1
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +3 -0
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +8 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +9 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +17 -1
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +124 -30
- package/dist/knowledge/skills/resource-config-wiring/references/framework-role-ceiling-api.md +7 -6
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +142 -34
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +98 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +86 -52
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +100 -5
- package/dist/knowledge/skills/resource-external-data/SKILL.md +1026 -28
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +144 -0
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +68 -0
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +154 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +686 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +904 -31
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +166 -6
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +152 -0
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +60 -0
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +179 -0
- package/dist/knowledge/skills/resource-external-data/references/pipeline-destination-schema.md +1 -1
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +63 -0
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +122 -0
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +745 -0
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/rest-keyset-sources.md +85 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +442 -0
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +1 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +12 -0
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +186 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +200 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-binding-api.md +111 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-enforcement-records-api.md +173 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-retention-schedule-api.md +155 -0
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +139 -0
- package/dist/knowledge/skills/resource-retention-binding/references/start-point-decisions.md +55 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +2 -2
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +1 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +3 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +28 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +34 -30
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +5 -1
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +101 -42
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +21 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +1 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +125 -6
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +8 -2
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +57 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +61 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +110 -9
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/seeding-operations/SKILL.md +1 -0
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +455 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +270 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +129 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +161 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +224 -0
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +576 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +61 -0
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +43 -37
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +15 -14
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +14 -16
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +6 -4
- package/dist/knowledge/skills/spec-component-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +20 -21
- package/dist/knowledge/skills/spec-family-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-feature-update/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +13 -0
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +158 -46
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +1 -0
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +17 -0
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +5 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +1 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +2 -1
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +43 -1
- package/dist/knowledge/skills/views-chart-authoring/references/framework-resource-chart-data-api.md +102 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +5 -1
- package/dist/knowledge/skills/views-composite-authoring/references/composite-embedding-checklist.md +3 -2
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -0
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +29 -6
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +3 -2
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +17 -4
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +23 -28
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +7 -22
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +167 -20
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +4 -3
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +63 -6
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +275 -0
- package/dist/knowledge/skills/website-label-pack/SKILL.md +13 -5
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -2
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +11 -2
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +117 -33
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +164 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +1 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +1 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +65 -36
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-cta/SKILL.md +32 -22
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-faq/SKILL.md +99 -63
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +27 -18
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +33 -22
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +31 -20
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-hero/SKILL.md +65 -44
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +217 -200
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +248 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +45 -34
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +19 -11
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +8 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +64 -34
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +30 -25
- package/dist/knowledge/skills/worker-authoring/SKILL.md +1 -0
- package/dist/knowledge/topic-index.json +5957 -1729
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/skills/journey-approve/SKILL.md +0 -63
- package/dist/knowledge/skills/journey-bootstrap-scope/SKILL.md +0 -77
- package/dist/knowledge/skills/journey-next/SKILL.md +0 -82
- package/dist/knowledge/skills/journey-report/SKILL.md +0 -56
- package/dist/knowledge/skills/journey-run/SKILL.md +0 -140
- package/dist/knowledge/skills/journey-status/SKILL.md +0 -60
- /package/dist/{knowledge/skills/journey-approve → claude-marketplace/plugins/wildo}/references/specification-family-map.md +0 -0
|
@@ -0,0 +1,314 @@
|
|
|
1
|
+
# Choosing the navigation shape from the product, before configuring anything
|
|
2
|
+
|
|
3
|
+
The rest of this skill answers *how do I declare it*. This file answers the question that comes
|
|
4
|
+
first and is easy to skip: **which shape should this application have at all.**
|
|
5
|
+
|
|
6
|
+
You already know how software navigates — a payments dashboard, an issue tracker, a mailbox, a
|
|
7
|
+
design canvas. What that knowledge does not tell you is which of those shapes THIS product wants, or
|
|
8
|
+
how to say it in this framework. Both halves are below.
|
|
9
|
+
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## START HERE: the framework already NAMES eight shapes
|
|
13
|
+
|
|
14
|
+
`@wildo-ai/presets-components` ships a catalogue of navigation layouts, each a complete
|
|
15
|
+
`NavigationLayout` with the zones and transitions already declared. Read it before writing a layout
|
|
16
|
+
by hand — most applications want one of these, possibly with one zone adjusted.
|
|
17
|
+
|
|
18
|
+
| preset layout | zones | it is the shape of |
|
|
19
|
+
|---|---|---|
|
|
20
|
+
| `NAVIGATION_LAYOUT_STACK` | primary | task managers, SaaS tools, CRMs, project tools — **the default** |
|
|
21
|
+
| `NAVIGATION_LAYOUT_SPLIT` | primary + secondary | list and detail: a tracker, a queue, a pipeline |
|
|
22
|
+
| `NAVIGATION_LAYOUT_TABS` | primary, `contentModel: TABBED` | several records open at once |
|
|
23
|
+
| `NAVIGATION_LAYOUT_WIZARD` | primary | a step-by-step flow: onboarding, a survey, an application form |
|
|
24
|
+
| `NAVIGATION_LAYOUT_PAGED` | primary | a kiosk or a single-purpose screen |
|
|
25
|
+
| `NAVIGATION_LAYOUT_INLINE` | primary, `CREATE`/`UPDATE` → `INPLACE` | editing inside the list: a board, a lightweight CRM |
|
|
26
|
+
| `NAVIGATION_LAYOUT_COMPANION` | primary + companion | a reference kept open beside the work |
|
|
27
|
+
| `NAVIGATION_LAYOUT_TRIPLE` | primary + secondary + companion | a record beside the list AND a reference beside the record — an issue with its thread, a document with its assistant. (A mailbox's folders are the sidebar, not a zone: see below.) |
|
|
28
|
+
|
|
29
|
+
They are wired into whole-application presets too — `APP_EMAIL` and `APP_ERP` both take
|
|
30
|
+
`NAVIGATION_LAYOUT_TRIPLE` — and into kits (`KIT_INLINE_EDIT`, `KIT_WIZARD`). Each carries its own
|
|
31
|
+
"Best for" prose at its declaration; that prose is the authority and this table is a pointer to it.
|
|
32
|
+
|
|
33
|
+
**Use a preset when one fits, and author a layout when none does.** Authoring one is normal and the
|
|
34
|
+
rest of this file is about doing it well — but starting from a named shape means starting from
|
|
35
|
+
something the framework renders, tests and keeps in step with the resolver.
|
|
36
|
+
|
|
37
|
+
---
|
|
38
|
+
|
|
39
|
+
## The layout answers one question
|
|
40
|
+
|
|
41
|
+
> **While the user is reading one record, what else must stay on screen?**
|
|
42
|
+
|
|
43
|
+
Everything else — zones, transitions, appearance, collapse — follows from the answer. Ask it about
|
|
44
|
+
the product's MAIN working surface, the one its users open every day, not about its settings pages.
|
|
45
|
+
|
|
46
|
+
Three answers, and they are the whole vocabulary:
|
|
47
|
+
|
|
48
|
+
| answer | shape | in this framework |
|
|
49
|
+
|---|---|---|
|
|
50
|
+
| **Nothing.** The record is the work. | one thing at a time | ONE zone, `READ` → `PUSH` — `NAVIGATION_LAYOUT_STACK` |
|
|
51
|
+
| **The list it came from**, because the next action is picking another one. | list + detail | a `secondary` zone, `READ` → `SPLIT` — `NAVIGATION_LAYOUT_SPLIT` |
|
|
52
|
+
| **The surface it came from**, because that surface is a map, a board or a canvas the reader keeps orienting by. | canvas + floating detail | ONE zone + a per-operation `OVERLAY` override |
|
|
53
|
+
|
|
54
|
+
If the honest answer is "it depends which record", that is not a fourth shape — it is the third row
|
|
55
|
+
plus a per-operation override on the one destination that disagrees. Do not make it the layout.
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## What in the product definition decides it
|
|
60
|
+
|
|
61
|
+
These are readable from what the journey has already produced. None of them is a matter of taste.
|
|
62
|
+
|
|
63
|
+
| signal | where it comes from | what it moves |
|
|
64
|
+
|---|---|---|
|
|
65
|
+
| **The user handles records in BATCHES** — triages, reviews a queue, works a pipeline | the jobs-to-be-done, the ICP's daily loop | toward list + detail. Picking the next one is most of the work, so the list must not disappear |
|
|
66
|
+
| **The user opens ONE record and stays in it** — writes it, completes it, files it | a job phrased as producing or finishing something | toward one-at-a-time. A pane spends a third of the width on a list nobody is reading |
|
|
67
|
+
| **The records are compared with each other** — amounts, scores, statuses side by side | a job with "which", "compare", "prioritise" in it | toward list + detail, and toward `EMPTY_STATE` rather than `COLLAPSE` |
|
|
68
|
+
| **The main surface is a MAP** — a board, a graph, a timeline, a canvas | the experience/vision artifact naming a board or canvas | toward canvas + floating detail. Taking 40% of a map to show one node shrinks the thing being navigated |
|
|
69
|
+
| **The ICP works on a phone or a tablet** | the ICP's context of use | the shape barely changes — declare `responsiveCollapse` and the split becomes one column below the breakpoint. It does NOT argue for a single-zone layout on desktop |
|
|
70
|
+
| **The record must be LINKABLE** — pasted into a chat, mailed to a colleague, reopened tomorrow | a job involving hand-off, review, approval, audit | away from overlay. Overlay content has no URL (see below) |
|
|
71
|
+
| **Sessions are long and the reader keeps a reference open** — a spec, a policy, a transcript | a job with two documents in it | toward a `companion` zone, which is the second adjacent zone and persists |
|
|
72
|
+
|
|
73
|
+
When two signals disagree, the one describing the DAILY loop wins. A product whose users triage all
|
|
74
|
+
morning and occasionally write a long record is a list-and-detail product with one overridden
|
|
75
|
+
destination, not a one-at-a-time product.
|
|
76
|
+
|
|
77
|
+
---
|
|
78
|
+
|
|
79
|
+
## The patterns you already know, translated
|
|
80
|
+
|
|
81
|
+
Each row is a real product shape. The right column is what to declare — nothing else is needed to
|
|
82
|
+
get that shape, and declaring more is how layouts drift.
|
|
83
|
+
|
|
84
|
+
### One thing at a time — a dashboard whose detail is a page
|
|
85
|
+
|
|
86
|
+
Records are opened, worked and left. Back returns to the list.
|
|
87
|
+
|
|
88
|
+
```
|
|
89
|
+
zones: {
|
|
90
|
+
primary: {
|
|
91
|
+
contentModel: NavigationZoneContentModel.SINGLE,
|
|
92
|
+
transitions: {
|
|
93
|
+
[CoreResourceOperation.LIST]: NavigationTransition.REPLACE,
|
|
94
|
+
[CoreResourceOperation.READ]: NavigationTransition.PUSH,
|
|
95
|
+
[CoreResourceOperation.CREATE]: NavigationTransition.OVERLAY,
|
|
96
|
+
},
|
|
97
|
+
appearance: { overlay: OverlayAppearance.DIALOG },
|
|
98
|
+
},
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
No `secondary`. `split` is then impossible by construction — a `SPLIT` with no adjacent zone
|
|
103
|
+
escalates to an overlay rather than failing, so a layout that "will not split" is usually this one.
|
|
104
|
+
|
|
105
|
+
### List and detail — a tracker or a mailbox reading pane
|
|
106
|
+
|
|
107
|
+
The list stays on the left; selecting a row fills the pane. This is the shape most operational
|
|
108
|
+
products want, and the one whose declaration is most often incomplete.
|
|
109
|
+
|
|
110
|
+
```
|
|
111
|
+
zones: {
|
|
112
|
+
primary: {
|
|
113
|
+
contentModel: NavigationZoneContentModel.SINGLE,
|
|
114
|
+
transitions: {
|
|
115
|
+
[CoreResourceOperation.LIST]: NavigationTransition.REPLACE,
|
|
116
|
+
[CoreResourceOperation.READ]: NavigationTransition.SPLIT,
|
|
117
|
+
[CoreResourceOperation.CREATE]: NavigationTransition.OVERLAY,
|
|
118
|
+
},
|
|
119
|
+
appearance: { overlay: OverlayAppearance.DIALOG },
|
|
120
|
+
},
|
|
121
|
+
secondary: {
|
|
122
|
+
contentModel: NavigationZoneContentModel.SINGLE,
|
|
123
|
+
// a link INSIDE the pane stays in the pane
|
|
124
|
+
transitions: { [CoreResourceOperation.READ]: NavigationTransition.PUSH },
|
|
125
|
+
onEmpty: ZoneEmptyBehavior.COLLAPSE, // or EMPTY_STATE — see below
|
|
126
|
+
responsiveCollapse: {
|
|
127
|
+
[ViewportBreakpoint.VERT_TABLET]: ResponsiveCollapseMode.PUSH,
|
|
128
|
+
[ViewportBreakpoint.MOBILE]: ResponsiveCollapseMode.PUSH,
|
|
129
|
+
},
|
|
130
|
+
},
|
|
131
|
+
},
|
|
132
|
+
split: { ratio: [45, 55], orientation: DisplayDirection.VERTICAL, resizable: true },
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
Four things in that block are load-bearing and each is omitted often:
|
|
136
|
+
|
|
137
|
+
- **`secondary.transitions.READ = PUSH`.** Without it, a reference clicked inside the pane resolves
|
|
138
|
+
`SPLIT` again and lands back in the pane as a REPLACE — so the pane's own Back has no stack entry
|
|
139
|
+
to return to. With it, the pane has a history. It is also the rule a per-resource override can
|
|
140
|
+
silently outrank: a destination declaring `navigationOverrides: [{ transition: SPLIT }]` with no
|
|
141
|
+
`fromZone` resolves SPLIT from INSIDE the pane too, because an operation override is the first
|
|
142
|
+
tier. Scope such an override with `fromZone: NavigationZoneName.PRIMARY` (the next section does).
|
|
143
|
+
- **`onEmpty`** is the "optional pane" switch. `COLLAPSE` means primary is full width until something
|
|
144
|
+
is selected and returns to full width when the pane closes; `EMPTY_STATE` reserves the pane with a
|
|
145
|
+
placeholder so the layout never reflows. Choose `COLLAPSE` when the list is the work and the detail
|
|
146
|
+
is occasional; `EMPTY_STATE` when a reviewer steps through rows and a reflow on every selection
|
|
147
|
+
would be motion sickness.
|
|
148
|
+
- **`responsiveCollapse`** decides what a phone does. Omitting it means `PUSH`, which is the safe
|
|
149
|
+
answer — but declare it anyway, because the alternative (`OVERLAY`) is a real choice for a detail
|
|
150
|
+
that is a confirmation rather than a record.
|
|
151
|
+
- **`orientation: VERTICAL` names the DIVIDER**, so the panes sit side by side. It is the opposite of
|
|
152
|
+
what most panel libraries mean by that word. It is also the ONLY thing that shapes a pane: there is
|
|
153
|
+
no per-zone split appearance (an earlier `appearance.split` / `SplitAppearance` was removed because
|
|
154
|
+
nothing read it).
|
|
155
|
+
|
|
156
|
+
### Canvas and floating detail — a board, a graph, a map
|
|
157
|
+
|
|
158
|
+
The surface is what the reader navigates by, so the detail must float over it rather than take a
|
|
159
|
+
share of it. This is NOT a layout decision — the layout stays one-zone or list-and-detail for
|
|
160
|
+
everything else, and the ONE destination that disagrees says so:
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
[CoreResourceOperation.READ, {
|
|
164
|
+
surface: ResourceOperationFrontendSurface.ADDRESSABLE,
|
|
165
|
+
navigationOverrides: [{
|
|
166
|
+
transition: NavigationTransition.OVERLAY,
|
|
167
|
+
appearance: OverlayAppearance.SHEET,
|
|
168
|
+
overlayBehavior: { modal: false, closeOnOutsideClick: false, showBackdrop: false },
|
|
169
|
+
}],
|
|
170
|
+
}]
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
All three `overlayBehavior` flags matter and they answer different questions: `modal: false` keeps
|
|
174
|
+
the canvas interactive (pan, zoom, click another node to swap the sheet's subject);
|
|
175
|
+
`closeOnOutsideClick: false` is what makes that possible at all, because the first drag on the canvas
|
|
176
|
+
would otherwise dismiss the sheet; `showBackdrop: false` because a dimmed canvas reads as a DISABLED
|
|
177
|
+
canvas.
|
|
178
|
+
|
|
179
|
+
**The cost is the URL** — see the trade below. Take it deliberately.
|
|
180
|
+
|
|
181
|
+
### Host and hosted pane — a dashboard or chart that opens a record beside it
|
|
182
|
+
|
|
183
|
+
A composite view, a chart or a canvas is the primary, and a record opens beside it. Declare the
|
|
184
|
+
`secondary` zone as in list-and-detail, and let the DESTINATION ask for the split:
|
|
185
|
+
|
|
186
|
+
```
|
|
187
|
+
[CoreResourceOperation.READ, {
|
|
188
|
+
surface: ResourceOperationFrontendSurface.ADDRESSABLE,
|
|
189
|
+
navigationOverrides: [{ transition: NavigationTransition.SPLIT, fromZone: NavigationZoneName.PRIMARY }],
|
|
190
|
+
}]
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
`fromZone` is not optional in practice. Without it the override also applies to a click made INSIDE
|
|
194
|
+
the pane, and an operation override outranks the pane's own `transitions` — so a related record
|
|
195
|
+
clicked in the pane re-splits into the occupied pane and replaces the record, leaving nothing to go
|
|
196
|
+
back to.
|
|
197
|
+
|
|
198
|
+
The framework then makes the pane HOSTED on its own: the browser URL stays the host's and the record
|
|
199
|
+
rides as `?pane=<its own url>`, so the board's view state survives and a reload rebuilds both halves.
|
|
200
|
+
Nothing to declare for that — it follows from what primary holds at the moment of the click. Know its
|
|
201
|
+
three limits before relying on it:
|
|
202
|
+
|
|
203
|
+
- **Only a RESOURCE record is hosted.** A reload rebuilds `?pane=` by resolving it as a resource
|
|
204
|
+
route, so a composite view, chart or custom view opened in the pane keeps its OWN url — which
|
|
205
|
+
replaces the host's, and a reload then shows that view instead of the board.
|
|
206
|
+
- **Only the `secondary` zone is hosted.** A companion opened beside a hosted pane does NOT get an
|
|
207
|
+
address of its own: the URL keeps the host and `?pane=`, and a reload restores those two and not
|
|
208
|
+
the companion. (Writing the companion's own URL would drop `?pane=` and close the pane.)
|
|
209
|
+
- **The host must have a URL.** A primary with no address has nothing for the pane to ride on.
|
|
210
|
+
|
|
211
|
+
### Parallel tabs — several records open at once
|
|
212
|
+
|
|
213
|
+
`contentModel: TABBED` on a zone makes every entry a tab: all stay mounted (so switching refetches
|
|
214
|
+
nothing) and the ACTIVE one shows. Every navigation that lands in the zone opens a NEW tab and makes
|
|
215
|
+
it active — including one made from inside a tab, and including a record that is already open in
|
|
216
|
+
another tab (there is no de-duplication). The content model changes how the zone RENDERS, not how
|
|
217
|
+
navigation resolves, so if a link inside a tab should go elsewhere, say so in that zone's
|
|
218
|
+
`transitions`. Only the active tab is URL-addressable today, so a refresh restores one tab. Choose it
|
|
219
|
+
when the user genuinely holds several records open; not as a way to avoid deciding.
|
|
220
|
+
|
|
221
|
+
### A persistent reference alongside — the second adjacent zone
|
|
222
|
+
|
|
223
|
+
`zones.companion` is a second adjacent zone for content that stays while primary and secondary
|
|
224
|
+
change. Reach for it only when the product has a genuine third surface; three panes on a laptop
|
|
225
|
+
leaves each one narrow, and the geometry rules below become load-bearing rather than theoretical.
|
|
226
|
+
|
|
227
|
+
---
|
|
228
|
+
|
|
229
|
+
## The sidebar is NOT a zone
|
|
230
|
+
|
|
231
|
+
The navigation sidebar, menubar and command palette are app-shell CHROME (`config-app-shell`), not
|
|
232
|
+
navigation zones. A "three-pane layout like a mailbox" is therefore **sidebar + primary + secondary**,
|
|
233
|
+
which is a TWO-zone navigation layout. Declaring a third zone to be the sidebar produces a layout
|
|
234
|
+
that is one pane too many and a sidebar that does not behave like one.
|
|
235
|
+
|
|
236
|
+
A sidebar click is app-level navigation: it reads `appLevel.transitions` and is a layout RESET, which
|
|
237
|
+
is why it replaces primary and takes the adjacent panes with it — all except a pane placed by a
|
|
238
|
+
`persistent` split, which is the one thing a reset is designed to leave open.
|
|
239
|
+
|
|
240
|
+
---
|
|
241
|
+
|
|
242
|
+
## The trade that decides the most, stated once
|
|
243
|
+
|
|
244
|
+
**Structural zones are URL-addressed. The overlay layer is not.**
|
|
245
|
+
|
|
246
|
+
A record in primary, secondary or companion gets a browser URL (when its operation is `ADDRESSABLE`),
|
|
247
|
+
so it is linkable, survives a reload, and takes part in browser back and forward. A record in an
|
|
248
|
+
overlay does not.
|
|
249
|
+
|
|
250
|
+
So choosing `OVERLAY` for a detail costs the selection its URL: the reader cannot send a colleague to
|
|
251
|
+
it, and back does not step through selections. For a canvas that is usually the right trade — the map
|
|
252
|
+
is what the URL should name. For a queue of records people hand to each other it is usually wrong,
|
|
253
|
+
and it is the kind of wrong that is discovered months later by a user who wanted to paste a link.
|
|
254
|
+
|
|
255
|
+
Ask the product: **does anyone ever need to send someone else to this exact record?** If yes, it
|
|
256
|
+
belongs in a structural zone.
|
|
257
|
+
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
## Six behaviours to know before you choose, because each one surprises authors
|
|
261
|
+
|
|
262
|
+
1. **An EMBEDDED read opens IN the pane when the pane is FREE, and as a popup when it is TAKEN.** The
|
|
263
|
+
same click is a pane or a popup depending on what is already open. That is deliberate — a free
|
|
264
|
+
pane is a drill-in host, an occupied one would be taken over — but it means "clicking this shows a
|
|
265
|
+
popup" is a statement about STATE, not about the declaration. If you want a popup always, declare
|
|
266
|
+
the operation's own `OVERLAY` override.
|
|
267
|
+
2. **A popup opened from a popup STACKS, and Back returns to the one beneath.** A graph of references
|
|
268
|
+
is walkable popup to popup and walkable back out. You do not have to flatten it.
|
|
269
|
+
3. **A `COLLAPSE` pane gets a close control; an `EMPTY_STATE` pane does not.** The framework offers
|
|
270
|
+
the affordance exactly where closing returns width. This is derived from `onEmpty` — there is no
|
|
271
|
+
second flag, and adding a close button in the view is how the two drift.
|
|
272
|
+
4. **`fromOverlay` is optional.** A navigation out of an overlay that the block does not answer falls
|
|
273
|
+
back to PRIMARY's transition map, because an overlay is not a structural zone and that navigation
|
|
274
|
+
lands in primary. Declare `fromOverlay` only when leaving an overlay should differ from an
|
|
275
|
+
ordinary click on the page.
|
|
276
|
+
5. **Declaring `secondary` is the switch that makes `SPLIT` possible at all** — with no adjacent
|
|
277
|
+
zone a split escalates to an overlay instead. It does NOT by itself route anything there: a
|
|
278
|
+
destination still has to resolve to `SPLIT`. What it does change unconditionally is the content
|
|
279
|
+
area's render branch (the outer container stops being the scroll container, and each column takes
|
|
280
|
+
that role), and a relationship quick-create launched from inside a dialog now opens the pane
|
|
281
|
+
rather than a nested dialog. Declare it when the product wants list-and-detail, not "in case".
|
|
282
|
+
6. **A `minWidth` can make the split escalate on a desktop window** — the pane needs its floor
|
|
283
|
+
plus primary's 25%, so a declared floor of `W` needs a CONTENT AREA of `W / 0.75`, and the content
|
|
284
|
+
area is the window minus the sidebar and any pane already open. A 1024px window with a 256px
|
|
285
|
+
sidebar leaves 768px, so any `minWidth` above 576px escalates there; a 600px floor on a 1000px
|
|
286
|
+
content area escalates too. Below the threshold the split becomes the zone's `responsiveCollapse`
|
|
287
|
+
mode even on a desktop breakpoint, and `minWidth` does this whether or not the split is
|
|
288
|
+
`resizable`.
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## The order to decide in
|
|
293
|
+
|
|
294
|
+
0. **Look at the eight named preset layouts first.** Most products want one of them. Authoring from
|
|
295
|
+
scratch is fine and is what the rest of this file is for — but not before checking.
|
|
296
|
+
1. **Name the main working surface** — the one the ICP opens daily. Not settings, not onboarding.
|
|
297
|
+
2. **Answer the one question** at the top of this file for that surface.
|
|
298
|
+
3. **Declare the layout** for that answer, from the matching pattern above. Nothing more.
|
|
299
|
+
4. **Find the destinations that disagree** and give each a per-operation override. A canvas, a chart,
|
|
300
|
+
a board. Expect one or two; if you are writing five, the layout is wrong.
|
|
301
|
+
5. **Decide `onEmpty` from the reading loop** — stepping through rows wants `EMPTY_STATE`,
|
|
302
|
+
occasional detail wants `COLLAPSE`.
|
|
303
|
+
6. **Declare `responsiveCollapse`** on every adjacent zone, even when `PUSH` is what you want.
|
|
304
|
+
7. **Check the URL trade** for every destination you put in an overlay.
|
|
305
|
+
|
|
306
|
+
## What NOT to do
|
|
307
|
+
|
|
308
|
+
| tempting | what it actually produces |
|
|
309
|
+
|---|---|
|
|
310
|
+
| holding the selection in `useState` and rendering a panel beside the content | something that looks identical and has no URL, no back navigation, no zone semantics and no responsive collapse. If a detail surface cannot be linked to, that is the tell |
|
|
311
|
+
| declaring a zone per surface the product has | zones are LAYOUT POSITIONS, not destinations. Two adjacent zones is already a lot; the destinations are resources and views |
|
|
312
|
+
| giving every resource a `navigationOverrides` entry | an override is an EXCEPTION to the layout. When most resources carry one, the layout is declaring the wrong default |
|
|
313
|
+
| copying a layout from another application | the layout encodes that product's daily loop. Copy the PATTERN from this file, then answer the question for this product |
|
|
314
|
+
| deciding navigation after the resources are built | the shape decides whether a detail needs its own page chrome, whether a list wants selection affordances, and whether operations should be addressable. Deciding it late means revisiting all three |
|
package/dist/knowledge/skills/config-navigation/references/framework-navigation-layout-api.md
CHANGED
|
@@ -19,12 +19,15 @@
|
|
|
19
19
|
* behavior. It specifies which zones exist, how each zone handles operations,
|
|
20
20
|
* how zones are sized relative to each other, and global overrides.
|
|
21
21
|
*
|
|
22
|
-
* Resolution order (from highest to lowest priority):
|
|
22
|
+
* Resolution order (from highest to lowest priority; the first tier that answers wins):
|
|
23
23
|
* 1. Per-operation frontend override (`operation.operationFrontendConfig.navigationOverrides`)
|
|
24
|
-
* 2.
|
|
25
|
-
* 3.
|
|
26
|
-
* 4.
|
|
27
|
-
* 5.
|
|
24
|
+
* 2. Authored action presentation (an operation's explicit presentation)
|
|
25
|
+
* 3. Per-relationship override (`display.inParentNavigation.transition`)
|
|
26
|
+
* 4. Global viewport override (`ViewportBreakpoint.MOBILE` / `ViewportBreakpoint.VERT_TABLET` blocks)
|
|
27
|
+
* 5. Source context `transitions[operation]` — an overlay source with no `fromOverlay` entry falls
|
|
28
|
+
* back to primary's map
|
|
29
|
+
* 6. Derived action presentation (inferred by the framework, used only after authored policy)
|
|
30
|
+
* 7. Framework hardcoded fallback
|
|
28
31
|
*
|
|
29
32
|
* @example
|
|
30
33
|
* const layout: NavigationLayout = {
|
|
@@ -116,8 +119,9 @@ export const NavigationLayoutSchema = z.object({
|
|
|
116
119
|
*/
|
|
117
120
|
appLevel: AppLevelConfigSchema.optional(),
|
|
118
121
|
/**
|
|
119
|
-
* How navigation
|
|
120
|
-
*
|
|
122
|
+
* How navigation that STARTS in an overlay resolves. `PUSH` or `REPLACE` from an overlay leaves it
|
|
123
|
+
* and lands in PRIMARY (the page changes); `OVERLAY` stacks a second overlay on the first. A
|
|
124
|
+
* missing entry falls back to primary's own map. Nothing here keeps a link inside the dialog.
|
|
121
125
|
*/
|
|
122
126
|
fromOverlay: FromOverlayConfigSchema.optional(),
|
|
123
127
|
/** Split geometry: ratios, orientation, resizability. */
|
|
@@ -19,7 +19,7 @@ collapse.
|
|
|
19
19
|
|
|
20
20
|
```typescript
|
|
21
21
|
*
|
|
22
|
-
* Per-operation navigation chrome: transition, overlay
|
|
22
|
+
* Per-operation navigation chrome: transition, overlay appearance, source zone.
|
|
23
23
|
*
|
|
24
24
|
* **How to use:** attach fragments of this shape under
|
|
25
25
|
* `ResourceOperationFrontendConfig.navigationOverrides` in `resourceUIBehavior()`.
|
|
@@ -29,10 +29,12 @@ collapse.
|
|
|
29
29
|
*/
|
|
30
30
|
export const NavigationOperationOverrideSchema = z.object({
|
|
31
31
|
transition: TransitionConfigSchema,
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
32
|
+
/**
|
|
33
|
+
* The overlay chrome this operation wants. Overlay-only since `SplitAppearance` was removed
|
|
34
|
+
* (2026-09-25): a pane's presentation is `SplitConfig` geometry on the layout, not a per-operation
|
|
35
|
+
* choice — see the removal note in `navigation.shared.schemas.ts`.
|
|
36
|
+
*/
|
|
37
|
+
appearance: viewportDiscriminatedSchema(z.enum(OverlayAppearance)).optional(),
|
|
36
38
|
fromZone: z.union([z.enum(NavigationZoneName), z.literal('appLevel')]).optional(),
|
|
37
39
|
viewport: z.enum(ViewportBreakpoint).optional(),
|
|
38
40
|
/**
|
|
@@ -52,3 +54,25 @@ export const NavigationOperationOverrideSchema = z.object({
|
|
|
52
54
|
});
|
|
53
55
|
export type NavigationOperationOverride = z.infer<typeof NavigationOperationOverrideSchema>;
|
|
54
56
|
```
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## A `SPLIT` override needs a pane to open, and nothing else will tell you
|
|
61
|
+
|
|
62
|
+
An override is resolved by the same chain as a layout transition, so a `SPLIT` it produces obeys the
|
|
63
|
+
same rule: **if the layout declares no `secondary` and no `companion`, the split escalates to an
|
|
64
|
+
OVERLAY.** The operation opens as a dialog instead of beside its source, and if it is `ADDRESSABLE`
|
|
65
|
+
the escalation also strips its URL — nobody can link to it.
|
|
66
|
+
|
|
67
|
+
Neither of the framework's static checks sees this. `collectNavigationLayoutDiagnostics` reads the
|
|
68
|
+
LAYOUT, and an override is not in the layout; the verification greps in this skill target
|
|
69
|
+
`navigation.config.ts` for the same reason. It was live in a shipped application for the whole life
|
|
70
|
+
of the declaration.
|
|
71
|
+
|
|
72
|
+
What does report it is the RUNTIME, at the moment it happens: the navigation controller logs a
|
|
73
|
+
warning once per resource+operation when a resolution carries `split-escalated-no-adjacent-zone`, and
|
|
74
|
+
the resolution itself carries that adjustment in `provenance.adjustments`.
|
|
75
|
+
|
|
76
|
+
**So: before writing `transition: SPLIT` on an operation, open the application's navigation layout
|
|
77
|
+
and check that `zones.secondary` exists.** If it does not, either declare it — a split override is
|
|
78
|
+
usually a sign the application wants list-and-detail — or choose the transition you actually want.
|
package/dist/knowledge/skills/config-navigation/references/framework-navigation-vocabulary-api.md
CHANGED
|
@@ -37,14 +37,17 @@ export enum NavigationTransition {
|
|
|
37
37
|
* Content opens in an adjacent zone (secondary or companion).
|
|
38
38
|
* Creates a side-by-side layout. The source zone's content remains visible.
|
|
39
39
|
* Back navigation un-splits (closes the adjacent zone).
|
|
40
|
-
* URL
|
|
40
|
+
* URL: the detail's own address beside a resource primary; beside any other primary the host
|
|
41
|
+
* keeps its URL and a RESOURCE detail rides as `?pane=`. There is no split segment.
|
|
41
42
|
*/
|
|
42
43
|
SPLIT = 'split',
|
|
43
44
|
/**
|
|
44
45
|
* Content opens in a floating layer above the entire layout (dialog, sheet, or drawer).
|
|
45
|
-
* The underlying layout remains visible
|
|
46
|
+
* The underlying layout remains visible; it is non-interactive while the overlay is modal (the
|
|
47
|
+
* default), and stays interactive under `overlayBehavior.modal: false`.
|
|
46
48
|
* Back navigation or Escape dismisses the overlay.
|
|
47
|
-
* URL
|
|
49
|
+
* NOT URL-addressed: opening an overlay leaves the browser URL where it was, so its content cannot
|
|
50
|
+
* be linked to or restored by a reload. Choose it knowing that.
|
|
48
51
|
*/
|
|
49
52
|
OVERLAY = 'overlay',
|
|
50
53
|
/**
|
|
@@ -85,7 +88,8 @@ export enum NavigationTransition {
|
|
|
85
88
|
INPLACE = 'inplace',
|
|
86
89
|
/**
|
|
87
90
|
* Escape the current context and open content at primary scope.
|
|
88
|
-
* Abandons the current context: overlays close, companion/secondary dismiss
|
|
91
|
+
* Abandons the current context: overlays close, companion/secondary dismiss — except a pane
|
|
92
|
+
* placed by a `persistent` split, which survives a reset by design.
|
|
89
93
|
* The promoted content becomes the primary zone's top content.
|
|
90
94
|
*
|
|
91
95
|
* Use case: a link within an overlay should open as a full primary view,
|
|
@@ -130,7 +134,8 @@ export enum NavigationZoneName {
|
|
|
130
134
|
/**
|
|
131
135
|
* Persistent supplementary content. Reference panels, docs, notes, threads.
|
|
132
136
|
* Only exists if declared in config, and starts hidden.
|
|
133
|
-
*
|
|
137
|
+
* Reached by a `split` with `persistent: true`, or by an ordinary `split` when the secondary zone
|
|
138
|
+
* is already occupied.
|
|
134
139
|
* Typical use: Slack thread panel, VS Code terminal, documentation sidebar.
|
|
135
140
|
*/
|
|
136
141
|
COMPANION = 'companion',
|
|
@@ -152,9 +157,10 @@ export enum NavigationZoneContentModel {
|
|
|
152
157
|
*/
|
|
153
158
|
SINGLE = 'single',
|
|
154
159
|
/**
|
|
155
|
-
* Parallel tabs:
|
|
156
|
-
* Tab bar is visible, showing all open tabs. No depth stack within tabs.
|
|
157
|
-
* `replace` replaces the active tab's content
|
|
160
|
+
* Parallel tabs: every navigation landing in the zone opens a new tab and makes it active (no
|
|
161
|
+
* de-duplication). Tab bar is visible, showing all open tabs. No depth stack within tabs.
|
|
162
|
+
* `replace` replaces the active tab's content, and back closes the active tab and shows its
|
|
163
|
+
* neighbour. The model changes RENDERING only — it does not change how navigation resolves.
|
|
158
164
|
* When no tabs remain, `onEmpty` behavior applies.
|
|
159
165
|
*/
|
|
160
166
|
TABBED = 'tabbed',
|
|
@@ -164,8 +170,10 @@ export enum NavigationZoneContentModel {
|
|
|
164
170
|
* Responsive collapse behavior when viewport shrinks below a zone's breakpoint.
|
|
165
171
|
*
|
|
166
172
|
* Only applies to secondary and companion zones. Primary never collapses.
|
|
167
|
-
*
|
|
168
|
-
*
|
|
173
|
+
* It applies to content ALREADY in the zone, not only to new navigations: when the zone collapses its
|
|
174
|
+
* whole history moves (a tabbed zone's tabs too, the one on screen on top), and when the viewport
|
|
175
|
+
* grows back what is still on top of primary migrates home with every field intact. Whatever the
|
|
176
|
+
* reader navigated past at the narrow width stays where it is.
|
|
169
177
|
*/
|
|
170
178
|
export enum ResponsiveCollapseMode {
|
|
171
179
|
/**
|
|
@@ -211,22 +219,27 @@ export enum OverlayAppearance {
|
|
|
211
219
|
DRAWER = 'drawer',
|
|
212
220
|
}
|
|
213
221
|
|
|
214
|
-
|
|
215
|
-
*
|
|
216
|
-
*
|
|
222
|
+
/*
|
|
223
|
+
* ─── `SplitAppearance` was REMOVED on 2026-09-25, and the reason is worth keeping ───────────────
|
|
224
|
+
*
|
|
225
|
+
* It declared `PANEL` ("vertical side panel") and `DRAWER` ("horizontal drawer, bottom panel"), and
|
|
226
|
+
* the whole sub-tree was WRITE-ONLY: the resolver computed it, the controller stored it on the stack
|
|
227
|
+
* entry, and the ONLY site reading `entry.appearance` cast it to `OverlayAppearance` for the overlay
|
|
228
|
+
* container. No split renderer branched on it. So `DRAWER` could never render — an author who wrote
|
|
229
|
+
* it got a vertical side panel with no diagnostic — and `PANEL` was a value meaning "the default".
|
|
230
|
+
*
|
|
231
|
+
* It was also a SECOND vocabulary for an axis `SplitConfig.orientation` already owns:
|
|
232
|
+
* `orientation: HORIZONTAL` is "top-bottom", which is what `DRAWER` described. The two were
|
|
233
|
+
* independently authorable in contradiction, with no refine and nothing honouring either against the
|
|
234
|
+
* other.
|
|
235
|
+
*
|
|
236
|
+
* Collapsed to ONE source — `SplitConfig.orientation`, which the renderer genuinely reads — per
|
|
237
|
+
* "measure what the runtime actually reads, then collapse to one source of truth". `orientation` was
|
|
238
|
+
* additionally made live on the STATIC render branch in the same change; it had been read only by
|
|
239
|
+
* the resizable branch, so `HORIZONTAL` + `resizable: false` silently produced a side panel.
|
|
240
|
+
*
|
|
241
|
+
* `entry.appearance` is now `OverlayAppearance` alone, which removes the unchecked downcast at its
|
|
242
|
+
* one reader. The removal follows the precedent already set here for `defaultVisible`, `autoSplit`
|
|
243
|
+
* and `CompanionSplitConfig.orientation`: a declared-but-unread field is deleted, not deprecated.
|
|
217
244
|
*/
|
|
218
|
-
export enum SplitAppearance {
|
|
219
|
-
/**
|
|
220
|
-
* Standard vertical side panel.
|
|
221
|
-
* Content appears beside the source zone with a resizable divider.
|
|
222
|
-
* Most common for list-detail patterns.
|
|
223
|
-
*/
|
|
224
|
-
PANEL = 'panel',
|
|
225
|
-
/**
|
|
226
|
-
* Horizontal drawer (bottom panel).
|
|
227
|
-
* Content appears below the source zone.
|
|
228
|
-
* Used for companion panels like terminals, output logs, reference docs.
|
|
229
|
-
*/
|
|
230
|
-
DRAWER = 'drawer',
|
|
231
|
-
}
|
|
232
245
|
```
|
|
@@ -56,22 +56,10 @@ export enum ZoneEmptyBehavior {
|
|
|
56
56
|
|
|
57
57
|
```typescript
|
|
58
58
|
*
|
|
59
|
-
* How much of its zone a
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
* settings page stretched across a 2560px monitor is unreadable — and wrong for content whose whole
|
|
64
|
-
* value is the space it occupies. Until this enum existed there was no way to tell the two apart, so
|
|
65
|
-
* a canvas had to hand-roll a viewport fraction (`h-[70vh]`), which sizes against the WINDOW rather
|
|
66
|
-
* than the container and therefore ignores whatever chrome sits above it.
|
|
67
|
-
*
|
|
68
|
-
* Declared per DESTINATION rather than per zone: the same primary zone hosts a list that wants the
|
|
69
|
-
* cap, a detail page that caps itself, and a graph that wants neither.
|
|
70
|
-
*
|
|
71
|
-
* Width and height are separable on purpose. A wide data table wants the cap gone and its natural
|
|
72
|
-
* height; collapsing both into one boolean would merge two meanings, and two independent booleans
|
|
73
|
-
* would make "full height, still capped at 80rem" representable — a combination nothing wants and
|
|
74
|
-
* someone would eventually author by accident.
|
|
59
|
+
* How much of its zone a destination's content occupies is NOT declared here: it is the
|
|
60
|
+
* destination's `ZoneContentGeometry` (a `maxWidth` and a `fillsHeight`), because the same primary
|
|
61
|
+
* zone hosts a list that wants the width cap, a detail that caps itself, and a graph that wants
|
|
62
|
+
* neither. A zone's own declaration follows.
|
|
75
63
|
*/
|
|
76
64
|
|
|
77
65
|
/**
|
|
@@ -91,7 +79,7 @@ export enum ZoneEmptyBehavior {
|
|
|
91
79
|
* |---|---|
|
|
92
80
|
* | `contentModel` | `NavigationContentAreas.tsx` (TABBED detection) + `zone-visible-entry.ts` |
|
|
93
81
|
* | `transitions` | `navigation-policy-resolver.service.ts` |
|
|
94
|
-
* | `appearance` |
|
|
82
|
+
* | `appearance` | the policy resolver (`appearance.overlay` — there is no split appearance) |
|
|
95
83
|
* | `minWidth` / `maxWidth` | `NavigationContentAreas.tsx` drag constraints, both split branches |
|
|
96
84
|
* | `onEmpty` | `zone-empty-behavior.ts` |
|
|
97
85
|
* | `responsiveCollapse` | `navigation-policy-resolver.service.ts` |
|
|
@@ -113,7 +101,7 @@ export const ZoneConfigSchema = z.object({
|
|
|
113
101
|
/** Operation → transition mapping. Defines what happens for each user action in this zone. */
|
|
114
102
|
transitions: ZoneTransitionsSchema,
|
|
115
103
|
|
|
116
|
-
/**
|
|
104
|
+
/** Which shape an OVERLAY opened from this zone takes. Only overlays have an appearance: a pane's shape is `split.orientation`. */
|
|
117
105
|
appearance: ZoneAppearanceSchema.optional(),
|
|
118
106
|
|
|
119
107
|
/**
|
|
@@ -132,6 +120,19 @@ export const ZoneConfigSchema = z.object({
|
|
|
132
120
|
* The floors are pixels, so at a narrow window they may not fit together at all — they then give way
|
|
133
121
|
* to each other in proportion, and the smaller floor a pane opens at is its drag floor. Primary never
|
|
134
122
|
* gives way.
|
|
123
|
+
*
|
|
124
|
+
* ## It is ALSO a COLLAPSE TRIGGER, on every zone — not only a drag bound
|
|
125
|
+
*
|
|
126
|
+
* The paragraph above restricts this to resizing, and that stopped being the whole truth when the
|
|
127
|
+
* content-area fit escalation landed: `resolveCollapseMode` feeds `minWidth` to
|
|
128
|
+
* `contentAreaFitsSplit`, for resizable and non-resizable zones alike. A zone declaring
|
|
129
|
+
* `minWidth: W` needs `W / 0.75` of content width beside primary's 25% floor, and below that the
|
|
130
|
+
* split escalates rather than squeezing both panes under their floors.
|
|
131
|
+
*
|
|
132
|
+
* So a NON-resizable pane with `minWidth: 600` stops splitting on a 1000px content area at full
|
|
133
|
+
* desktop width — correct behaviour, and the opposite of what this field's own contract said until
|
|
134
|
+
* 2026-09-25. Declare it when you mean "this pane is not worth opening narrower than W", and omit
|
|
135
|
+
* it when you only want a drag floor on a layout that is not resizable anyway.
|
|
135
136
|
*/
|
|
136
137
|
minWidth: z.number().positive().optional(),
|
|
137
138
|
|
|
@@ -159,8 +160,9 @@ export const ZoneConfigSchema = z.object({
|
|
|
159
160
|
* Accepts a plain `ResponsiveCollapseMode` (all breakpoints) or viewport-discriminated object.
|
|
160
161
|
* Only meaningful for secondary and companion zones. Primary never collapses.
|
|
161
162
|
*
|
|
162
|
-
*
|
|
163
|
-
*
|
|
163
|
+
* It moves content already in the zone as well as new navigations: the zone's whole history
|
|
164
|
+
* moves when it collapses, and what is still on top of primary goes home when it returns — see
|
|
165
|
+
* `ResponsiveCollapseMode`.
|
|
164
166
|
*
|
|
165
167
|
* @example
|
|
166
168
|
* responsiveCollapse: ResponsiveCollapseMode.PUSH // always push into primary
|