@wildo-ai/framework-knowledge 1.1.9 → 1.1.11
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 +1 -1
- package/dist/claude-marketplace/plugins/wildo/.claude-plugin/plugin.json +1 -1
- package/dist/claude-marketplace/plugins/wildo/references/acceptance.md +11 -0
- package/dist/claude-marketplace/plugins/wildo/references/derived-artifacts.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/references/expert-personas-and-deliberations.md +26 -7
- package/dist/claude-marketplace/plugins/wildo/references/runs-judges-and-questions.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/accept/SKILL.md +4 -2
- package/dist/claude-marketplace/plugins/wildo/skills/why/SKILL.md +9 -3
- 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 +543 -80
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.research-provenance.d.ts +88 -0
- package/dist/esm/framework-knowledge.research-provenance.d.ts.map +1 -0
- package/dist/esm/framework-knowledge.research-provenance.js +140 -0
- package/dist/esm/framework-knowledge.research-provenance.js.map +1 -0
- package/dist/esm/index.d.ts +2 -0
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/index.js +2 -0
- package/dist/esm/index.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +2 -2
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +43 -2
- 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 +138 -21
- 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.js +1 -1
- package/dist/esm/playbooks/bottom_up.build-dispatch/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.js +1 -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 +17 -9
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +22 -11
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.domain-plan/playbook.definition.d.ts +2 -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 +89 -9
- 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 +6 -5
- 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 +6 -4
- package/dist/esm/playbooks/bottom_up.experience-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.d.ts +2 -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 +7 -2
- package/dist/esm/playbooks/bottom_up.integration-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.placement-plan/playbook.definition.d.ts +12 -3
- 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 +8 -4
- 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 +28 -6
- 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 +23 -5
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js +9 -3
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js +14 -2
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts +2 -2
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js +14 -6
- package/dist/esm/playbooks/top_down.brand-identity/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js +5 -3
- package/dist/esm/playbooks/top_down.brand-name-research/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js +11 -9
- package/dist/esm/playbooks/top_down.brand-name-screening-produce/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts +17 -3
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js +19 -2
- package/dist/esm/playbooks/top_down.brand-naming/playbook.definition.js.map +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-conception/playbook.definition.d.ts +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js +2 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.js +9 -3
- 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 +34 -7
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js +39 -13
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.market-snapshot-produce/playbook.definition.d.ts +2 -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 +14 -6
- 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.map +1 -1
- package/dist/esm/playbooks/top_down.phase-gate/playbook.definition.js +38 -3
- 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 +2 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js +23 -8
- package/dist/esm/playbooks/top_down.requirements-definition/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts +95 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.d.ts.map +1 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js +111 -0
- package/dist/esm/playbooks/top_down.service-method/playbook.definition.js.map +1 -0
- 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 +15 -3
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/esm/source-anchor-grammar.d.ts +70 -0
- package/dist/esm/source-anchor-grammar.d.ts.map +1 -0
- package/dist/esm/source-anchor-grammar.js +114 -0
- package/dist/esm/source-anchor-grammar.js.map +1 -0
- 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/method.md +6 -0
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +3 -3
- 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 +497 -32
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +44 -3
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +302 -8
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/method.md +2 -2
- package/dist/knowledge/playbooks/bottom_up.capability-composition/playbook.json +2 -2
- package/dist/knowledge/playbooks/bottom_up.conception/method.md +12 -7
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +11 -3
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.domain-plan/method.md +118 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +8 -3
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +41 -10
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +7 -5
- package/dist/knowledge/playbooks/bottom_up.foundation/method.md +5 -0
- package/dist/knowledge/playbooks/bottom_up.foundation/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.integration-plan/method.md +12 -0
- package/dist/knowledge/playbooks/bottom_up.integration-plan/playbook.json +4 -3
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +79 -1
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +187 -14
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +23 -3
- package/dist/knowledge/playbooks/cross_cutting.refinement/method.md +3 -2
- package/dist/knowledge/playbooks/cross_cutting.refinement/playbook.json +6 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +99 -24
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +38 -3
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +4 -3
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/playbook.json +2 -2
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/method.md +8 -6
- package/dist/knowledge/playbooks/refinement.governance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-identity/method.md +16 -5
- package/dist/knowledge/playbooks/top_down.brand-identity/playbook.json +3 -3
- package/dist/knowledge/playbooks/top_down.brand-name-research/method.md +56 -16
- package/dist/knowledge/playbooks/top_down.brand-name-research/playbook.json +6 -4
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/method.md +30 -9
- package/dist/knowledge/playbooks/top_down.brand-name-screening-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.brand-naming/playbook.json +12 -1
- package/dist/knowledge/playbooks/top_down.business-model/method.md +6 -0
- package/dist/knowledge/playbooks/top_down.business-model/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/method.md +12 -2
- package/dist/knowledge/playbooks/top_down.compliance-conception/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.definition/method.md +7 -2
- package/dist/knowledge/playbooks/top_down.definition/playbook.json +5 -4
- package/dist/knowledge/playbooks/top_down.expert-personas/method.md +10 -3
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +18 -4
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +2 -2
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/method.md +26 -0
- package/dist/knowledge/playbooks/top_down.market-snapshot-produce/playbook.json +5 -3
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.phase-gate/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-protocol.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/evaluation-treatment.json +1 -1
- package/dist/knowledge/playbooks/top_down.requirements-definition/method.md +84 -9
- package/dist/knowledge/playbooks/top_down.requirements-definition/playbook.json +6 -3
- package/dist/knowledge/playbooks/top_down.risk-register/method.md +1 -1
- package/dist/knowledge/playbooks/top_down.risk-register/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.service-method/method.md +198 -0
- package/dist/knowledge/playbooks/top_down.service-method/playbook.json +96 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/method.md +23 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +23 -4
- package/dist/knowledge/references/acp.execution-profile.md +9 -1
- package/dist/knowledge/references/application-maturity.config.md +1 -1
- package/dist/knowledge/references/backend.inbound-channels.attachment-adoption.md +55 -0
- package/dist/knowledge/references/backend.inbound-channels.handler-definition.md +13 -2
- package/dist/knowledge/references/backend.inbound-handlers.agents.md +10 -3
- package/dist/knowledge/references/backend.inbound-handlers.definition.md +426 -5
- package/dist/knowledge/references/backend.inbound-handlers.pipelines.md +62 -0
- package/dist/knowledge/references/blueprint.definition-contract.md +483 -0
- package/dist/knowledge/references/brand.name-choice.config.md +20 -3
- package/dist/knowledge/references/brand.name-screening.config.md +58 -3
- package/dist/knowledge/references/brand.visual-tone.config.md +26 -8
- package/dist/knowledge/references/build-plan.task-graph.config.md +292 -7
- package/dist/knowledge/references/business-model.pricing-plan.config.md +7 -0
- package/dist/knowledge/references/business-model.snapshot.validation.md +18 -0
- package/dist/knowledge/references/capability-composition.config.md +4 -3
- package/dist/knowledge/references/cli.market.generate-command.md +2 -1
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/companion.technical-doc.service.md +166 -32
- package/dist/knowledge/references/engine.client-bundle.allow-list.md +14 -0
- package/dist/knowledge/references/engine.saas-technical-doc.config.md +1 -1
- package/dist/knowledge/references/engine.saas-website.config.md +16 -44
- package/dist/knowledge/references/example.ai-use-declaration.agent.md +37 -0
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- package/dist/knowledge/references/{example.authorization.service-provider-organization-wide-access.md → example.authorization.relationship-organization-wide-access.md} +2 -2
- package/dist/knowledge/references/example.backend.custom-operation.audit-event.md +81 -0
- package/dist/knowledge/references/example.backend.custom-operation.child-line-total.md +259 -0
- package/dist/knowledge/references/example.backend.custom-operation.computed-total.md +153 -0
- package/dist/knowledge/references/example.backend.custom-operation.create-related-resource.md +129 -0
- package/dist/knowledge/references/example.blueprint.definition.internal-tool.md +45 -0
- package/dist/knowledge/references/example.config.app-shell.full.md +6 -3
- package/dist/knowledge/references/example.config.app-shell.hosted-components.md +4 -1
- package/dist/knowledge/references/example.config.backend.inbound-email.md +4 -2
- package/dist/knowledge/references/example.config.backend.required-floors.md +4 -2
- package/dist/knowledge/references/example.config.design-system.full.md +40 -116
- package/dist/knowledge/references/example.data-seeding.minimal.md +10 -9
- package/dist/knowledge/references/example.data-seeding.row-reference.md +80 -0
- package/dist/knowledge/references/example.email.template.minimal.md +1 -1
- package/dist/knowledge/references/example.flows-actors.autonomous-agent.reviewed-write.md +10 -0
- package/dist/knowledge/references/example.flows-actors.chat-assistant.md +70 -14
- package/dist/knowledge/references/example.flows-actors.declared-flow.md +115 -0
- package/dist/knowledge/references/example.flows-actors.llm-agent-one-shot.md +12 -0
- package/dist/knowledge/references/example.inbound.email-channel-handler.md +10 -1
- package/dist/knowledge/references/example.infra.environment-config.local.md +24 -0
- package/dist/knowledge/references/example.layout-2d.registration.md +11 -0
- package/dist/knowledge/references/example.minion.contained-tick.md +1 -1
- package/dist/knowledge/references/example.module.relationships.scope-membership-junction.md +8 -10
- package/dist/knowledge/references/example.organizations.relationship-kinds.md +26 -0
- package/dist/knowledge/references/example.professional-qualifications.declaration.md +10 -0
- package/dist/knowledge/references/example.professional-qualifications.gate.md +25 -0
- package/dist/knowledge/references/example.provider.backend-module-shape.md +10 -0
- package/dist/knowledge/references/example.provider.frontend-facet.on-demand-sdk.md +41 -0
- package/dist/knowledge/references/example.provider.frontend-file-picker.contribution.md +4 -5
- package/dist/knowledge/references/example.rate-limit.resource-operation-surface.md +7 -5
- package/dist/knowledge/references/example.resource.add-resource.module-factory-map.md +0 -1
- package/dist/knowledge/references/example.resource.config-wiring.retention-policy-operations.md +74 -0
- package/dist/knowledge/references/example.resource.personal-data.free-text-field.md +19 -0
- package/dist/knowledge/references/example.resource.personal-data.person-without-account.md +27 -0
- package/dist/knowledge/references/example.resource.status-lifecycle.quote.md +152 -0
- package/dist/knowledge/references/example.resource.ui-behavior.enum-badge.md +23 -7
- package/dist/knowledge/references/example.resource.ui-behavior.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +60 -22
- package/dist/knowledge/references/example.resource.ui-behavior.record-template.md +81 -0
- package/dist/knowledge/references/example.resource.ui-behavior.surface-decision.md +19 -20
- package/dist/knowledge/references/example.spec.composite-view.workspace.md +10 -2
- package/dist/knowledge/references/example.views.app-level.home-definition.md +13 -0
- package/dist/knowledge/references/example.views.chart-definition.shared.md +83 -0
- package/dist/knowledge/references/example.views.composite-view.workspace.md +10 -3
- package/dist/knowledge/references/example.website.blocks.section.md +20 -0
- package/dist/knowledge/references/example.website.blocks.site-choices.md +78 -0
- package/dist/knowledge/references/example.website.blocks.site-configs.md +155 -0
- package/dist/knowledge/references/example.website.demo.append.md +57 -0
- package/dist/knowledge/references/example.website.demo.approval.md +47 -0
- package/dist/knowledge/references/example.website.demo.celebrate.md +39 -0
- package/dist/knowledge/references/example.website.demo.complete-items.md +103 -0
- package/dist/knowledge/references/example.website.demo.connect.md +45 -0
- package/dist/knowledge/references/example.website.demo.dashboard.md +74 -0
- package/dist/knowledge/references/example.website.demo.query-answer.md +77 -0
- package/dist/knowledge/references/example.website.demo.status-lifecycle.md +71 -0
- package/dist/knowledge/references/example.website.demo.transform.md +43 -0
- package/dist/knowledge/references/example.website.page.manifest.md +2 -6
- package/dist/knowledge/references/example.website.section.bento.md +27 -0
- package/dist/knowledge/references/example.website.section.contact-form.md +15 -0
- package/dist/knowledge/references/example.website.section.factories.md +82 -0
- package/dist/knowledge/references/example.website.section.faq.md +17 -0
- package/dist/knowledge/references/example.website.section.footer-cta.md +13 -0
- package/dist/knowledge/references/example.website.section.hero.md +16 -0
- package/dist/knowledge/references/example.website.section.latest-posts.md +15 -0
- package/dist/knowledge/references/example.website.section.marquee.md +26 -0
- package/dist/knowledge/references/example.website.section.roadmap.md +25 -0
- package/dist/knowledge/references/example.website.section.site-block.md +43 -0
- package/dist/knowledge/references/example.website.section.solution-paths.md +17 -0
- package/dist/knowledge/references/example.website.section.stats.md +23 -0
- package/dist/knowledge/references/example.website.section.steps.md +15 -0
- package/dist/knowledge/references/example.website.showcase.tour.md +49 -0
- package/dist/knowledge/references/example.website.theme.composed.md +69 -0
- package/dist/knowledge/references/experience-plan.config.md +76 -7
- package/dist/knowledge/references/external-connectors.frontend-provider-consent-classification.md +6 -0
- package/dist/knowledge/references/external-connectors.frontend-provider-sdk-activation-mode.md +27 -0
- package/dist/knowledge/references/external-connectors.models.connection-target.md +99 -0
- package/dist/knowledge/references/external-connectors.models.file-storage-adapter.md +6 -0
- package/dist/knowledge/references/external-connectors.models.hook-inbound-endpoint.md +352 -0
- package/dist/knowledge/references/external-connectors.models.hook-signature-algorithms.md +64 -0
- package/dist/knowledge/references/external-connectors.models.hook-trigger-strategy.md +97 -0
- package/dist/knowledge/references/external-connectors.models.oauth2-audiences.md +61 -2
- package/dist/knowledge/references/external-connectors.models.oauth2-incremental-consent.md +70 -0
- package/dist/knowledge/references/external-connectors.models.rest-operation-contract.md +253 -0
- package/dist/knowledge/references/external-connectors.models.subject-erasure-effect.md +105 -0
- package/dist/knowledge/references/integration-plan.config.md +21 -1
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/market.references.weighted-edges.md +14 -1
- package/dist/knowledge/references/minions.tick-contract.md +2 -2
- package/dist/knowledge/references/placement-plan.config.md +107 -2
- package/dist/knowledge/references/platform.config.environment.deployment.md +9 -1
- package/dist/knowledge/references/platform.config.infrastructure-host.md +2 -0
- package/dist/knowledge/references/platform.config.platform-key-management.md +206 -0
- package/dist/knowledge/references/platform.config.saas.md +106 -14
- package/dist/knowledge/references/platform.key-management.vault-custody.md +78 -0
- package/dist/knowledge/references/presets.3d.layout-contract.md +4 -30
- package/dist/knowledge/references/presets.3d.register-layout.md +14 -36
- package/dist/knowledge/references/presets.layouts-2d.authoring.md +157 -0
- package/dist/knowledge/references/presets.layouts-2d.register-layout.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.settings.md +53 -0
- package/dist/knowledge/references/presets.layouts-2d.vocabulary.md +41 -0
- package/dist/knowledge/references/presets.models.palette-contrast.md +183 -0
- package/dist/knowledge/references/presets.models.palette-derivation.md +93 -0
- package/dist/knowledge/references/presets.models.surface-policy.defaults.md +27 -0
- package/dist/knowledge/references/presets.models.surface-variant.md +10 -0
- package/dist/knowledge/references/presets.models.theme-contract.md +136 -0
- package/dist/knowledge/references/presets.models.theme-personality-lexicon.md +81 -0
- package/dist/knowledge/references/presets.models.theme-personality.md +159 -0
- package/dist/knowledge/references/presets.themes.compose-theme.md +46 -0
- package/dist/knowledge/references/requirements.functional-requirement.config.md +8 -2
- package/dist/knowledge/references/requirements.non-functional-requirement.config.md +2 -0
- package/dist/knowledge/references/requirements.references.conventions.md +1 -1
- package/dist/knowledge/references/requirements.snapshot.config.md +57 -1
- package/dist/knowledge/references/requirements.snapshot.validation.md +35 -1
- package/dist/knowledge/references/roadmap.phase.config.md +2 -16
- package/dist/knowledge/references/saas.approval-seals.admin-endpoints.md +131 -0
- package/dist/knowledge/references/saas.backend.a2a.token-budget.md +77 -11
- package/dist/knowledge/references/saas.backend.actor-execution-continuation.md +158 -0
- package/dist/knowledge/references/saas.backend.application-initialization.assembly.md +3 -1
- package/dist/knowledge/references/saas.backend.audit-logs.log-event.md +63 -0
- package/dist/knowledge/references/saas.backend.crypto-keys.application-keys.md +100 -0
- package/dist/knowledge/references/saas.backend.custom-operation.commit-outcome-read-back.md +208 -0
- package/dist/knowledge/references/saas.backend.custom-operation.target-authority.md +33 -0
- package/dist/knowledge/references/saas.backend.custom-operation.transactional-core.md +131 -1
- package/dist/knowledge/references/saas.backend.document-sequence.issue-in-operation.md +60 -0
- package/dist/knowledge/references/saas.backend.document-sequence.raise-floor.md +156 -0
- package/dist/knowledge/references/saas.backend.domain-module.md +76 -1
- package/dist/knowledge/references/saas.backend.email-template.definition.md +34 -0
- package/dist/knowledge/references/saas.backend.email-template.words.md +98 -0
- package/dist/knowledge/references/saas.backend.email.send.md +84 -0
- package/dist/knowledge/references/saas.backend.flows-actors.a2a-task-surface.md +9 -1
- package/dist/knowledge/references/saas.backend.flows-actors.ask-person-tool.md +79 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-case-selector.md +71 -0
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-declaration.md +21 -10
- package/dist/knowledge/references/saas.backend.flows-actors.autonomous-agent-schedule.md +11 -5
- package/dist/knowledge/references/saas.backend.flows-actors.chat-agent-declaration.md +51 -0
- package/dist/knowledge/references/saas.backend.flows-actors.chat-reply-handler.md +207 -0
- package/dist/knowledge/references/saas.backend.flows-actors.decision-notice-handler.md +239 -0
- package/dist/knowledge/references/saas.backend.flows-actors.function-tool.md +300 -3
- package/dist/knowledge/references/saas.backend.flows-actors.invoke-agent.md +13 -2
- package/dist/knowledge/references/saas.backend.flows-actors.operation-approval-resolvers.md +50 -0
- package/dist/knowledge/references/saas.backend.flows-actors.present-records-tool.md +106 -0
- package/dist/knowledge/references/saas.backend.flows-actors.resource-read-tool.md +14 -1
- package/dist/knowledge/references/saas.backend.flows-actors.retrieval-tool.md +205 -0
- package/dist/knowledge/references/saas.backend.flows-actors.tool-dispatch-obligations.md +21 -5
- package/dist/knowledge/references/saas.backend.flows.start-flow-method.md +27 -0
- package/dist/knowledge/references/saas.backend.flows.start-flow.md +47 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- package/dist/knowledge/references/saas.backend.pdf-template.collection-definition.md +5 -3
- package/dist/knowledge/references/saas.backend.providers.optional-runtime-peers.md +15 -25
- package/dist/knowledge/references/saas.backend.rate-limit-service.check-policy.md +3 -2
- package/dist/knowledge/references/saas.backend.submission-challenge.md +4 -0
- package/dist/knowledge/references/saas.backend.system-access-service.md +242 -107
- package/dist/knowledge/references/saas.config.content-security-policy.md +1 -2
- package/dist/knowledge/references/saas.data-seeding.computed-entry.md +43 -0
- package/dist/knowledge/references/saas.data-seeding.definition-input.md +8 -2
- package/dist/knowledge/references/saas.data-seeding.row-reference.md +93 -0
- package/dist/knowledge/references/saas.data-seeding.run-ledger.md +3 -0
- package/dist/knowledge/references/saas.external-data.admin-endpoints.md +70 -3
- package/dist/knowledge/references/saas.external-providers.llm.model-configuration.md +3 -0
- package/dist/knowledge/references/saas.frontend.app-level-component.configuration.md +10 -2
- package/dist/knowledge/references/saas.frontend.app-level-component.vocabulary.md +10 -16
- package/dist/knowledge/references/saas.frontend.app-shell.building-blocks.md +7 -3
- package/dist/knowledge/references/saas.frontend.app-shell.register-shell-layout.md +97 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-layout-contract.md +60 -0
- package/dist/knowledge/references/saas.frontend.app-shell.shell-motion-contract.md +274 -0
- package/dist/knowledge/references/saas.frontend.app-shell.use-shell-motion.md +73 -0
- package/dist/knowledge/references/saas.frontend.brand-identity.md +6 -0
- package/dist/knowledge/references/saas.frontend.chart-view.inserted-declaration.md +13 -0
- package/dist/knowledge/references/saas.frontend.chat-sign-in-completion.md +99 -0
- package/dist/knowledge/references/saas.frontend.collection-filter-presets.md +126 -0
- package/dist/knowledge/references/saas.frontend.display-layout.reading-measure.md +9 -3
- package/dist/knowledge/references/saas.frontend.domain-module.md +5 -0
- package/dist/knowledge/references/saas.frontend.embedded-resource-descent.md +2 -1
- package/dist/knowledge/references/saas.frontend.execution-view.definition.md +17 -3
- package/dist/knowledge/references/saas.frontend.field-tiles.md +76 -0
- package/dist/knowledge/references/saas.frontend.flows-actors-view.md +10 -2
- package/dist/knowledge/references/saas.frontend.focus-indicator.md +119 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +324 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +109 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +61 -0
- package/dist/knowledge/references/saas.frontend.operation-key-and-resource-config-like.md +68 -1
- package/dist/knowledge/references/saas.frontend.providers.execute-operation.md +14 -24
- package/dist/knowledge/references/saas.frontend.related-resource-embeds.md +149 -0
- package/dist/knowledge/references/saas.frontend.resource-header-title.md +98 -34
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +54 -0
- package/dist/knowledge/references/saas.frontend.resource-layout-templates.md +17 -11
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +125 -58
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +13 -7
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destinations.md +141 -32
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +64 -2
- package/dist/knowledge/references/saas.models.agent-suspension.md +75 -0
- package/dist/knowledge/references/saas.models.agent-work-capture-settings.md +2 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-contents-read.md +69 -0
- package/dist/knowledge/references/saas.models.agent-work-decision-surface.md +11 -2
- package/dist/knowledge/references/saas.models.agent-work-decision-vocabulary.md +20 -3
- package/dist/knowledge/references/saas.models.agent-work-output-review.md +3 -3
- package/dist/knowledge/references/saas.models.agent-work-override-rate.md +6 -5
- package/dist/knowledge/references/saas.models.agent-work-review-config.md +22 -4
- package/dist/knowledge/references/saas.models.analytics.value-moments.md +22 -0
- package/dist/knowledge/references/saas.models.application-agent-policy.md +28 -0
- package/dist/knowledge/references/saas.models.application-entry-points.md +45 -0
- package/dist/knowledge/references/saas.models.audit.trail-config.md +63 -5
- package/dist/knowledge/references/{saas.models.auth.service-provider-client-authentication.md → saas.models.auth.relationship-grantor-authentication.md} +54 -48
- package/dist/knowledge/references/saas.models.authorization.administrative-continuity-codes.md +4 -4
- package/dist/knowledge/references/saas.models.chat-identity-link-host.md +38 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-classification.md +179 -0
- package/dist/knowledge/references/saas.models.compliance.ai-use-posture.md +121 -0
- package/dist/knowledge/references/saas.models.config.organization-types.md +42 -82
- package/dist/knowledge/references/saas.models.conversation-threads.md +4 -3
- package/dist/knowledge/references/saas.models.crypto-keys.floors.md +22 -0
- package/dist/knowledge/references/saas.models.crypto-keys.key-management-config.md +130 -0
- package/dist/knowledge/references/saas.models.crypto-keys.local-provider.md +27 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purpose-descriptor.md +403 -0
- package/dist/knowledge/references/saas.models.crypto-keys.purposes.md +84 -0
- package/dist/knowledge/references/saas.models.data-mode-read-list.md +24 -1
- package/dist/knowledge/references/saas.models.engine-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.evaluation-dataset-export.md +16 -9
- package/dist/knowledge/references/saas.models.evaluation-export-authorization.md +23 -6
- package/dist/knowledge/references/saas.models.external-data-conflict-vocabulary.md +53 -0
- package/dist/knowledge/references/saas.models.external-data-pipeline.md +81 -18
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report-config.md +28 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-behavior-report.md +317 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-content-guardrails.md +150 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-definition.md +45 -0
- package/dist/knowledge/references/saas.models.flows-actors.agent-operation-record.md +147 -0
- package/dist/knowledge/references/saas.models.flows-actors.autonomous-agents-vocabulary.md +49 -7
- package/dist/knowledge/references/saas.models.flows-actors.chat-agents-vocabulary.md +26 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-card-wording.md +284 -0
- package/dist/knowledge/references/saas.models.flows-actors.decision-notice-recorded-cards.md +93 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-decision-decider.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.human-input-form.md +314 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-pending.md +55 -0
- package/dist/knowledge/references/saas.models.flows-actors.operation-approval-requirement.md +62 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadline-vocabulary.md +6 -0
- package/dist/knowledge/references/saas.models.flows-actors.review-deadlines-declaration.md +1 -0
- package/dist/knowledge/references/saas.models.flows.run-state.md +49 -0
- package/dist/knowledge/references/saas.models.flows.runnable-model.md +255 -0
- package/dist/knowledge/references/saas.models.frontend-on-demand-capability-contract.md +54 -0
- package/dist/knowledge/references/saas.models.http-api-binding.md +157 -42
- package/dist/knowledge/references/saas.models.http-api-binding.rest-write-operations.md +3 -3
- package/dist/knowledge/references/saas.models.http-api-population-filter.md +51 -0
- package/dist/knowledge/references/saas.models.inbound-channels.md +4 -1
- package/dist/knowledge/references/saas.models.inbound-email-domains.md +5 -5
- package/dist/knowledge/references/saas.models.inbound-email.md +2 -2
- package/dist/knowledge/references/saas.models.m2m-webhook-events.md +73 -0
- package/dist/knowledge/references/saas.models.model-cost-summary.md +56 -20
- package/dist/knowledge/references/saas.models.notifications.targets.md +25 -2
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +63 -9
- package/dist/knowledge/references/saas.models.on-demand-provider-capabilities.md +28 -0
- package/dist/knowledge/references/saas.models.organization-agent-policy.md +43 -0
- package/dist/knowledge/references/saas.models.organization-assigned-rows-declaration.md +73 -0
- package/dist/knowledge/references/saas.models.organization-own-rows-declaration.md +48 -0
- package/dist/knowledge/references/saas.models.organization-unit-narrowing-containment.md +6 -6
- package/dist/knowledge/references/saas.models.organizations.application-owner-codes.md +9 -10
- package/dist/knowledge/references/saas.models.organizations.organization-relationships.md +911 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualification-kinds.md +46 -0
- package/dist/knowledge/references/saas.models.organizations.professional-qualifications.md +168 -0
- package/dist/knowledge/references/{saas.models.organizations.service-provider-capability-grants.md → saas.models.organizations.relationship-capability-grants.md} +56 -35
- package/dist/knowledge/references/saas.models.organizations.relationship-grantor-controls.md +62 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-invitations.md +224 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-kinds.md +277 -0
- package/dist/knowledge/references/saas.models.organizations.relationship-record-separation.md +113 -0
- package/dist/knowledge/references/saas.models.privacy.legal-holds.md +68 -5
- package/dist/knowledge/references/saas.models.privacy.provider-capability-disclosure.md +67 -2
- package/dist/knowledge/references/saas.models.privacy.redaction-treatments.md +13 -14
- package/dist/knowledge/references/saas.models.privacy.subject-data-recipients.md +278 -40
- package/dist/knowledge/references/saas.models.provider-capabilities.md +33 -0
- package/dist/knowledge/references/saas.models.provider-usage-pricing-authority.md +50 -1
- package/dist/knowledge/references/saas.models.providers.capability-activation-policy.md +28 -0
- package/dist/knowledge/references/saas.models.providers.capability-resolution-mode.md +8 -0
- package/dist/knowledge/references/saas.models.providers.compliance-choice.md +37 -0
- package/dist/knowledge/references/saas.models.providers.execute-operation-request.md +25 -0
- package/dist/knowledge/references/saas.models.providers.scope-reauthorization.md +1 -1
- package/dist/knowledge/references/saas.models.queue.scheduled-recovery.md +13 -1
- package/dist/knowledge/references/saas.models.rate-limit-configuration.md +4 -4
- package/dist/knowledge/references/saas.models.representative-activity.md +65 -0
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +84 -2
- package/dist/knowledge/references/saas.models.resource-config.metered-usage-recording.md +24 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-api-call.md +57 -11
- package/dist/knowledge/references/saas.models.resource-config.operation-base.md +20 -3
- package/dist/knowledge/references/saas.models.resource-config.operation-bulk.md +37 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-chat-command.md +39 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-mcp-exposure.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-required-qualifications.md +30 -0
- package/dist/knowledge/references/saas.models.resource-config.operation-scope-admissions.md +99 -2
- package/dist/knowledge/references/saas.models.resource-config.operation-submission-challenge.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-union.md +0 -1
- package/dist/knowledge/references/saas.models.resource-config.operation-variant-client-timeout.md +1 -1
- package/dist/knowledge/references/saas.models.resource-config.record-label-fields.md +23 -0
- package/dist/knowledge/references/saas.models.resource-config.request-field-offers.md +104 -0
- package/dist/knowledge/references/saas.models.resource-config.required-features.md +20 -0
- package/dist/knowledge/references/saas.models.resource-config.resource-configuration.md +9 -0
- package/dist/knowledge/references/saas.models.resource-config.resources-registry.md +25 -3
- package/dist/knowledge/references/saas.models.resource-config.retention-policy.md +25 -0
- package/dist/knowledge/references/saas.models.resource-config.system-managed-fields.md +2 -1
- package/dist/knowledge/references/saas.models.resource-config.token-generation.md +1 -1
- package/dist/knowledge/references/saas.models.resource-operation-variant-runtime.md +3 -2
- package/dist/knowledge/references/saas.models.resource-relationship-builder-parameters.md +6 -2
- package/dist/knowledge/references/saas.models.roadmap.phase-horizon.md +31 -0
- package/dist/knowledge/references/saas.models.roles.definition.md +61 -0
- package/dist/knowledge/references/saas.models.roles.organization-defaults.md +97 -0
- package/dist/knowledge/references/saas.models.schema-family-builder.md +17 -4
- package/dist/knowledge/references/saas.models.scope-membership.md +2 -2
- package/dist/knowledge/references/saas.models.system-of-record-capabilities.md +121 -0
- package/dist/knowledge/references/saas.models.system-of-record-error-codes.md +3 -2
- package/dist/knowledge/references/saas.models.systems-of-record.md +36 -1
- package/dist/knowledge/references/saas.models.work-attribution-vocabulary.md +7 -3
- package/dist/knowledge/references/saas.models.work-unit-ref.md +17 -2
- package/dist/knowledge/references/saas.public-runtime.contract.md +60 -2
- package/dist/knowledge/references/saas.specifications.assurance-control-markers.md +3 -2
- package/dist/knowledge/references/saas.specifications.assurance-document-blueprint.contract.md +13 -0
- package/dist/knowledge/references/saas.specifications.assurance-program.contract.md +275 -13
- package/dist/knowledge/references/saas.specifications.catalogs.schema-org.catalog-spec-shared.md +5 -4
- package/dist/knowledge/references/saas.specifications.companion-exports.contract.md +9 -0
- package/dist/knowledge/references/saas.specifications.governed-document-release.contract.md +16 -2
- package/dist/knowledge/references/saas.specifications.processor-register.md +10 -1
- package/dist/knowledge/references/saas.specifications.recipient-disclosures.md +111 -2
- package/dist/knowledge/references/saas.specifications.recipient-population.md +46 -0
- package/dist/knowledge/references/saas.specifications.resource-frontend-configuration-aspect.md +7 -0
- package/dist/knowledge/references/saas.specifications.resource-operation-spec.md +24 -2
- package/dist/knowledge/references/saas.specifications.resource-spec-config.md +21 -7
- package/dist/knowledge/references/saas.specifications.resource-spec-factory.md +19 -5
- package/dist/knowledge/references/saas.specifications.subject-data-recipients.md +136 -6
- package/dist/knowledge/references/saas.website.astro.bridge.md +61 -14
- package/dist/knowledge/references/saas.website.astro.head-renderer.md +63 -27
- package/dist/knowledge/references/saas.website.astro.i18n-helper.md +39 -10
- package/dist/knowledge/references/saas.website.astro.label-key-collector.md +12 -11
- package/dist/knowledge/references/saas.website.astro.label-loader.md +41 -9
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.pick-labels-for-page.md +1 -2
- package/dist/knowledge/references/saas.website.astro.runtime-helper.md +48 -17
- package/dist/knowledge/references/saas.website.astro.site-context.md +30 -8
- package/dist/knowledge/references/saas.website.astro.structured-data-renderer.md +29 -8
- package/dist/knowledge/references/saas.website.blocks.actions.md +91 -0
- package/dist/knowledge/references/saas.website.blocks.band.md +41 -0
- package/dist/knowledge/references/saas.website.blocks.bento.md +70 -0
- package/dist/knowledge/references/saas.website.blocks.card-grid.md +115 -0
- package/dist/knowledge/references/saas.website.blocks.card.md +77 -0
- package/dist/knowledge/references/saas.website.blocks.cta-band.md +94 -0
- package/dist/knowledge/references/saas.website.blocks.define-block.md +123 -0
- package/dist/knowledge/references/saas.website.blocks.definitions.md +132 -0
- package/dist/knowledge/references/saas.website.blocks.faq.md +89 -0
- package/dist/knowledge/references/saas.website.blocks.feature-row.md +109 -0
- package/dist/knowledge/references/saas.website.blocks.hero.md +140 -0
- package/dist/knowledge/references/saas.website.blocks.intro.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.latest-posts.md +104 -0
- package/dist/knowledge/references/saas.website.blocks.marquee.md +76 -0
- package/dist/knowledge/references/saas.website.blocks.pricing.md +395 -0
- package/dist/knowledge/references/saas.website.blocks.product-tour.md +158 -0
- package/dist/knowledge/references/saas.website.blocks.quote-cards.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.roadmap.md +108 -0
- package/dist/knowledge/references/saas.website.blocks.section-slots.md +64 -0
- package/dist/knowledge/references/saas.website.blocks.solution-paths.md +71 -0
- package/dist/knowledge/references/saas.website.blocks.stats.md +183 -0
- package/dist/knowledge/references/saas.website.blocks.steps.md +69 -0
- package/dist/knowledge/references/saas.website.blocks.stylesheet.md +68 -0
- package/dist/knowledge/references/saas.website.blocks.tables.md +153 -0
- package/dist/knowledge/references/saas.website.blocks.vocabulary.md +227 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +102 -53
- package/dist/knowledge/references/saas.website.blog.collection-config.md +76 -24
- package/dist/knowledge/references/saas.website.blog.cover-resolver.md +93 -0
- package/dist/knowledge/references/saas.website.blog.frontmatter.md +104 -7
- package/dist/knowledge/references/saas.website.blog.head-renderer.md +37 -19
- package/dist/knowledge/references/saas.website.blog.index-builder.md +63 -0
- package/dist/knowledge/references/saas.website.blog.index.md +43 -0
- package/dist/knowledge/references/saas.website.blog.post-cover.md +38 -0
- package/dist/knowledge/references/saas.website.blog.post-renderer.md +113 -85
- package/dist/knowledge/references/saas.website.blog.react-mdx-integration.md +181 -0
- package/dist/knowledge/references/saas.website.blog.react-mdx-query.md +26 -0
- package/dist/knowledge/references/saas.website.blog.vocabulary-labels.md +113 -0
- package/dist/knowledge/references/saas.website.config.pricing-catalog-loader.md +2 -1
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +24 -1
- package/dist/knowledge/references/saas.website.consent.banner.md +1 -1
- package/dist/knowledge/references/saas.website.consent.context.md +1 -1
- package/dist/knowledge/references/saas.website.design-tokens.bundle.md +28 -6
- package/dist/knowledge/references/saas.website.design-tokens.colors.md +7 -6
- package/dist/knowledge/references/saas.website.design-tokens.compose-function.md +35 -0
- package/dist/knowledge/references/saas.website.design-tokens.compose.md +76 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-derivation.md +22 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality-lexicon.md +31 -0
- package/dist/knowledge/references/saas.website.design-tokens.personality.md +82 -0
- package/dist/knowledge/references/saas.website.design-tokens.product.md +122 -0
- package/dist/knowledge/references/saas.website.design-tokens.radius.md +12 -1
- package/dist/knowledge/references/saas.website.design-tokens.readers.md +58 -0
- package/dist/knowledge/references/saas.website.design-tokens.spacing.md +61 -0
- package/dist/knowledge/references/saas.website.design-tokens.surface-depth.md +60 -0
- package/dist/knowledge/references/saas.website.design-tokens.tones.md +75 -0
- package/dist/knowledge/references/saas.website.design-tokens.typography.md +115 -0
- package/dist/knowledge/references/saas.website.factories.define-page-manifest.md +23 -21
- package/dist/knowledge/references/saas.website.factories.define-section.md +36 -38
- package/dist/knowledge/references/saas.website.format.publication-date.md +26 -0
- package/dist/knowledge/references/saas.website.label-keys.compose-helper.md +1 -1
- package/dist/knowledge/references/saas.website.label-keys.format.md +2 -2
- package/dist/knowledge/references/saas.website.label-pack.validator.md +7 -8
- package/dist/knowledge/references/saas.website.labels.section-labels.md +34 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +91 -0
- package/dist/knowledge/references/saas.website.locale-switcher.label-keys.md +35 -0
- package/dist/knowledge/references/saas.website.menu.icons.md +123 -0
- package/dist/knowledge/references/saas.website.menu.label-keys.md +112 -0
- package/dist/knowledge/references/saas.website.menu.schema.md +92 -0
- package/dist/knowledge/references/saas.website.menu.vocabulary.md +79 -0
- package/dist/knowledge/references/saas.website.motion.demo-player.md +105 -0
- package/dist/knowledge/references/saas.website.motion.demo-scenario.md +460 -0
- package/dist/knowledge/references/saas.website.motion.demo.md +324 -0
- package/dist/knowledge/references/saas.website.motion.element-attributes.md +115 -0
- package/dist/knowledge/references/saas.website.motion.reveal-renditions.md +67 -0
- package/dist/knowledge/references/saas.website.motion.stylesheet.md +82 -0
- package/dist/knowledge/references/saas.website.motion.tempo-table.md +99 -0
- package/dist/knowledge/references/saas.website.motion.tokens.md +46 -0
- package/dist/knowledge/references/saas.website.motion.vocabulary.md +85 -0
- package/dist/knowledge/references/saas.website.page-layout.component.md +34 -8
- package/dist/knowledge/references/saas.website.page-manifest.meta-label-keys.md +4 -4
- package/dist/knowledge/references/saas.website.page-manifest.route-path.md +1 -1
- package/dist/knowledge/references/saas.website.page-manifest.schema.md +25 -29
- package/dist/knowledge/references/saas.website.page-manifest.seo.md +1 -1
- package/dist/knowledge/references/saas.website.page-navigation.md +44 -0
- package/dist/knowledge/references/saas.website.page.context.md +9 -2
- package/dist/knowledge/references/saas.website.primitives.button.md +6 -6
- package/dist/knowledge/references/saas.website.primitives.heading.md +17 -18
- package/dist/knowledge/references/saas.website.primitives.image.md +18 -15
- package/dist/knowledge/references/saas.website.primitives.internal-button.md +11 -12
- package/dist/knowledge/references/saas.website.primitives.internal-link.md +11 -35
- package/dist/knowledge/references/saas.website.primitives.link.md +22 -11
- package/dist/knowledge/references/saas.website.primitives.text.md +10 -8
- package/dist/knowledge/references/saas.website.product.atoms.md +366 -0
- package/dist/knowledge/references/saas.website.product.figures.md +320 -0
- package/dist/knowledge/references/saas.website.product.hooks.md +278 -0
- package/dist/knowledge/references/saas.website.product.panels.md +324 -0
- package/dist/knowledge/references/saas.website.product.stylesheet.md +1086 -0
- package/dist/knowledge/references/saas.website.refs.section.md +2 -2
- package/dist/knowledge/references/saas.website.root-config.schema.md +34 -17
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.routing.link-target.md +70 -0
- package/dist/knowledge/references/saas.website.routing.localized-path.md +15 -8
- package/dist/knowledge/references/saas.website.runtime.context.md +51 -17
- package/dist/knowledge/references/saas.website.section.component.md +21 -19
- package/dist/knowledge/references/saas.website.sections.category-enum.md +21 -2
- package/dist/knowledge/references/saas.website.sections.definition-schema.md +47 -39
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/saas.website.site-footer.menu.md +47 -0
- package/dist/knowledge/references/saas.website.site-header.component.md +100 -0
- package/dist/knowledge/references/saas.website.site-header.scroll-behavior.md +26 -0
- package/dist/knowledge/references/saas.website.stacking.md +86 -0
- package/dist/knowledge/references/saas.website.structured-data.payload-shape.md +162 -0
- package/dist/knowledge/references/saas.website.use-blog-index.hook.md +27 -0
- package/dist/knowledge/references/saas.website.use-label.hook.md +6 -4
- package/dist/knowledge/references/service-method.config.md +270 -0
- package/dist/knowledge/references/website-plan.config.md +561 -23
- package/dist/knowledge/references/website-plan.menu-placement.md +118 -0
- package/dist/knowledge/references/website-plan.page-kind-essentials.md +42 -0
- package/dist/knowledge/references/website-plan.page-routes.md +39 -0
- package/dist/knowledge/references/workers.node.worker-init-contract.md +4 -2
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +86 -9
- package/dist/knowledge/references/zod.decorators.chrome-modes.md +92 -0
- package/dist/knowledge/references/zod.decorators.data-categories.md +101 -11
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +82 -6
- package/dist/knowledge/references/zod.decorators.display-edit-modes.md +23 -1
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.enums.frontend-handling.md +41 -7
- package/dist/knowledge/references/zod.decorators.file-schema.md +6 -5
- package/dist/knowledge/references/zod.decorators.per-primitive-ui.md +25 -9
- package/dist/knowledge/references/zod.decorators.primitive-ui.md +15 -3
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +5 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +50 -1
- package/dist/knowledge/references/zod.decorators.shared-structural-params.md +44 -5
- package/dist/knowledge/references/zod.decorators.structural-lifecycle-params.md +130 -9
- package/dist/knowledge/references/zod.factories.bigdecimal.md +17 -7
- package/dist/knowledge/references/zod.factories.code.md +18 -8
- package/dist/knowledge/references/zod.factories.duration.md +23 -13
- package/dist/knowledge/references/zod.factories.money.md +24 -14
- package/dist/knowledge/references/zod.factories.phone.md +23 -14
- package/dist/knowledge/references/zod.factories.range.md +5 -1
- package/dist/knowledge/registries/assurance-authority-bases.json +3 -3
- package/dist/knowledge/registries/framework-topics.json +2854 -246
- package/dist/knowledge/registries/playbooks.json +57 -36
- package/dist/knowledge/registries/source-tags.json +8863 -4569
- package/dist/knowledge/rules/database-migration-obligation.md +11 -5
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +63 -34
- package/dist/knowledge/skills/agent-work-review/SKILL.md +86 -23
- package/dist/knowledge/skills/agent-work-review/references/framework-actor-execution-continuation-api.md +203 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-capture-settings-api.md +2 -2
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-decision-contents-api.md +79 -0
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-output-review-api.md +4 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-override-rate-api.md +6 -5
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-config-api.md +22 -4
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-review-marker-api.md +15 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-agent-work-vocabulary-api.md +20 -3
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-dataset-export-api.md +16 -9
- package/dist/knowledge/skills/agent-work-review/references/framework-evaluation-export-authorization-api.md +24 -7
- package/dist/knowledge/skills/agent-work-review/references/framework-human-input-form-api.md +341 -0
- package/dist/knowledge/skills/ai-use-declaration/SKILL.md +192 -0
- package/dist/knowledge/skills/ai-use-declaration/references/choosing-the-domain-and-class.md +73 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-classification-api.md +194 -0
- package/dist/knowledge/skills/ai-use-declaration/references/framework-ai-use-posture-api.md +136 -0
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +41 -12
- package/dist/knowledge/skills/application-database-migrations/references/postgresql-vs-mongodb-obligations.md +34 -0
- package/dist/knowledge/skills/application-roles-authoring/SKILL.md +158 -0
- package/dist/knowledge/skills/application-roles-authoring/references/framework-application-roles-api.md +169 -0
- package/dist/knowledge/skills/application-roles-authoring/references/office-and-field-worked-example.md +63 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/SKILL.md +130 -4
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-assigned-rows-declaration-api.md +90 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-own-rows-declaration-api.md +59 -0
- package/dist/knowledge/skills/authorization-unit-narrowing/references/framework-unit-narrowing-declaration-api.md +6 -6
- package/dist/knowledge/skills/backend-addon-wiring/references/framework-backend-bootstrap-api.md +79 -2
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +291 -10
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-assurance-control-markers.md +3 -2
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +223 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-operation-base-and-path-api.md +20 -3
- package/dist/knowledge/skills/backend-custom-operation/references/framework-target-authority-api.md +61 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-transactional-core-api.md +368 -1
- package/dist/knowledge/skills/blueprint-authoring/SKILL.md +189 -0
- package/dist/knowledge/skills/blueprint-authoring/references/blueprint-content-kinds.md +29 -0
- package/dist/knowledge/skills/blueprint-authoring/references/framework-blueprint-definition-api.md +490 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +132 -2
- package/dist/knowledge/skills/brand-logo-authoring/references/brand-authoring-decisions.md +15 -3
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-brand-snapshot-api.md +26 -8
- package/dist/knowledge/skills/brand-logo-authoring/references/framework-style-word-lexicon-api.md +126 -0
- package/dist/knowledge/skills/brand-name-screening/SKILL.md +33 -9
- package/dist/knowledge/skills/brand-name-screening/references/framework-brand-name-screening-api.md +78 -6
- package/dist/knowledge/skills/brand-name-screening/references/screening-procedure.md +30 -8
- package/dist/knowledge/skills/chat-agent-conversations/SKILL.md +163 -0
- package/dist/knowledge/skills/chat-agent-conversations/references/framework-chat-conversations-api.md +295 -0
- package/dist/knowledge/skills/compliance-document-authoring/SKILL.md +2 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-governance.md +8 -6
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-privacy-notice.md +136 -34
- package/dist/knowledge/skills/compliance-document-authoring/references/document-composition-service-terms.md +4 -3
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-assurance-document-blueprint-contract.md +13 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-governed-document-after-drafting.md +34 -7
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-processor-register-authoring.md +10 -1
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-provider-compliance-choice-api.md +37 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-disclosures.md +178 -4
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-recipient-population.md +46 -0
- package/dist/knowledge/skills/compliance-document-authoring/references/framework-subject-data-recipients.md +485 -61
- package/dist/knowledge/skills/config-app-shell/SKILL.md +101 -19
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-api.md +20 -18
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/config-app-shell/references/framework-app-shell-hosted-components-api.md +13 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-brand-identity-api.md +20 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +472 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +82 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-shell-layout-api.md +528 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +271 -166
- package/dist/knowledge/skills/config-design-system/references/design-system-file.md +5 -1
- package/dist/knowledge/skills/config-design-system/references/framework-focus-indicator-api.md +182 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-contrast-api.md +195 -0
- package/dist/knowledge/skills/config-design-system/references/framework-palette-derivation-api.md +108 -0
- package/dist/knowledge/skills/config-design-system/references/framework-surface-policy-api.md +37 -0
- package/dist/knowledge/skills/config-design-system/references/framework-theme-composition-api.md +235 -0
- package/dist/knowledge/skills/config-design-system/references/theme-design-principles.md +202 -0
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-navigation/references/framework-content-width-api.md +16 -5
- package/dist/knowledge/skills/config-navigation/references/how-navigation-resolves.md +1 -1
- package/dist/knowledge/skills/config-navigation/references/navigation-configuration-map.md +7 -1
- package/dist/knowledge/skills/config-saas/SKILL.md +27 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +62 -4
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +80 -7
- package/dist/knowledge/skills/config-saas/references/framework-auditable-event-catalog.md +314 -0
- package/dist/knowledge/skills/config-saas/references/framework-background-work-api.md +29 -1
- package/dist/knowledge/skills/config-saas/references/framework-capability-resolution-api.md +8 -0
- package/dist/knowledge/skills/config-saas/references/framework-content-security-policy-api.md +1 -2
- package/dist/knowledge/skills/config-saas/references/framework-key-management-api.md +1182 -0
- package/dist/knowledge/skills/config-saas/references/framework-provider-capabilities-api.md +61 -0
- package/dist/knowledge/skills/config-saas/references/framework-systems-of-record-api.md +56 -11
- package/dist/knowledge/skills/config-saas/references/framework-value-moments-api.md +22 -0
- package/dist/knowledge/skills/config-saas/references/framework-wildo-saas-config-api.md +106 -14
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +11 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-application-owner-organization-codes-api.md +9 -10
- package/dist/knowledge/skills/config-saas-backend/references/framework-federated-identity-provider-private-networks-api.md +6 -4
- package/dist/knowledge/skills/config-saas-backend/references/framework-organization-types-api.md +155 -92
- package/dist/knowledge/skills/configure-billing/SKILL.md +32 -4
- package/dist/knowledge/skills/configure-billing/references/example-backend-provider-module-shape.md +10 -0
- package/dist/knowledge/skills/configure-billing/references/framework-metered-usage-recording-api.md +109 -0
- package/dist/knowledge/skills/configure-coding-agent/references/framework-acp-execution-profile-api.md +18 -2
- package/dist/knowledge/skills/email-add-template/SKILL.md +72 -9
- package/dist/knowledge/skills/email-add-template/references/email-artifact-paths.md +1 -1
- package/dist/knowledge/skills/email-add-template/references/framework-email-send-api.md +135 -0
- package/dist/knowledge/skills/email-add-template/references/framework-email-template-api.md +134 -0
- package/dist/knowledge/skills/email-add-template/references/framework-operation-email-template-ref-api.md +99 -0
- package/dist/knowledge/skills/engine-component-registration/SKILL.md +6 -1
- package/dist/knowledge/skills/engine-product-definitions/SKILL.md +21 -8
- package/dist/knowledge/skills/engine-product-definitions/references/framework-metered-usage-recording-api.md +28 -0
- package/dist/knowledge/skills/flows-actors-a2a-exposure/SKILL.md +71 -14
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-a2a-token-budget-api.md +95 -13
- package/dist/knowledge/skills/flows-actors-a2a-exposure/references/framework-flows-actors-a2a-contract.md +9 -1
- package/dist/knowledge/skills/flows-actors-autonomous-agents/SKILL.md +98 -9
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/binding-and-review.md +44 -16
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-autonomous-agent-api.md +160 -23
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/framework-inbound-agents-api.md +10 -3
- package/dist/knowledge/skills/flows-actors-autonomous-agents/references/tool-posture.md +14 -2
- package/dist/knowledge/skills/flows-actors-chat-assistant/SKILL.md +291 -22
- package/dist/knowledge/skills/flows-actors-chat-assistant/examples/todo-assistant.example.md +70 -14
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-behavior-reports-api.md +451 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-content-guardrails-api.md +406 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-operation-record-api.md +201 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-agent-suspension-api.md +172 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-ask-person-tool-api.md +121 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-decision-deadlines-api.md +7 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-realtime-catalog.md +63 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-tool-api.md +324 -7
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-flows-actors-view-api.md +95 -6
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-model-spend-limits-api.md +255 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-present-records-tool-api.md +150 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-retrieval-tool-api.md +251 -0
- package/dist/knowledge/skills/flows-actors-chat-assistant/references/framework-tool-dispatch-obligations-api.md +112 -16
- package/dist/knowledge/skills/flows-actors-declared-flow/SKILL.md +339 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-flow-model-api.md +264 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/framework-start-flow-api.md +133 -0
- package/dist/knowledge/skills/flows-actors-declared-flow/references/step-kinds.md +16 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +109 -9
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-definition-api.md +45 -0
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-agent-invocation-api.md +14 -3
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/references/framework-llm-operation-and-model-api.md +13 -6
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +16 -7
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +29 -18
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +144 -14
- package/dist/knowledge/skills/human-decision-notices/SKILL.md +150 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-card-wording-api.md +292 -0
- package/dist/knowledge/skills/human-decision-notices/references/framework-decision-notice-handler-api.md +340 -0
- package/dist/knowledge/skills/i18n-label-generation/SKILL.md +17 -1
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +19 -5
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +14 -3
- package/dist/knowledge/skills/inbound-channels/SKILL.md +66 -8
- package/dist/knowledge/skills/inbound-channels/references/email-channel.md +34 -1
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-channel-api.md +78 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-email-api.md +8 -8
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-handler-api.md +434 -6
- package/dist/knowledge/skills/inbound-channels/references/framework-inbound-pipelines-api.md +73 -0
- package/dist/knowledge/skills/inbound-channels/references/inbound-delivery-lifecycle.md +1 -1
- package/dist/knowledge/skills/inbound-channels/references/receiving-email.md +24 -13
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +113 -3
- package/dist/knowledge/skills/infra-environment-config/references/framework-environment-deployment-api.md +9 -1
- package/dist/knowledge/skills/infra-environment-config/references/framework-infrastructure-host-api.md +2 -0
- package/dist/knowledge/skills/infra-environment-config/references/framework-platform-key-management-api.md +294 -0
- package/dist/knowledge/skills/layout-2d-adoption/SKILL.md +158 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/choosing-a-layout.md +43 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-authoring-api.md +167 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-registration-api.md +101 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-2d-layout-settings-api.md +59 -0
- package/dist/knowledge/skills/layout-2d-adoption/references/framework-shell-motion-api.md +415 -0
- package/dist/knowledge/skills/layout-3d-adoption/SKILL.md +1 -0
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-contract-api.md +65 -32
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-3d-layout-registration-api.md +14 -36
- package/dist/knowledge/skills/layout-3d-adoption/references/framework-shell-building-blocks-api.md +7 -3
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/references/derived-artifact-currency.md +4 -2
- package/dist/knowledge/skills/market-add-feature-benefit/SKILL.md +10 -2
- package/dist/knowledge/skills/market-alternatives/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/SKILL.md +10 -2
- package/dist/knowledge/skills/market-authoring-overview/references/framework-market-references-api.md +14 -1
- package/dist/knowledge/skills/market-category/SKILL.md +21 -7
- package/dist/knowledge/skills/market-channels/SKILL.md +6 -1
- package/dist/knowledge/skills/market-companion-prompt-enrichment/SKILL.md +20 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +10 -1
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +23 -12
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +13 -7
- package/dist/knowledge/skills/market-icp/SKILL.md +10 -2
- package/dist/knowledge/skills/market-jobs-pains-gains/SKILL.md +6 -1
- package/dist/knowledge/skills/market-message-templates-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-persona/SKILL.md +14 -3
- package/dist/knowledge/skills/market-positioning-authoring/SKILL.md +6 -1
- package/dist/knowledge/skills/market-proof-and-objection/SKILL.md +10 -2
- package/dist/knowledge/skills/market-scoring-interpretation/SKILL.md +6 -1
- package/dist/knowledge/skills/market-snapshot-validation/SKILL.md +14 -3
- package/dist/knowledge/skills/market-tone-of-voice/SKILL.md +6 -1
- package/dist/knowledge/skills/minion-authoring/examples/contained-tick.example.md +1 -1
- package/dist/knowledge/skills/minion-authoring/references/framework-minion-tick-contract.md +2 -2
- package/dist/knowledge/skills/model-cost-attribution/SKILL.md +40 -10
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-pricing-api.md +57 -2
- package/dist/knowledge/skills/model-cost-attribution/references/framework-model-cost-summary-api.md +57 -21
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-attribution-api.md +7 -3
- package/dist/knowledge/skills/model-cost-attribution/references/framework-work-unit-api.md +176 -4
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-companion-exports/references/companion-exports-by-package.md +9 -0
- package/dist/knowledge/skills/module-registration/references/framework-domain-modules-api.md +81 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +81 -31
- package/dist/knowledge/skills/module-relationships/references/framework-resource-relationship-authoring-api.md +8 -4
- package/dist/knowledge/skills/organization-relationships/SKILL.md +668 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-organization-relationships-api.md +1233 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-capability-grants-api.md +243 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-grantor-authentication-api.md +284 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-kinds-api.md +521 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-relationship-record-separation-api.md +162 -0
- package/dist/knowledge/skills/organization-relationships/references/framework-representative-activity-api.md +145 -0
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/pdf-template-authoring/references/framework-pdf-collection-template-api.md +5 -3
- package/dist/knowledge/skills/professional-qualifications/SKILL.md +173 -0
- package/dist/knowledge/skills/professional-qualifications/references/choosing-who-may-decide.md +53 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-approval-requirement-api.md +67 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-operation-required-qualifications-api.md +39 -0
- package/dist/knowledge/skills/professional-qualifications/references/framework-professional-qualifications-api.md +223 -0
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +15 -4
- package/dist/knowledge/skills/provider-address-lookup/references/framework-browser-operation-policy-api.md +3 -3
- package/dist/knowledge/skills/provider-backend-package/SKILL.md +138 -4
- package/dist/knowledge/skills/provider-backend-package/references/framework-optional-runtime-peers.md +32 -28
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-augmentation-api.md +16 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-file-storage-adapter-api.md +6 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-inbound-endpoint-api.md +634 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-incremental-consent-api.md +70 -0
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-shared-connection-api.md +61 -2
- package/dist/knowledge/skills/provider-backend-package/references/framework-provider-subject-erasure-effect-api.md +222 -0
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +15 -6
- package/dist/knowledge/skills/provider-frontend-file-picker/references/framework-frontend-provider-consent-api.md +9 -2
- package/dist/knowledge/skills/provider-frontend-module/SKILL.md +47 -5
- package/dist/knowledge/skills/provider-frontend-module/references/framework-on-demand-capabilities-api.md +306 -0
- package/dist/knowledge/skills/provider-frontend-module/references/package-frontend-facets.md +11 -3
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +37 -14
- package/dist/knowledge/skills/provider-operation-calls/references/browser-door-answers.md +56 -18
- package/dist/knowledge/skills/provider-operation-calls/references/framework-browser-operation-policy-api.md +1 -1
- package/dist/knowledge/skills/provider-operation-calls/references/framework-frontend-execute-operation-api.md +143 -25
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-operation-executor-api.md +6 -0
- package/dist/knowledge/skills/provider-operation-calls/references/framework-provider-scope-reauthorization-api.md +9 -6
- package/dist/knowledge/skills/provider-operation-calls/references/framework-rest-operation-contract-api.md +256 -1
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +81 -37
- package/dist/knowledge/skills/rate-limit-authoring/references/framework-rate-limit-policy-api.md +27 -13
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/examples/add-priority-field-to-todos.example.md +32 -12
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +167 -61
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +63 -6
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +84 -2
- package/dist/knowledge/skills/resource-chat-commands/SKILL.md +137 -0
- package/dist/knowledge/skills/resource-chat-commands/references/framework-resource-chat-command-contract.md +72 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +131 -7
- package/dist/knowledge/skills/resource-config-wiring/references/framework-administrative-continuity-codes-api.md +4 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-authority-audit-interpretation.md +17 -8
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +25 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-approval-api.md +323 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +23 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-bulk-api.md +159 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +162 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-request-field-offers-api.md +168 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-required-features-api.md +20 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-retention-policy-operations.md +135 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-operation-scope-enums-api.md +3 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-saas-models-resource-config-api.md +221 -23
- package/dist/knowledge/skills/resource-config-wiring/references/framework-scope-admissions-api.md +108 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-system-access-reads-api.md +242 -107
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +202 -17
- package/dist/knowledge/skills/resource-config-wiring/references/framework-webhook-events-api.md +116 -0
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +123 -56
- package/dist/knowledge/skills/resource-external-data/SKILL.md +280 -64
- package/dist/knowledge/skills/resource-external-data/references/bidirectional-pipelines.md +335 -0
- package/dist/knowledge/skills/resource-external-data/references/declared-expressions.md +18 -6
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +73 -14
- package/dist/knowledge/skills/resource-external-data/references/facet-augmentations.md +6 -0
- package/dist/knowledge/skills/resource-external-data/references/framework-external-data-pipeline-api.md +81 -18
- package/dist/knowledge/skills/resource-external-data/references/framework-http-api-binding-api.md +238 -49
- package/dist/knowledge/skills/resource-external-data/references/framework-pipeline-admin-endpoints-api.md +111 -11
- package/dist/knowledge/skills/resource-external-data/references/framework-system-of-record-capabilities-api.md +145 -0
- package/dist/knowledge/skills/resource-external-data/references/incremental-extraction.md +30 -4
- package/dist/knowledge/skills/resource-external-data/references/odata-v2-sources.md +21 -9
- package/dist/knowledge/skills/resource-external-data/references/outbound-pipelines.md +61 -14
- package/dist/knowledge/skills/resource-external-data/references/provenance-cue.md +18 -2
- package/dist/knowledge/skills/resource-external-data/references/rate-budgets-and-pacing.md +3 -1
- package/dist/knowledge/skills/resource-external-data/references/read-through-writes.md +39 -13
- package/dist/knowledge/skills/resource-external-data/references/remote-references.md +17 -7
- package/dist/knowledge/skills/resource-external-data/references/requested-keys.md +104 -0
- package/dist/knowledge/skills/resource-external-data/references/system-of-record-actions.md +1 -1
- package/dist/knowledge/skills/resource-mcp-tool-exposure/SKILL.md +17 -4
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/framework-resource-mcp-exposure-contract.md +2 -2
- package/dist/knowledge/skills/resource-mcp-tool-exposure/references/mcp-catalogue-withdrawal-and-verification.md +1 -1
- package/dist/knowledge/skills/resource-rag-source-fields/SKILL.md +6 -0
- package/dist/knowledge/skills/resource-rag-source-fields/references/framework-embeddings-capability-api.md +31 -1
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +8 -2
- package/dist/knowledge/skills/resource-retention-binding/references/framework-legal-holds-api.md +68 -5
- package/dist/knowledge/skills/resource-retention-binding/references/framework-statutory-retention-api.md +25 -0
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +39 -9
- package/dist/knowledge/skills/resource-schema-authoring/examples/add-enum-field-with-ui.example.md +23 -7
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +571 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/field-type-selection.md +2 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +87 -6
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-erasure-scrub-treatments-api.md +19 -22
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-personal-data-category-api.md +127 -12
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-schema-family-api.md +17 -4
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +50 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-structural-params-api.md +44 -5
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +119 -64
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-system-managed-fields-api.md +2 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +216 -18
- package/dist/knowledge/skills/resource-schema-authoring/references/shared-layer-decorator-checklist.md +6 -0
- package/dist/knowledge/skills/resource-status-lifecycle/SKILL.md +153 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/commercial-documents.md +46 -0
- package/dist/knowledge/skills/resource-status-lifecycle/references/quote-lifecycle-worked-example.md +198 -0
- package/dist/knowledge/skills/resource-ui-behavior/SKILL.md +185 -80
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +159 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-display-edit-modes-api.md +120 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-enum-frontend-handling-api.md +41 -7
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-field-tiles-api.md +114 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +257 -65
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-per-primitive-ui-api.md +25 -9
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-primitive-ui-api.md +15 -3
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-related-resource-embeds-api.md +151 -1
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-resource-layout-templates-api.md +144 -57
- package/dist/knowledge/skills/resource-ui-behavior/references/record-page-anatomy.md +131 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/surface-decisions.md +57 -31
- package/dist/knowledge/skills/resource-ui-behavior/references/visual-quality-rubric.md +56 -0
- package/dist/knowledge/skills/seeding-authoring/SKILL.md +155 -40
- package/dist/knowledge/skills/seeding-authoring/references/cross-seed-row-references.md +67 -0
- package/dist/knowledge/skills/seeding-authoring/references/data-seeding-mode-picker.md +16 -1
- package/dist/knowledge/skills/seeding-authoring/references/framework-data-seeding-api.md +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/seeding-operations/references/data-seeding-admin-runbook.md +15 -8
- package/dist/knowledge/skills/seeding-operations/references/framework-data-seeding-operations-api.md +3 -0
- package/dist/knowledge/skills/settings-placement-authoring/SKILL.md +42 -11
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +183 -31
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +64 -2
- package/dist/knowledge/skills/spec-catalog-authoring/SKILL.md +5 -4
- package/dist/knowledge/skills/spec-catalog-authoring/references/catalog-spec-pattern-overview.md +5 -4
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-companion-exports/references/framework-companion-exports-contract-api.md +9 -0
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +17 -9
- package/dist/knowledge/skills/spec-family-update/SKILL.md +71 -66
- package/dist/knowledge/skills/spec-family-update/references/family-spec-routing.md +1 -1
- package/dist/knowledge/skills/spec-resource-update/SKILL.md +30 -10
- package/dist/knowledge/skills/spec-resource-update/references/framework-spec-resource-contracts-api.md +71 -14
- package/dist/knowledge/skills/spec-resource-update/references/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/spec-update-after-change/references/framework-spec-factory-api.md +19 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +20 -6
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +20 -3
- package/dist/knowledge/skills/views-add-custom-view/references/framework-focus-indicator-api.md +145 -0
- package/dist/knowledge/skills/views-app-level/SKILL.md +13 -3
- package/dist/knowledge/skills/views-app-level/references/application-home.md +56 -0
- package/dist/knowledge/skills/views-chart-authoring/SKILL.md +226 -37
- package/dist/knowledge/skills/views-chart-authoring/references/framework-chart-view-contracts-api.md +13 -0
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +33 -9
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +12 -3
- package/dist/knowledge/skills/views-execution-authoring/references/framework-execution-view-contracts-api.md +17 -3
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +93 -27
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +264 -78
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +1068 -192
- package/dist/knowledge/skills/website-building-blocks/SKILL.md +337 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-blocks-api.md +3050 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-demo-examples.md +627 -0
- package/dist/knowledge/skills/website-building-blocks/references/framework-website-product-kit-api.md +3309 -0
- package/dist/knowledge/skills/website-building-blocks/references/website-visual-quality-rubric.md +75 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +46 -19
- package/dist/knowledge/skills/website-bundle-discipline/references/example-website-button-override.md +8 -12
- package/dist/knowledge/skills/website-bundle-discipline/references/website-bundle-rules.md +18 -5
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +97 -29
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +77 -66
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +71 -24
- package/dist/knowledge/skills/website-inbound-contact-forms/references/framework-submission-challenge-api.md +5 -1
- package/dist/knowledge/skills/website-label-pack/SKILL.md +24 -17
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +116 -76
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +43 -14
- package/dist/knowledge/skills/website-motion-design/SKILL.md +277 -0
- package/dist/knowledge/skills/website-motion-design/references/framework-motion-api.md +1562 -0
- package/dist/knowledge/skills/website-motion-design/references/industry-practice.md +28 -0
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +266 -371
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-menu-api.md +712 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +120 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/menu-keys-and-styling.md +151 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +131 -329
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +170 -66
- package/dist/knowledge/skills/website-page-authoring/references/framework-page-kinds-api.md +982 -0
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +27 -3
- package/dist/knowledge/skills/website-page-authoring/references/homepage-content-and-art-direction.md +19 -0
- package/dist/knowledge/skills/website-page-authoring/references/page-kinds.md +118 -0
- package/dist/knowledge/skills/website-page-variants/SKILL.md +70 -69
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +54 -29
- package/dist/knowledge/skills/website-section-comparison/SKILL.md +1171 -0
- package/dist/knowledge/skills/website-section-comparison/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-comparison/references/framework-website-tables-api.md +487 -0
- package/dist/knowledge/skills/website-section-contact/SKILL.md +408 -185
- package/dist/knowledge/skills/website-section-contact/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-cta/SKILL.md +398 -234
- package/dist/knowledge/skills/website-section-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/SKILL.md +564 -300
- package/dist/knowledge/skills/website-section-faq/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-faq/references/framework-website-faq-api.md +489 -0
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +650 -272
- package/dist/knowledge/skills/website-section-feature-benefit-summary/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +577 -261
- package/dist/knowledge/skills/website-section-feature-detail/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-footer-cta/SKILL.md +532 -233
- package/dist/knowledge/skills/website-section-footer-cta/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-hero/SKILL.md +606 -330
- package/dist/knowledge/skills/website-section-hero/references/define-website-section-api.md +198 -120
- package/dist/knowledge/skills/website-section-how-it-works/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-how-it-works/references/framework-website-steps-api.md +337 -0
- package/dist/knowledge/skills/website-section-integrations/SKILL.md +974 -0
- package/dist/knowledge/skills/website-section-integrations/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-integrations/references/framework-website-marquee-api.md +825 -0
- package/dist/knowledge/skills/website-section-latest-posts/SKILL.md +928 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-latest-posts/references/framework-website-latest-posts-api.md +465 -0
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +552 -376
- package/dist/knowledge/skills/website-section-pricing/examples/pricing-offers.example.md +77 -0
- package/dist/knowledge/skills/website-section-pricing/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-pricing/references/framework-pricing-catalog-api.md +2 -1
- package/dist/knowledge/skills/website-section-pricing/references/framework-website-pricing-api.md +670 -0
- package/dist/knowledge/skills/website-section-problem/SKILL.md +1150 -0
- package/dist/knowledge/skills/website-section-problem/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-problem/references/framework-website-card-grid-api.md +664 -0
- package/dist/knowledge/skills/website-section-product-showcase/SKILL.md +1322 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-card-grid-api.md +533 -0
- package/dist/knowledge/skills/website-section-product-showcase/references/framework-website-product-tour-api.md +917 -0
- package/dist/knowledge/skills/website-section-roadmap/SKILL.md +1133 -0
- package/dist/knowledge/skills/website-section-roadmap/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-roadmap/references/framework-website-roadmap-api.md +475 -0
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +743 -309
- package/dist/knowledge/skills/website-section-social-proof/references/define-website-section-api.md +197 -119
- package/dist/knowledge/skills/website-section-social-proof/references/framework-website-quote-cards-api.md +623 -0
- package/dist/knowledge/skills/website-section-solution-paths/SKILL.md +1057 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-solution-paths/references/framework-website-solution-paths-api.md +477 -0
- package/dist/knowledge/skills/website-section-stats/SKILL.md +1086 -0
- package/dist/knowledge/skills/website-section-stats/references/define-website-section-api.md +679 -0
- package/dist/knowledge/skills/website-section-stats/references/framework-website-stats-api.md +517 -0
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +198 -70
- package/dist/knowledge/skills/website-seo-aeo-geo/references/aeo-api.md +575 -57
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +17 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +8 -95
- package/dist/knowledge/skills/website-theme-authoring/SKILL.md +226 -0
- package/dist/knowledge/skills/website-theme-authoring/references/framework-website-theme-api.md +893 -0
- package/dist/knowledge/skills/worker-authoring/references/framework-worker-init-contract.md +4 -2
- package/dist/knowledge/topic-index.json +17305 -8263
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
- package/dist/knowledge/references/example.organizations.serves-as-provider.md +0 -12
- package/dist/knowledge/references/saas.models.organizations.service-provider-activity-feed.md +0 -121
- package/dist/knowledge/references/saas.models.organizations.service-provider-client-controls.md +0 -49
- package/dist/knowledge/references/saas.models.organizations.service-provider-relationships.md +0 -567
- package/dist/knowledge/references/saas.website.root-config.navigation.md +0 -37
- package/dist/knowledge/skills/service-provider-relationships/SKILL.md +0 -455
- package/dist/knowledge/skills/service-provider-relationships/references/framework-organization-types-api.md +0 -270
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-activity-feed-api.md +0 -129
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-capability-grants-api.md +0 -161
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-client-authentication-api.md +0 -224
- package/dist/knowledge/skills/service-provider-relationships/references/framework-service-provider-relationships-api.md +0 -576
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
*
|
|
16
16
|
* ## Why this family exists
|
|
17
17
|
*
|
|
18
|
-
* The framework ships
|
|
18
|
+
* The framework ships the `website-*` skills, an `add-website` scenario and a whole engine
|
|
19
19
|
* (`@wildo-ai/saas-website`). Measured 2026-09-22: **no playbook named the word "website"**, so the
|
|
20
20
|
* largest finished asset in the catalog had no door — an application could be given a website only
|
|
21
21
|
* by a human running `wildo compose` and then authoring every page by hand.
|
|
@@ -33,8 +33,8 @@
|
|
|
33
33
|
* Which pages a site needs is largely derivable (a pricing page follows from declared pricing
|
|
34
34
|
* plans), and which SECTIONS tell the story — which proofs answer which objections, in which order,
|
|
35
35
|
* in which tone — is composition judgement over authored market content. That is what a harnessed
|
|
36
|
-
* model with the market snapshot in front of it is for
|
|
37
|
-
*
|
|
36
|
+
* model with the market snapshot in front of it is for, and the skills that carry each section's HOW
|
|
37
|
+
* are shipped beside it.
|
|
38
38
|
*/
|
|
39
39
|
export enum WebsitePlanVersion {
|
|
40
40
|
V1 = 'v1',
|
|
@@ -46,8 +46,7 @@ export const WEBSITE_PAGE_REF_PREFIX = 'page-';
|
|
|
46
46
|
/**
|
|
47
47
|
* WHETHER this application has a marketing website at all.
|
|
48
48
|
*
|
|
49
|
-
* Representable rather than refused
|
|
50
|
-
* capability composition decides whether the application gets a website, and an application that
|
|
49
|
+
* Representable rather than refused: the capability composition decides whether the application gets a website, and an application that
|
|
51
50
|
* declines one must still be able to RECORD that — a plan that could only be produced for a site
|
|
52
51
|
* that exists would make "no website" an absence nobody can read, and would make the build lane's
|
|
53
52
|
* consumption of this family conditional on a file's existence rather than on what it says.
|
|
@@ -66,6 +65,84 @@ export enum WebsitePlanDisposition {
|
|
|
66
65
|
NOT_APPLICABLE = 'NOT_APPLICABLE',
|
|
67
66
|
}
|
|
68
67
|
|
|
68
|
+
/**
|
|
69
|
+
* WHAT KIND of page this is — the question a visitor arrives with, and so its route, its place in the menu and
|
|
70
|
+
* the sections it cannot do without.
|
|
71
|
+
*
|
|
72
|
+
* A closed vocabulary because each member DECIDES things nothing else should be asked: the route
|
|
73
|
+
* (`websitePageRoutePath`), the menu placement (`websitePageMenuPlacement`) and the essentials the validator
|
|
74
|
+
* checks (`WEBSITE_PAGE_KIND_ESSENTIALS`). Before it, every page was a free slug with a one-sentence purpose, the
|
|
75
|
+
* only vocabulary was a four-row prose table (landing / pricing / features / contact), and "product page" or
|
|
76
|
+
* "solution page" existed nowhere in the lane.
|
|
77
|
+
*
|
|
78
|
+
* The product / solution split is how SaaS sites are actually built: Stripe's menu separates Products (named
|
|
79
|
+
* capabilities, one line each) from Solutions (by stage, use case, industry); a product page answers "what does
|
|
80
|
+
* it do", a solution page "how does it solve MY problem", problem-led and cut by role, industry, use case or company
|
|
81
|
+
* size. NN/g's caution about audience-based navigation is why solutions are SECONDARY to the product in the menu
|
|
82
|
+
* and why a solution page is named for the visitor ("For finance teams"), never instead of the product.
|
|
83
|
+
*/
|
|
84
|
+
export enum WebsitePageKind {
|
|
85
|
+
/** The site's front door, at `/`. Exactly one. */
|
|
86
|
+
HOME = 'HOME',
|
|
87
|
+
/** The product as a whole — every area at a glance — at `/product`. At most one; the Product panel's overview. */
|
|
88
|
+
PRODUCT_OVERVIEW = 'PRODUCT_OVERVIEW',
|
|
89
|
+
/** One product area or capability, at `/product/<slug>`: what it is, how it works, what it changes. */
|
|
90
|
+
PRODUCT = 'PRODUCT',
|
|
91
|
+
/**
|
|
92
|
+
* The product seen from one audience's problem, at `/solutions/<slug>`: problem-led, then how the product
|
|
93
|
+
* answers it. Carries a `solutionAxis`, which groups the Solutions panel.
|
|
94
|
+
*/
|
|
95
|
+
SOLUTION = 'SOLUTION',
|
|
96
|
+
/** The plans, at `/pricing`. At most one. */
|
|
97
|
+
PRICING = 'PRICING',
|
|
98
|
+
/** A way to reach a person, at `/contact`. At most one. */
|
|
99
|
+
CONTACT = 'CONTACT',
|
|
100
|
+
/** Who is behind the product and why, at `/about`. At most one. */
|
|
101
|
+
COMPANY = 'COMPANY',
|
|
102
|
+
/**
|
|
103
|
+
* What a buyer's security review asks, answered from the product, at `/security`. At most one. Planned when the
|
|
104
|
+
* application really has controls to describe — where its data is stored, how people sign in, what it records,
|
|
105
|
+
* how long it keeps what, the rights a person can exercise — and never as a page of badges: a certification the
|
|
106
|
+
* application does not hold is not on it. Joins the Product panel, beside the areas it protects.
|
|
107
|
+
*/
|
|
108
|
+
TRUST = 'TRUST',
|
|
109
|
+
/**
|
|
110
|
+
* The blog's index, at `/blog`. At most one. Planned when the application publishes posts (the engine's blog
|
|
111
|
+
* adapter: one MDX file per post, per locale); the index lists them newest first, from their own frontmatter.
|
|
112
|
+
*/
|
|
113
|
+
BLOG = 'BLOG',
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** How a SOLUTION page cuts the audience — the column it sits in under Solutions. */
|
|
117
|
+
export enum WebsiteSolutionAxis {
|
|
118
|
+
/** A job function: finance teams, operations leads, founders. */
|
|
119
|
+
ROLE = 'ROLE',
|
|
120
|
+
/** A sector: retail, banking, healthcare. */
|
|
121
|
+
INDUSTRY = 'INDUSTRY',
|
|
122
|
+
/** A job to be done, across roles: onboarding customers, closing the books. */
|
|
123
|
+
USE_CASE = 'USE_CASE',
|
|
124
|
+
/** A stage or size: startups, scale-ups, enterprises. */
|
|
125
|
+
COMPANY_SIZE = 'COMPANY_SIZE',
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
/**
|
|
129
|
+
* The HOME page's slug — the scaffold's starter page (`add-website` writes `landing`, mounted at `/`).
|
|
130
|
+
*
|
|
131
|
+
* Fixed, not chosen: the home page is not a new page the build adds, it is the starter it grows. A plan that named
|
|
132
|
+
* its home `home` would make the page task author a SECOND page at `/` beside the starter (scratch-journey did, by
|
|
133
|
+
* renaming files by hand). `SCAFFOLDED_WEBSITE_STARTER` reads this constant, and the plan refuses a HOME page under
|
|
134
|
+
* any other ref (`WEBSITE_HOME_PAGE_REF`) — the stored plan, not only the generation contract, so a plan written
|
|
135
|
+
* before the rule, or by hand, cannot carry one past it.
|
|
136
|
+
*
|
|
137
|
+
* A site has at most one page of each kind with a fixed route (HOME, PRODUCT_OVERVIEW, PRICING, CONTACT, COMPANY,
|
|
138
|
+
* TRUST, BLOG):
|
|
139
|
+
* that needs no list of its own, because two such pages derive one route and the plan refuses two pages on a route.
|
|
140
|
+
*/
|
|
141
|
+
export const WEBSITE_HOME_PAGE_SLUG = 'landing';
|
|
142
|
+
|
|
143
|
+
/** The HOME page's stamped ref, `page-landing`: the one value a HOME page's `pageRef` may hold. */
|
|
144
|
+
export const WEBSITE_HOME_PAGE_REF: string = `${WEBSITE_PAGE_REF_PREFIX}${WEBSITE_HOME_PAGE_SLUG}`;
|
|
145
|
+
|
|
69
146
|
/**
|
|
70
147
|
* WHAT a section does on its page — a closed vocabulary, because each member names the SKILL that
|
|
71
148
|
* carries its authoring, and a section a skill cannot build is a section no task can land.
|
|
@@ -93,17 +170,54 @@ export enum WebsiteSectionKind {
|
|
|
93
170
|
FOOTER_CTA = 'FOOTER_CTA',
|
|
94
171
|
/** A way to reach a human — the inbound contact form. */
|
|
95
172
|
CONTACT = 'CONTACT',
|
|
173
|
+
/**
|
|
174
|
+
* The problem the audience lives with, told in their words before any product appears — the opening argument of
|
|
175
|
+
* a SOLUTION page, and of a home page whose visitors do not yet know they have the problem.
|
|
176
|
+
*/
|
|
177
|
+
PROBLEM = 'PROBLEM',
|
|
178
|
+
/** How it works, in three or four steps — what the visitor does and what the product does at each. */
|
|
179
|
+
HOW_IT_WORKS = 'HOW_IT_WORKS',
|
|
180
|
+
/**
|
|
181
|
+
* The product itself, shown: the real interface in a frame, a bento of its key screens, or tabs across its main
|
|
182
|
+
* views. What makes a modern home page read as a product and not as a brochure.
|
|
183
|
+
*/
|
|
184
|
+
PRODUCT_SHOWCASE = 'PRODUCT_SHOWCASE',
|
|
185
|
+
/**
|
|
186
|
+
* The paths into the site by audience — one card per SOLUTION page, each linking to it. Lets a home or product
|
|
187
|
+
* overview page route a visitor to the page written for them.
|
|
188
|
+
*/
|
|
189
|
+
SOLUTION_PATHS = 'SOLUTION_PATHS',
|
|
190
|
+
/** The product against the alternatives the market snapshot names — honestly, including where it is not better. */
|
|
191
|
+
COMPARISON = 'COMPARISON',
|
|
192
|
+
/**
|
|
193
|
+
* Facts about the product, as figures — each one a value the application itself declares (a retention period, a
|
|
194
|
+
* count of operations, a storage region) with what it means. Never a measured outcome nobody measured ("40% faster"),
|
|
195
|
+
* never a customer count the application cannot show.
|
|
196
|
+
*/
|
|
197
|
+
STATS = 'STATS',
|
|
198
|
+
/**
|
|
199
|
+
* The systems the product connects to, by name — each one a provider or protocol the application really declares,
|
|
200
|
+
* with what the connection does. A marquee, a catalog, or both.
|
|
201
|
+
*/
|
|
202
|
+
INTEGRATIONS = 'INTEGRATIONS',
|
|
203
|
+
/** The newest posts of the site's blog, as cards read from the posts' own frontmatter. */
|
|
204
|
+
LATEST_POSTS = 'LATEST_POSTS',
|
|
205
|
+
/**
|
|
206
|
+
* What has shipped and what is next, in the open — the product's phases as the application's roadmap declares
|
|
207
|
+
* them. A stage that is not built is labelled as next or later, never presented as available.
|
|
208
|
+
*/
|
|
209
|
+
ROADMAP = 'ROADMAP',
|
|
96
210
|
}
|
|
97
211
|
|
|
98
212
|
/**
|
|
99
213
|
* The app-knowledge skill that authors each section kind — TOTAL over the vocabulary, so a kind
|
|
100
214
|
* added tomorrow must name the skill that builds it or fail to compile.
|
|
101
215
|
*
|
|
102
|
-
* This is what makes the
|
|
216
|
+
* This is what makes the `website-section-*` skills REACHABLE. The decomposer's model writes a
|
|
103
217
|
* task's `skillRefs`, and nothing forces it to write the right one — so the companion's dispatch
|
|
104
218
|
* derives the skill from the section's KIND through {@link websiteProductSkillRefs} and hands that to
|
|
105
|
-
* the coding agent, rather than trusting a model to remember
|
|
106
|
-
*
|
|
219
|
+
* the coding agent, rather than trusting a model to remember the skill folder names (a capability whose
|
|
220
|
+
* skill never reaches the agent is one the journey cannot build). Held to the
|
|
107
221
|
* authored catalog by a test in the framework-knowledge package — this layer cannot import the
|
|
108
222
|
* skills, and a ref naming no folder is a task nothing can route.
|
|
109
223
|
*/
|
|
@@ -117,17 +231,46 @@ export const WEBSITE_SECTION_SKILL_REF: Readonly<Record<WebsiteSectionKind, stri
|
|
|
117
231
|
[WebsiteSectionKind.CTA]: 'website-section-cta',
|
|
118
232
|
[WebsiteSectionKind.FOOTER_CTA]: 'website-section-footer-cta',
|
|
119
233
|
[WebsiteSectionKind.CONTACT]: 'website-section-contact',
|
|
234
|
+
[WebsiteSectionKind.PROBLEM]: 'website-section-problem',
|
|
235
|
+
[WebsiteSectionKind.HOW_IT_WORKS]: 'website-section-how-it-works',
|
|
236
|
+
[WebsiteSectionKind.PRODUCT_SHOWCASE]: 'website-section-product-showcase',
|
|
237
|
+
[WebsiteSectionKind.SOLUTION_PATHS]: 'website-section-solution-paths',
|
|
238
|
+
[WebsiteSectionKind.COMPARISON]: 'website-section-comparison',
|
|
239
|
+
[WebsiteSectionKind.STATS]: 'website-section-stats',
|
|
240
|
+
[WebsiteSectionKind.INTEGRATIONS]: 'website-section-integrations',
|
|
241
|
+
[WebsiteSectionKind.LATEST_POSTS]: 'website-section-latest-posts',
|
|
242
|
+
[WebsiteSectionKind.ROADMAP]: 'website-section-roadmap',
|
|
120
243
|
};
|
|
121
244
|
|
|
122
245
|
/** The app-knowledge skill that authors a website PAGE — its route, bridge, manifest and section list. */
|
|
123
246
|
export const WEBSITE_PAGE_SKILL_REF = 'website-page-authoring';
|
|
124
247
|
|
|
248
|
+
/**
|
|
249
|
+
* The skills a PAGE task is authored with, per page kind: always {@link WEBSITE_PAGE_SKILL_REF}, plus the skill
|
|
250
|
+
* that owns what a kind needs beyond a page. A BLOG page is a content collection, post routes, an MDX integration and
|
|
251
|
+
* a blog vocabulary before it is a page, and only `website-blog-authoring` teaches that wiring: bound to the page
|
|
252
|
+
* skill alone, the agent building a blog page was never shown it. Total over the kinds, so a kind added later decides
|
|
253
|
+
* its skills here rather than silently getting the page skill only.
|
|
254
|
+
*/
|
|
255
|
+
export const WEBSITE_PAGE_KIND_SKILL_REFS: Readonly<Record<WebsitePageKind, readonly string[]>> = {
|
|
256
|
+
[WebsitePageKind.HOME]: [WEBSITE_PAGE_SKILL_REF],
|
|
257
|
+
[WebsitePageKind.PRODUCT_OVERVIEW]: [WEBSITE_PAGE_SKILL_REF],
|
|
258
|
+
[WebsitePageKind.PRODUCT]: [WEBSITE_PAGE_SKILL_REF],
|
|
259
|
+
[WebsitePageKind.SOLUTION]: [WEBSITE_PAGE_SKILL_REF],
|
|
260
|
+
[WebsitePageKind.PRICING]: [WEBSITE_PAGE_SKILL_REF],
|
|
261
|
+
[WebsitePageKind.CONTACT]: [WEBSITE_PAGE_SKILL_REF],
|
|
262
|
+
[WebsitePageKind.COMPANY]: [WEBSITE_PAGE_SKILL_REF],
|
|
263
|
+
[WebsitePageKind.TRUST]: [WEBSITE_PAGE_SKILL_REF],
|
|
264
|
+
[WebsitePageKind.BLOG]: [WEBSITE_PAGE_SKILL_REF, 'website-blog-authoring'],
|
|
265
|
+
};
|
|
266
|
+
|
|
125
267
|
/**
|
|
126
268
|
* The skills a website build product is authored with, DERIVED from the plan.
|
|
127
269
|
*
|
|
128
|
-
* A page is authored with {@link
|
|
129
|
-
*
|
|
130
|
-
* plan does not carry derives nothing, and the caller
|
|
270
|
+
* A page is authored with the skills its kind names in {@link WEBSITE_PAGE_KIND_SKILL_REFS} (the page skill alone when
|
|
271
|
+
* the plan does not carry the page); a section with the skill its kind names in {@link WEBSITE_SECTION_SKILL_REF},
|
|
272
|
+
* looked up in the plan by page and section ref. A section the plan does not carry derives nothing, and the caller
|
|
273
|
+
* keeps whatever the task declared.
|
|
131
274
|
*
|
|
132
275
|
* Structural input, not the build-plan product type, so this family does not depend on the build
|
|
133
276
|
* plan's schema — the build plan depends on it.
|
|
@@ -136,19 +279,234 @@ export function websiteProductSkillRefs(
|
|
|
136
279
|
product: { readonly pageRef: string; readonly sectionRef?: string | undefined },
|
|
137
280
|
plan: WebsitePlan | undefined,
|
|
138
281
|
): string[] {
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
?.sections.find((entry) => entry.sectionRef === product.sectionRef);
|
|
282
|
+
const page = plan?.pages.find((entry) => entry.pageRef === product.pageRef);
|
|
283
|
+
if (product.sectionRef === undefined) return page === undefined ? [WEBSITE_PAGE_SKILL_REF] : [...WEBSITE_PAGE_KIND_SKILL_REFS[page.kind]];
|
|
284
|
+
const section = page?.sections.find((entry) => entry.sectionRef === product.sectionRef);
|
|
143
285
|
return section === undefined ? [] : [WEBSITE_SECTION_SKILL_REF[section.kind]];
|
|
144
286
|
}
|
|
145
287
|
|
|
146
|
-
|
|
288
|
+
/**
|
|
289
|
+
* The shape of every identifier the plan hands to the site: a section ref, and a page's slug (the `<slug>` of
|
|
290
|
+
* `page-<slug>`). Both become identifiers the website validates. `WebsiteSectionRef` and `WebsitePageRef` start with
|
|
291
|
+
* a letter, a page's slug also becomes its const prefix (`<SLUG>_PAGE_MANIFEST`, which must be a valid identifier),
|
|
292
|
+
* and a PRODUCT or SOLUTION page's slug becomes a menu item ref. A plan that accepted `360-view` produced a site the
|
|
293
|
+
* engine refuses to load, so the plan holds the strictest of those rules.
|
|
294
|
+
*/
|
|
295
|
+
export const WEBSITE_IDENTIFIER_PATTERN_SOURCE = '[a-z][a-z0-9]*(?:-[a-z0-9]+)*';
|
|
296
|
+
|
|
297
|
+
/** A page slug's length limit: a menu ref's 48 characters, the strictest of the identifiers the slug becomes. */
|
|
298
|
+
export const WEBSITE_PAGE_SLUG_MAX_LENGTH = 48;
|
|
299
|
+
|
|
300
|
+
/**
|
|
301
|
+
* HOW a section is built: which of the website engine's blocks renders it (#2742 step 5c). The plan says what each
|
|
302
|
+
* section does ({@link WebsiteSectionKind}) and, here, which block does it, so a site's design is decided once in the
|
|
303
|
+
* plan and every section task builds the block it names rather than each choosing its own.
|
|
304
|
+
*
|
|
305
|
+
* A design decision, not a file: it names a block of the engine's vocabulary (`websiteHeroBlock`, `websiteCardGridBlock`
|
|
306
|
+
* … in `@wildo-ai/saas-website`), never a component, path or class the application writes. Mirrored from that package
|
|
307
|
+
* because this layer cannot depend on it; the companion's bridge map (`website<Name>Block` per member) is total over
|
|
308
|
+
* this enum and a companion test holds the two equal.
|
|
309
|
+
*/
|
|
310
|
+
export enum WebsiteSectionComponent {
|
|
311
|
+
/** The page's opening, `websiteHeroBlock`. */
|
|
312
|
+
HERO = 'HERO',
|
|
313
|
+
/** One capability argued beside a visual, `websiteFeatureRowBlock`. */
|
|
314
|
+
FEATURE_ROW = 'FEATURE_ROW',
|
|
315
|
+
/** Cards under the section intro, `websiteCardGridBlock`. */
|
|
316
|
+
CARD_GRID = 'CARD_GRID',
|
|
317
|
+
/** Tiles, each a small looping drawing and two lines, `websiteBentoBlock`. */
|
|
318
|
+
BENTO = 'BENTO',
|
|
319
|
+
/** The product in tabs, a drawn screen per tab, `websiteProductTourBlock`. */
|
|
320
|
+
PRODUCT_TOUR = 'PRODUCT_TOUR',
|
|
321
|
+
/** A list scrolling past, `websiteMarqueeBlock`. */
|
|
322
|
+
MARQUEE = 'MARQUEE',
|
|
323
|
+
/** How it works, in order, `websiteStepsBlock`. */
|
|
324
|
+
STEPS = 'STEPS',
|
|
325
|
+
/** Facts as figures, `websiteStatsBlock`. */
|
|
326
|
+
STATS = 'STATS',
|
|
327
|
+
/** Quotations, each with whose words and where, `websiteQuoteCardsBlock`. */
|
|
328
|
+
QUOTE_CARDS = 'QUOTE_CARDS',
|
|
329
|
+
/** The roadmap's phases, `websiteRoadmapBlock`. */
|
|
330
|
+
ROADMAP = 'ROADMAP',
|
|
331
|
+
/** One card per audience, each linking to its solution page, `websiteSolutionPathsBlock`. */
|
|
332
|
+
SOLUTION_PATHS = 'SOLUTION_PATHS',
|
|
333
|
+
/** The blog's newest posts, `websiteLatestPostsBlock`. */
|
|
334
|
+
LATEST_POSTS = 'LATEST_POSTS',
|
|
335
|
+
/** The product against the alternatives, `websiteComparisonTableBlock`. */
|
|
336
|
+
COMPARISON_TABLE = 'COMPARISON_TABLE',
|
|
337
|
+
/** Facts in rows, `websiteFactTableBlock`. */
|
|
338
|
+
FACT_TABLE = 'FACT_TABLE',
|
|
339
|
+
/** Questions and answers, `websiteFaqBlock`. */
|
|
340
|
+
FAQ = 'FAQ',
|
|
341
|
+
/** A call to action as a band of its own, `websiteCtaBandBlock`. */
|
|
342
|
+
CTA_BAND = 'CTA_BAND',
|
|
343
|
+
/** The plans and their prices, `WebsitePricing` (declared by hand: its words follow the catalogue). */
|
|
344
|
+
PRICING = 'PRICING',
|
|
345
|
+
/** A block of the site's own (`defineWebsiteBlock`), for a section no engine block covers. */
|
|
346
|
+
SITE_BLOCK = 'SITE_BLOCK',
|
|
347
|
+
}
|
|
348
|
+
|
|
349
|
+
/**
|
|
350
|
+
* The blocks that can build each section kind, the FIRST being the one a section gets when its plan names none. TOTAL
|
|
351
|
+
* over the kinds, so a kind added tomorrow does not compile until somebody says which blocks build it, and a section
|
|
352
|
+
* naming a block outside its kind's list is refused: a FAQ drawn as a card grid is not a FAQ the skill can build.
|
|
353
|
+
*
|
|
354
|
+
* Each list is what the kind's `website-section-<kind>` skill teaches, and nothing more: the section task is bound to
|
|
355
|
+
* that skill, so a block it does not teach is one the agent would build without guidance. `SITE_BLOCK` is listed only
|
|
356
|
+
* where the skill teaches a block of the site's own (a problem in one statement, area cards with moving drawings, a
|
|
357
|
+
* logo band, a contact layout); a comparison is never a fact table, which that skill files under the argument it
|
|
358
|
+
* supports instead.
|
|
359
|
+
*/
|
|
360
|
+
export const WEBSITE_SECTION_KIND_COMPONENTS: Readonly<Record<WebsiteSectionKind, readonly WebsiteSectionComponent[]>> = {
|
|
361
|
+
[WebsiteSectionKind.HERO]: [WebsiteSectionComponent.HERO],
|
|
362
|
+
[WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY]: [WebsiteSectionComponent.CARD_GRID, WebsiteSectionComponent.BENTO],
|
|
363
|
+
[WebsiteSectionKind.FEATURE_DETAIL]: [WebsiteSectionComponent.FEATURE_ROW, WebsiteSectionComponent.FACT_TABLE],
|
|
364
|
+
[WebsiteSectionKind.PRICING]: [WebsiteSectionComponent.PRICING],
|
|
365
|
+
[WebsiteSectionKind.SOCIAL_PROOF]: [WebsiteSectionComponent.QUOTE_CARDS, WebsiteSectionComponent.MARQUEE, WebsiteSectionComponent.SITE_BLOCK],
|
|
366
|
+
[WebsiteSectionKind.FAQ]: [WebsiteSectionComponent.FAQ],
|
|
367
|
+
[WebsiteSectionKind.CTA]: [WebsiteSectionComponent.CTA_BAND],
|
|
368
|
+
[WebsiteSectionKind.FOOTER_CTA]: [WebsiteSectionComponent.CTA_BAND],
|
|
369
|
+
// The form is the feature row's visual; a contact page laid out otherwise is a site block.
|
|
370
|
+
[WebsiteSectionKind.CONTACT]: [WebsiteSectionComponent.FEATURE_ROW, WebsiteSectionComponent.SITE_BLOCK],
|
|
371
|
+
[WebsiteSectionKind.PROBLEM]: [WebsiteSectionComponent.CARD_GRID, WebsiteSectionComponent.SITE_BLOCK],
|
|
372
|
+
[WebsiteSectionKind.HOW_IT_WORKS]: [WebsiteSectionComponent.STEPS],
|
|
373
|
+
[WebsiteSectionKind.PRODUCT_SHOWCASE]: [
|
|
374
|
+
WebsiteSectionComponent.PRODUCT_TOUR,
|
|
375
|
+
WebsiteSectionComponent.BENTO,
|
|
376
|
+
WebsiteSectionComponent.CARD_GRID,
|
|
377
|
+
WebsiteSectionComponent.SITE_BLOCK,
|
|
378
|
+
],
|
|
379
|
+
[WebsiteSectionKind.SOLUTION_PATHS]: [WebsiteSectionComponent.SOLUTION_PATHS],
|
|
380
|
+
[WebsiteSectionKind.COMPARISON]: [WebsiteSectionComponent.COMPARISON_TABLE],
|
|
381
|
+
[WebsiteSectionKind.STATS]: [WebsiteSectionComponent.STATS],
|
|
382
|
+
[WebsiteSectionKind.INTEGRATIONS]: [WebsiteSectionComponent.MARQUEE, WebsiteSectionComponent.CARD_GRID],
|
|
383
|
+
[WebsiteSectionKind.LATEST_POSTS]: [WebsiteSectionComponent.LATEST_POSTS],
|
|
384
|
+
[WebsiteSectionKind.ROADMAP]: [WebsiteSectionComponent.ROADMAP],
|
|
385
|
+
};
|
|
386
|
+
|
|
387
|
+
/** The block a section is built with: the one its plan names, else the first its kind allows. */
|
|
388
|
+
export function websiteSectionComponent(section: { readonly kind: WebsiteSectionKind; readonly component?: WebsiteSectionComponent | undefined }): WebsiteSectionComponent {
|
|
389
|
+
return section.component ?? (WEBSITE_SECTION_KIND_COMPONENTS[section.kind][0] as WebsiteSectionComponent);
|
|
390
|
+
}
|
|
391
|
+
|
|
392
|
+
/**
|
|
393
|
+
* A block's named layout, for the blocks that have one. Each member belongs to ONE component
|
|
394
|
+
* ({@link WEBSITE_SECTION_VARIANT_COMPONENT}), so a variant cannot be given to a block it does not shape. Mirrors the
|
|
395
|
+
* engine's layout vocabularies (`WebsiteHeroLayout`, `WebsiteFeatureRowLayout`, the card grid's columns and fit,
|
|
396
|
+
* `WebsiteStepsLayout`, `WebsiteFaqLayout`, `WebsitePricingLayout`).
|
|
397
|
+
*/
|
|
398
|
+
export enum WebsiteSectionVariant {
|
|
399
|
+
/** The visual below the copy, as the product's stage. */
|
|
400
|
+
HERO_STAGE = 'hero-stage',
|
|
401
|
+
/** The visual beside the copy. */
|
|
402
|
+
HERO_SPLIT = 'hero-split',
|
|
403
|
+
/** No visual: a compact opening. */
|
|
404
|
+
HERO_COMPACT = 'hero-compact',
|
|
405
|
+
/** The visual after the copy (to its right in a left-to-right page). */
|
|
406
|
+
FEATURE_ROW_VISUAL_END = 'feature-row-visual-end',
|
|
407
|
+
/** The visual before the copy, so consecutive rows zig-zag. */
|
|
408
|
+
FEATURE_ROW_VISUAL_START = 'feature-row-visual-start',
|
|
409
|
+
CARD_GRID_TWO_COLUMNS = 'card-grid-two-columns',
|
|
410
|
+
CARD_GRID_THREE_COLUMNS = 'card-grid-three-columns',
|
|
411
|
+
CARD_GRID_FOUR_COLUMNS = 'card-grid-four-columns',
|
|
412
|
+
/** As many columns as fit: right for a list whose length varies. */
|
|
413
|
+
CARD_GRID_FIT = 'card-grid-fit',
|
|
414
|
+
/** The steps side by side. */
|
|
415
|
+
STEPS_ROW = 'steps-row',
|
|
416
|
+
/** The steps one under another, each beside its drawing. */
|
|
417
|
+
STEPS_STACK = 'steps-stack',
|
|
418
|
+
/** The intro in a narrow column beside the questions. */
|
|
419
|
+
FAQ_SIDE = 'faq-side',
|
|
420
|
+
/** The intro above the questions. */
|
|
421
|
+
FAQ_STACKED = 'faq-stacked',
|
|
422
|
+
/** A summary of the plans, for a page that is not the pricing page. */
|
|
423
|
+
PRICING_TEASER = 'pricing-teaser',
|
|
424
|
+
/** The pricing page's plan cards. */
|
|
425
|
+
PRICING_PLANS = 'pricing-plans',
|
|
426
|
+
}
|
|
427
|
+
|
|
428
|
+
/** The component each variant shapes. Total, so a variant added without saying which block it shapes does not compile. */
|
|
429
|
+
export const WEBSITE_SECTION_VARIANT_COMPONENT: Readonly<Record<WebsiteSectionVariant, WebsiteSectionComponent>> = {
|
|
430
|
+
[WebsiteSectionVariant.HERO_STAGE]: WebsiteSectionComponent.HERO,
|
|
431
|
+
[WebsiteSectionVariant.HERO_SPLIT]: WebsiteSectionComponent.HERO,
|
|
432
|
+
[WebsiteSectionVariant.HERO_COMPACT]: WebsiteSectionComponent.HERO,
|
|
433
|
+
[WebsiteSectionVariant.FEATURE_ROW_VISUAL_END]: WebsiteSectionComponent.FEATURE_ROW,
|
|
434
|
+
[WebsiteSectionVariant.FEATURE_ROW_VISUAL_START]: WebsiteSectionComponent.FEATURE_ROW,
|
|
435
|
+
[WebsiteSectionVariant.CARD_GRID_TWO_COLUMNS]: WebsiteSectionComponent.CARD_GRID,
|
|
436
|
+
[WebsiteSectionVariant.CARD_GRID_THREE_COLUMNS]: WebsiteSectionComponent.CARD_GRID,
|
|
437
|
+
[WebsiteSectionVariant.CARD_GRID_FOUR_COLUMNS]: WebsiteSectionComponent.CARD_GRID,
|
|
438
|
+
[WebsiteSectionVariant.CARD_GRID_FIT]: WebsiteSectionComponent.CARD_GRID,
|
|
439
|
+
[WebsiteSectionVariant.STEPS_ROW]: WebsiteSectionComponent.STEPS,
|
|
440
|
+
[WebsiteSectionVariant.STEPS_STACK]: WebsiteSectionComponent.STEPS,
|
|
441
|
+
[WebsiteSectionVariant.FAQ_SIDE]: WebsiteSectionComponent.FAQ,
|
|
442
|
+
[WebsiteSectionVariant.FAQ_STACKED]: WebsiteSectionComponent.FAQ,
|
|
443
|
+
[WebsiteSectionVariant.PRICING_TEASER]: WebsiteSectionComponent.PRICING,
|
|
444
|
+
[WebsiteSectionVariant.PRICING_PLANS]: WebsiteSectionComponent.PRICING,
|
|
445
|
+
};
|
|
446
|
+
|
|
447
|
+
/**
|
|
448
|
+
* The surface a section stands on, mirroring the engine's `WebsiteSurfaceTone`. Absent: the build alternates the page's
|
|
449
|
+
* bands. The plan sets it where the surface carries meaning: the page's turning points on INVERSE, the one loudest band
|
|
450
|
+
* on BRAND.
|
|
451
|
+
*/
|
|
452
|
+
export enum WebsiteSectionTone {
|
|
453
|
+
/** The page's own background. */
|
|
454
|
+
DEFAULT = 'default',
|
|
455
|
+
/** A quiet tint: the alternating band. */
|
|
456
|
+
TINTED = 'tinted',
|
|
457
|
+
/** Dark on light: the page's turning points, the numbers, the closing call to action. */
|
|
458
|
+
INVERSE = 'inverse',
|
|
459
|
+
/** The brand's primary as the surface: the loudest band, once a page at most. */
|
|
460
|
+
BRAND = 'brand',
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
/**
|
|
464
|
+
* What a section's drawn product demo shows happening, mirroring the engine's `WebsiteDemoArchetype`: one of the nine
|
|
465
|
+
* shapes product demos take, each with a worked example the build's coding agent follows.
|
|
466
|
+
*/
|
|
467
|
+
export enum WebsiteSectionDemoArchetype {
|
|
468
|
+
/** Items arrive one by one: an activity stream, a log, an inbox. */
|
|
469
|
+
APPEND = 'append',
|
|
470
|
+
/** A proposed change waits for a person, who approves it. */
|
|
471
|
+
APPROVAL = 'approval',
|
|
472
|
+
/** A question is asked and answered from the product's own records. */
|
|
473
|
+
QUERY_ANSWER = 'query-answer',
|
|
474
|
+
/** Something arriving (an email, a file) becomes a record. */
|
|
475
|
+
TRANSFORM = 'transform',
|
|
476
|
+
/** Two parties or systems are linked, and something flows between them. */
|
|
477
|
+
CONNECT = 'connect',
|
|
478
|
+
/** Items on a list are completed. */
|
|
479
|
+
COMPLETE_ITEMS = 'complete-items',
|
|
480
|
+
/** One record moves through its statuses. */
|
|
481
|
+
STATUS_LIFECYCLE = 'status-lifecycle',
|
|
482
|
+
/** Figures and charts fill in. */
|
|
483
|
+
DASHBOARD = 'dashboard',
|
|
484
|
+
/** A goal is reached and marked. */
|
|
485
|
+
CELEBRATE = 'celebrate',
|
|
486
|
+
}
|
|
487
|
+
|
|
488
|
+
/**
|
|
489
|
+
* The components whose section may hold a drawing of the product, so a `demo` may say what it shows. A block of the
|
|
490
|
+
* site's own is among them: area cards with moving drawings are taught as one, and nothing in the plan can prove a site
|
|
491
|
+
* block holds no drawing, so refusing its demo would refuse a true plan.
|
|
492
|
+
*/
|
|
493
|
+
export const WEBSITE_SECTION_COMPONENTS_WITH_DEMO: readonly WebsiteSectionComponent[] = [
|
|
494
|
+
WebsiteSectionComponent.HERO,
|
|
495
|
+
WebsiteSectionComponent.FEATURE_ROW,
|
|
496
|
+
WebsiteSectionComponent.PRODUCT_TOUR,
|
|
497
|
+
WebsiteSectionComponent.BENTO,
|
|
498
|
+
WebsiteSectionComponent.SITE_BLOCK,
|
|
499
|
+
];
|
|
500
|
+
|
|
501
|
+
/** A section ref's length limit: the website's `WebsiteSectionRef`. */
|
|
502
|
+
export const WEBSITE_SECTION_REF_MAX_LENGTH = 64;
|
|
503
|
+
|
|
504
|
+
const SlugSchema = z.string().max(WEBSITE_SECTION_REF_MAX_LENGTH).regex(new RegExp(`^${WEBSITE_IDENTIFIER_PATTERN_SOURCE}$`));
|
|
147
505
|
const NonEmptyStringSchema = z.string().trim().min(1);
|
|
148
506
|
|
|
149
507
|
/** One section of one page. */
|
|
150
508
|
export const WebsiteSectionPlanSchema = z.strictObject({
|
|
151
|
-
/** Unique
|
|
509
|
+
/** Unique across the site (named after its page when two pages would share it); the section's id in `website/src/sections/<pageRef>.sections.tsx`. */
|
|
152
510
|
sectionRef: SlugSchema,
|
|
153
511
|
kind: z.enum(WebsiteSectionKind).systemEnum('WebsiteSectionKind'),
|
|
154
512
|
/** What this section has to do for the reader, in one sentence. */
|
|
@@ -163,13 +521,100 @@ export const WebsiteSectionPlanSchema = z.strictObject({
|
|
|
163
521
|
* vision's own one-liner — but the judge reads it.
|
|
164
522
|
*/
|
|
165
523
|
drawsOnRefs: z.array(NonEmptyStringSchema).default([]),
|
|
524
|
+
/**
|
|
525
|
+
* The requirements this section's CAPABILITY claims rest on, by their refs (#2507): functional or non-functional.
|
|
526
|
+
* A citation, named like `valuePillars[].backedByBenefitRefs`, not a delivery like a roadmap phase's field.
|
|
527
|
+
*
|
|
528
|
+
* A market benefit says what a buyer wants; it does not say the product does it. One generated site promised
|
|
529
|
+
* "country workflow guidance with its limits stated", drawn from a market benefit, while the product shipped an
|
|
530
|
+
* empty place for an administrator to write guidance. A section that says the product DOES something cites the
|
|
531
|
+
* requirement behind it. The citation is necessary, not sufficient: a requirement is a commitment, so when the
|
|
532
|
+
* section is built its author is told whether the tasks serving each cited requirement have landed, whether a run
|
|
533
|
+
* reported it still unmet, and which roadmap phase delivers it. Only what has been delivered is described as
|
|
534
|
+
* available; the rest is described as planned.
|
|
535
|
+
*
|
|
536
|
+
* Reported when empty on a kind whose job is to say what the product does ({@link WEBSITE_SECTION_KIND_CLAIMS_CAPABILITY},
|
|
537
|
+
* `CAPABILITY_CLAIM_UNBACKED`). Any other kind may cite requirements too, and one that cites none describes no capability
|
|
538
|
+
* as available.
|
|
539
|
+
*/
|
|
540
|
+
backedByRequirementRefs: z.array(NonEmptyStringSchema).default([]),
|
|
541
|
+
/** The block that builds it, among those its kind allows ({@link WEBSITE_SECTION_KIND_COMPONENTS}); absent: the kind's first. */
|
|
542
|
+
component: z.enum(WebsiteSectionComponent).systemEnum('WebsiteSectionComponent').optional(),
|
|
543
|
+
/** The block's layout, when it has named ones; it must shape the section's component. */
|
|
544
|
+
variant: z.enum(WebsiteSectionVariant).systemEnum('WebsiteSectionVariant').optional(),
|
|
545
|
+
/** The surface it stands on; absent: the build alternates the page's bands. */
|
|
546
|
+
tone: z.enum(WebsiteSectionTone).systemEnum('WebsiteSectionTone').optional(),
|
|
547
|
+
/**
|
|
548
|
+
* What its drawing of the product shows happening, for a component that holds one
|
|
549
|
+
* ({@link WEBSITE_SECTION_COMPONENTS_WITH_DEMO}): the archetype, the resource it is drawn from (its ref in the domain
|
|
550
|
+
* plan, the form the build plan's `resourceRef` takes, so the build binds the drawing to that resource's real fields
|
|
551
|
+
* and values), and the moment in one sentence. The demo shows what the product does, so a showcase or feature detail
|
|
552
|
+
* without one is reported, and a `resourceRef` the domain plan does not declare is noted by the definition coherence
|
|
553
|
+
* check.
|
|
554
|
+
*/
|
|
555
|
+
demo: z
|
|
556
|
+
.strictObject({
|
|
557
|
+
archetype: z.enum(WebsiteSectionDemoArchetype).systemEnum('WebsiteSectionDemoArchetype'),
|
|
558
|
+
resourceRef: SlugSchema.optional(),
|
|
559
|
+
moment: NonEmptyStringSchema,
|
|
560
|
+
})
|
|
561
|
+
.optional(),
|
|
166
562
|
});
|
|
167
563
|
export type WebsiteSectionPlan = z.infer<typeof WebsiteSectionPlanSchema>;
|
|
168
564
|
|
|
565
|
+
/**
|
|
566
|
+
* Whether a section kind's job is to say what the product DOES (#2507): such a section is reported when it cites no
|
|
567
|
+
* requirement (`CAPABILITY_CLAIM_UNBACKED`), and its author is told it has nothing behind it. The build-time boundary
|
|
568
|
+
* binds every kind alike: a hero, a pricing table or an FAQ answer describes as available only what its own citations
|
|
569
|
+
* back. This table decides only which kinds are expected to cite.
|
|
570
|
+
*
|
|
571
|
+
* Total over the vocabulary, so a kind added tomorrow does not compile until somebody says whether it makes a claim. A
|
|
572
|
+
* list of the two feature kinds missed the showcase, how-it-works, comparison and integrations sections the page kinds
|
|
573
|
+
* added (2026-10-05), each of which says what the product does.
|
|
574
|
+
*/
|
|
575
|
+
export const WEBSITE_SECTION_KIND_CLAIMS_CAPABILITY: Readonly<Record<WebsiteSectionKind, boolean>> = {
|
|
576
|
+
// The page's promise. Its claim is the one the sections below it argue and cite.
|
|
577
|
+
[WebsiteSectionKind.HERO]: false,
|
|
578
|
+
[WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY]: true,
|
|
579
|
+
[WebsiteSectionKind.FEATURE_DETAIL]: true,
|
|
580
|
+
// The plans as the business model declares them.
|
|
581
|
+
[WebsiteSectionKind.PRICING]: false,
|
|
582
|
+
// Proof the market snapshot authored, not a statement of what the product does.
|
|
583
|
+
[WebsiteSectionKind.SOCIAL_PROOF]: false,
|
|
584
|
+
[WebsiteSectionKind.FAQ]: false,
|
|
585
|
+
[WebsiteSectionKind.CTA]: false,
|
|
586
|
+
[WebsiteSectionKind.FOOTER_CTA]: false,
|
|
587
|
+
[WebsiteSectionKind.CONTACT]: false,
|
|
588
|
+
// The audience's problem, told before any product appears.
|
|
589
|
+
[WebsiteSectionKind.PROBLEM]: false,
|
|
590
|
+
// What the product does at each step.
|
|
591
|
+
[WebsiteSectionKind.HOW_IT_WORKS]: true,
|
|
592
|
+
// The product's own screens: what they show is what it does.
|
|
593
|
+
[WebsiteSectionKind.PRODUCT_SHOWCASE]: true,
|
|
594
|
+
// Navigation, not argument: each card names an audience and links to the SOLUTION page that makes the case.
|
|
595
|
+
[WebsiteSectionKind.SOLUTION_PATHS]: false,
|
|
596
|
+
// The product against its alternatives, which says what it does better.
|
|
597
|
+
[WebsiteSectionKind.COMPARISON]: true,
|
|
598
|
+
// Figures the application declares (a retention period, a region), facts rather than capabilities.
|
|
599
|
+
[WebsiteSectionKind.STATS]: false,
|
|
600
|
+
// What each connection does. The integration plan says a provider is declared; a requirement says the build delivers it.
|
|
601
|
+
[WebsiteSectionKind.INTEGRATIONS]: true,
|
|
602
|
+
[WebsiteSectionKind.LATEST_POSTS]: false,
|
|
603
|
+
// Phases as the roadmap declares them, with nothing unbuilt presented as available.
|
|
604
|
+
[WebsiteSectionKind.ROADMAP]: false,
|
|
605
|
+
};
|
|
606
|
+
|
|
169
607
|
/** One page of the marketing site. */
|
|
170
608
|
export const WebsitePagePlanSchema = z.strictObject({
|
|
171
609
|
/** `page-<slug>`, stamped by the trusted runtime; the route and the sections file are named from it. */
|
|
172
|
-
pageRef: z
|
|
610
|
+
pageRef: z
|
|
611
|
+
.string()
|
|
612
|
+
.max(WEBSITE_PAGE_REF_PREFIX.length + WEBSITE_PAGE_SLUG_MAX_LENGTH)
|
|
613
|
+
.regex(new RegExp(`^${WEBSITE_PAGE_REF_PREFIX}${WEBSITE_IDENTIFIER_PATTERN_SOURCE}$`)),
|
|
614
|
+
/** What kind of page this is; decides its route, its menu placement and its essential sections. */
|
|
615
|
+
kind: z.enum(WebsitePageKind).systemEnum('WebsitePageKind'),
|
|
616
|
+
/** How a SOLUTION page cuts its audience. Required on a SOLUTION page, refused on any other. */
|
|
617
|
+
solutionAxis: z.enum(WebsiteSolutionAxis).systemEnum('WebsiteSolutionAxis').optional(),
|
|
173
618
|
/** What this page is for — the question a visitor arrives with. */
|
|
174
619
|
purpose: NonEmptyStringSchema,
|
|
175
620
|
/**
|
|
@@ -184,9 +629,37 @@ export const WebsitePagePlanSchema = z.strictObject({
|
|
|
184
629
|
* the same vacuity rule the build plan's `tasks` and the requirements' `functional` carry.
|
|
185
630
|
*/
|
|
186
631
|
sections: z.array(WebsiteSectionPlanSchema).min(1),
|
|
632
|
+
/**
|
|
633
|
+
* The section a visitor remembers the page by, one of its own (#2742): the one the build gives the most care and the
|
|
634
|
+
* richest drawing. Its surface is its own `tone`, like any section's. Absent: no section is singled out.
|
|
635
|
+
*/
|
|
636
|
+
signatureSectionRef: SlugSchema.optional(),
|
|
187
637
|
});
|
|
188
638
|
export type WebsitePagePlan = z.infer<typeof WebsitePagePlanSchema>;
|
|
189
639
|
|
|
640
|
+
/**
|
|
641
|
+
* The ways a section's design fields would make the plan FALSE, each refused: a block its kind cannot be built with, a
|
|
642
|
+
* layout of another block, a demo on a block that holds no drawing. One function, read by the stored plan's refinement,
|
|
643
|
+
* which the generation contract's normalizer parses its output through, so the model is held to what the plan is.
|
|
644
|
+
*/
|
|
645
|
+
export function websiteSectionDesignIssues(
|
|
646
|
+
section: Pick<WebsiteSectionPlan, 'kind' | 'component' | 'variant' | 'demo'>,
|
|
647
|
+
): readonly { readonly field: 'component' | 'variant' | 'demo'; readonly message: string }[] {
|
|
648
|
+
const issues: { field: 'component' | 'variant' | 'demo'; message: string }[] = [];
|
|
649
|
+
const allowed = WEBSITE_SECTION_KIND_COMPONENTS[section.kind];
|
|
650
|
+
if (section.component !== undefined && !allowed.includes(section.component)) {
|
|
651
|
+
issues.push({ field: 'component', message: `a ${section.kind} section is built with ${allowed.join(' / ')}, not ${section.component}` });
|
|
652
|
+
}
|
|
653
|
+
const component = websiteSectionComponent(section);
|
|
654
|
+
if (section.variant !== undefined && WEBSITE_SECTION_VARIANT_COMPONENT[section.variant] !== component) {
|
|
655
|
+
issues.push({ field: 'variant', message: `the variant ${section.variant} shapes a ${WEBSITE_SECTION_VARIANT_COMPONENT[section.variant]}, and this section is a ${component}` });
|
|
656
|
+
}
|
|
657
|
+
if (section.demo !== undefined && !WEBSITE_SECTION_COMPONENTS_WITH_DEMO.includes(component)) {
|
|
658
|
+
issues.push({ field: 'demo', message: `a ${component} holds no drawing of the product, so it has no demo (${WEBSITE_SECTION_COMPONENTS_WITH_DEMO.join(' / ')} do)` });
|
|
659
|
+
}
|
|
660
|
+
return issues;
|
|
661
|
+
}
|
|
662
|
+
|
|
190
663
|
/**
|
|
191
664
|
* THE website-plan payload.
|
|
192
665
|
*
|
|
@@ -215,24 +688,89 @@ export const WebsitePlanSchema = z.object({
|
|
|
215
688
|
context.addIssue({ code: 'custom', message: 'a PLANNED website plan must carry at least one page; planning no page is a refusal, not a plan', path: ['pages'] });
|
|
216
689
|
}
|
|
217
690
|
const pageRefs = new Set<string>();
|
|
691
|
+
const routes = new Map<string, string>();
|
|
218
692
|
plan.pages.forEach((page, pageIndex) => {
|
|
219
693
|
if (pageRefs.has(page.pageRef)) {
|
|
220
694
|
context.addIssue({ code: 'custom', message: `duplicate page ref "${page.pageRef}"`, path: ['pages', pageIndex, 'pageRef'] });
|
|
221
695
|
}
|
|
222
696
|
pageRefs.add(page.pageRef);
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
697
|
+
// Two pages on one route: a second HOME, PRICING, … or two PRODUCT pages with one slug. The build could
|
|
698
|
+
// only mount one of them, so the plan is not one a site can be built from.
|
|
699
|
+
const route = websitePageRoutePath(page);
|
|
700
|
+
const holder = routes.get(route);
|
|
701
|
+
if (holder !== undefined) {
|
|
702
|
+
context.addIssue({ code: 'custom', message: `pages "${holder}" and "${page.pageRef}" both derive the route "${route}"`, path: ['pages', pageIndex, 'kind'] });
|
|
703
|
+
}
|
|
704
|
+
routes.set(route, page.pageRef);
|
|
705
|
+
if (page.kind === WebsitePageKind.HOME && page.pageRef !== WEBSITE_HOME_PAGE_REF) {
|
|
706
|
+
context.addIssue({
|
|
707
|
+
code: 'custom',
|
|
708
|
+
message: `the HOME page's ref is "${WEBSITE_HOME_PAGE_REF}" — the scaffold's starter page at "/", which the home page grows rather than replaces; got "${page.pageRef}"`,
|
|
709
|
+
path: ['pages', pageIndex, 'pageRef'],
|
|
710
|
+
});
|
|
711
|
+
}
|
|
712
|
+
if (page.kind === WebsitePageKind.SOLUTION && page.solutionAxis === undefined) {
|
|
713
|
+
context.addIssue({ code: 'custom', message: `SOLUTION page "${page.pageRef}" names no solutionAxis, so it has no column under Solutions`, path: ['pages', pageIndex, 'solutionAxis'] });
|
|
714
|
+
}
|
|
715
|
+
if (page.kind !== WebsitePageKind.SOLUTION && page.solutionAxis !== undefined) {
|
|
716
|
+
context.addIssue({ code: 'custom', message: `page "${page.pageRef}" is ${page.kind}; only a SOLUTION page carries a solutionAxis`, path: ['pages', pageIndex, 'solutionAxis'] });
|
|
717
|
+
}
|
|
228
718
|
const sectionRefs = new Set<string>();
|
|
229
719
|
page.sections.forEach((section, sectionIndex) => {
|
|
230
720
|
if (sectionRefs.has(section.sectionRef)) {
|
|
231
721
|
context.addIssue({ code: 'custom', message: `page "${page.pageRef}" declares the section "${section.sectionRef}" twice`, path: ['pages', pageIndex, 'sections', sectionIndex, 'sectionRef'] });
|
|
232
722
|
}
|
|
233
723
|
sectionRefs.add(section.sectionRef);
|
|
724
|
+
for (const issue of websiteSectionDesignIssues(section)) {
|
|
725
|
+
context.addIssue({ code: 'custom', message: `section "${section.sectionRef}" on "${page.pageRef}": ${issue.message}`, path: ['pages', pageIndex, 'sections', sectionIndex, issue.field] });
|
|
726
|
+
}
|
|
727
|
+
});
|
|
728
|
+
if (page.signatureSectionRef !== undefined && !sectionRefs.has(page.signatureSectionRef)) {
|
|
729
|
+
context.addIssue({
|
|
730
|
+
code: 'custom',
|
|
731
|
+
message: `page "${page.pageRef}" names "${page.signatureSectionRef}" as its signature section, which is not one of its sections`,
|
|
732
|
+
path: ['pages', pageIndex, 'signatureSectionRef'],
|
|
733
|
+
});
|
|
734
|
+
}
|
|
735
|
+
});
|
|
736
|
+
/*
|
|
737
|
+
* Section refs are unique across the SITE, not only within a page. The build collects every section by its ref
|
|
738
|
+
* (`collectExpectedLabelKeysFromSections`), and two sections sharing one carry different label keys (each rooted at
|
|
739
|
+
* its own page), so the site fails to build. A ref therefore names its page when two pages would share one
|
|
740
|
+
* (`landing-hero`, `pricing-hero`) — most pages open on a HERO (the plan warns when one does not), so this is the common
|
|
741
|
+
* case, not an edge.
|
|
742
|
+
*/
|
|
743
|
+
const pageOfSectionRef = new Map<string, string>();
|
|
744
|
+
plan.pages.forEach((page, pageIndex) => {
|
|
745
|
+
page.sections.forEach((section, sectionIndex) => {
|
|
746
|
+
const firstPage = pageOfSectionRef.get(section.sectionRef);
|
|
747
|
+
if (firstPage !== undefined && firstPage !== page.pageRef) {
|
|
748
|
+
context.addIssue({
|
|
749
|
+
code: 'custom',
|
|
750
|
+
message: `the section "${section.sectionRef}" is declared on pages "${firstPage}" and "${page.pageRef}"; a section ref names one section of the site, so name each after its page (e.g. "${page.pageRef.replace(WEBSITE_PAGE_REF_PREFIX, '')}-${section.sectionRef}")`,
|
|
751
|
+
path: ['pages', pageIndex, 'sections', sectionIndex, 'sectionRef'],
|
|
752
|
+
});
|
|
753
|
+
}
|
|
754
|
+
if (firstPage === undefined) pageOfSectionRef.set(section.sectionRef, page.pageRef);
|
|
234
755
|
});
|
|
235
756
|
});
|
|
757
|
+
/*
|
|
758
|
+
* A latest-posts list reads the blog's posts, and the posts live in the content collection the BLOG page's task
|
|
759
|
+
* sets up. A plan that lists posts and has no blog asks for a section nothing can fill.
|
|
760
|
+
*/
|
|
761
|
+
if (!plan.pages.some((page) => page.kind === WebsitePageKind.BLOG)) {
|
|
762
|
+
plan.pages.forEach((page, pageIndex) => {
|
|
763
|
+
page.sections.forEach((section, sectionIndex) => {
|
|
764
|
+
if (section.kind === WebsiteSectionKind.LATEST_POSTS) {
|
|
765
|
+
context.addIssue({
|
|
766
|
+
code: 'custom',
|
|
767
|
+
message: `page "${page.pageRef}" lists the latest posts, and the plan has no BLOG page to hold them`,
|
|
768
|
+
path: ['pages', pageIndex, 'sections', sectionIndex, 'kind'],
|
|
769
|
+
});
|
|
770
|
+
}
|
|
771
|
+
});
|
|
772
|
+
});
|
|
773
|
+
}
|
|
236
774
|
});
|
|
237
775
|
export type WebsitePlan = z.infer<typeof WebsitePlanSchema>;
|
|
238
776
|
```
|