@wildo-ai/framework-knowledge 1.1.9 → 1.1.10
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/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 +84 -4
- package/dist/esm/framework-knowledge.definitions.js.map +1 -1
- package/dist/esm/framework-knowledge.loader.d.ts.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js +1 -1
- package/dist/esm/playbooks/bottom_up.assemble-verify/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/bottom_up.build/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.build-decompose/playbook.definition.d.ts +39 -1
- 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 +132 -20
- 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.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts +8 -4
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/bottom_up.conception/playbook.definition.js +13 -6
- 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 +85 -8
- 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 +4 -3
- 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 +4 -3
- package/dist/esm/playbooks/bottom_up.experience-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 +4 -1
- 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 +2 -1
- package/dist/esm/playbooks/bottom_up.website-plan/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/cross_cutting.application-creation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.compliance/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.feature-development/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/cross_cutting.refinement/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.compliance-document-candidate/playbook.definition.d.ts.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 +13 -1
- package/dist/esm/playbooks/refinement.document-facts/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/refinement.feature-contribution/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/refinement.governance-document-candidate/playbook.definition.d.ts.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 +10 -4
- 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.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.capability-map/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-conception/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-posture/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.compliance-research/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.definition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.d.ts +27 -6
- 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 +32 -12
- package/dist/esm/playbooks/top_down.expert-personas/playbook.definition.js.map +1 -1
- package/dist/esm/playbooks/top_down.feature-drafts/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-analysis/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-evidence-adequacy/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.market-research/playbook.definition.d.ts.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 +13 -5
- 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.risk-register/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.scope-roadmap/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.value-proposition/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.d.ts.map +1 -1
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js +11 -0
- package/dist/esm/playbooks/top_down.vision-elicitation/playbook.definition.js.map +1 -1
- package/dist/knowledge/assurance-authority-bases/wildo-safe-baseline-v1/external-framework-mapping.json +1 -1
- package/dist/knowledge/manifest.json +7 -7
- package/dist/knowledge/playbooks/bottom_up.assemble-verify/playbook.json +1 -1
- 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 +149 -11
- package/dist/knowledge/playbooks/bottom_up.build-decompose/playbook.json +40 -2
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/method.md +55 -0
- package/dist/knowledge/playbooks/bottom_up.build-dispatch/playbook.json +1 -1
- package/dist/knowledge/playbooks/bottom_up.conception/playbook.json +10 -2
- 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 +107 -11
- package/dist/knowledge/playbooks/bottom_up.domain-plan/playbook.json +4 -2
- package/dist/knowledge/playbooks/bottom_up.experience-plan/method.md +28 -6
- package/dist/knowledge/playbooks/bottom_up.experience-plan/playbook.json +5 -4
- package/dist/knowledge/playbooks/bottom_up.placement-plan/method.md +50 -0
- package/dist/knowledge/playbooks/bottom_up.placement-plan/playbook.json +16 -4
- package/dist/knowledge/playbooks/bottom_up.website-plan/method.md +19 -0
- package/dist/knowledge/playbooks/bottom_up.website-plan/playbook.json +5 -2
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/method.md +2 -1
- package/dist/knowledge/playbooks/refinement.compliance-document-candidate/playbook.json +1 -1
- package/dist/knowledge/playbooks/refinement.document-facts/method.md +8 -0
- package/dist/knowledge/playbooks/refinement.document-facts/playbook.json +3 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/method.md +5 -2
- package/dist/knowledge/playbooks/refinement.feature-contribution/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 +7 -3
- 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.capability-map/method.md +10 -9
- package/dist/knowledge/playbooks/top_down.capability-map/playbook.json +1 -1
- package/dist/knowledge/playbooks/top_down.expert-personas/playbook.json +16 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/method.md +5 -2
- package/dist/knowledge/playbooks/top_down.feature-drafts/playbook.json +1 -1
- 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 +4 -2
- 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.vision-elicitation/method.md +19 -0
- package/dist/knowledge/playbooks/top_down.vision-elicitation/playbook.json +19 -1
- 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/build-plan.task-graph.config.md +55 -0
- package/dist/knowledge/references/companion.market.prompt-renderer.md +11 -6
- package/dist/knowledge/references/example.authorization.application-roles.office-and-field.md +44 -0
- 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 +258 -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 +107 -0
- 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.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.filter-presets.md +15 -0
- package/dist/knowledge/references/example.resource.ui-behavior.operation-icon.md +8 -0
- 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/experience-plan.config.md +60 -7
- package/dist/knowledge/references/market.context-block.builder.md +1 -1
- package/dist/knowledge/references/placement-plan.config.md +43 -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/saas.backend.audit-logs.log-event.md +63 -0
- 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.email.send.md +77 -0
- package/dist/knowledge/references/saas.backend.notifications.operation-email-template-ref.md +60 -0
- 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.frontend.collection-filter-presets.md +124 -0
- package/dist/knowledge/references/saas.frontend.launcher.item-refs.md +316 -0
- package/dist/knowledge/references/saas.frontend.launcher.merge-rules.md +106 -0
- package/dist/knowledge/references/saas.frontend.launcher.runtime-availability.md +60 -0
- package/dist/knowledge/references/saas.frontend.resource-label-params.md +52 -0
- package/dist/knowledge/references/saas.frontend.resource-operation-frontend-config.md +47 -18
- package/dist/knowledge/references/saas.frontend.resource-ui-behavior-config.md +4 -1
- package/dist/knowledge/references/saas.frontend.settings-hub.engine-destination-roles.md +25 -0
- package/dist/knowledge/references/saas.frontend.settings-hub.placement.md +2 -2
- package/dist/knowledge/references/saas.models.audit.trail-config.md +45 -0
- package/dist/knowledge/references/saas.models.notifications.user-notification-definition.md +5 -3
- package/dist/knowledge/references/saas.models.resource-config.builder-parameters.md +26 -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.public-runtime.contract.md +26 -0
- package/dist/knowledge/references/saas.website.astro.bridge.md +10 -0
- package/dist/knowledge/references/saas.website.astro.label-loader.md +3 -0
- package/dist/knowledge/references/saas.website.astro.llms-txt-server.md +14 -1
- package/dist/knowledge/references/saas.website.astro.site-context.md +13 -0
- package/dist/knowledge/references/saas.website.blog.bridge.md +4 -0
- package/dist/knowledge/references/saas.website.config.site-context-loader.md +3 -0
- package/dist/knowledge/references/saas.website.legal.public-document-links.md +76 -0
- package/dist/knowledge/references/saas.website.root-config.seo.md +2 -1
- package/dist/knowledge/references/saas.website.runtime.context.md +7 -0
- package/dist/knowledge/references/saas.website.seo.llms-txt-config.md +2 -0
- package/dist/knowledge/references/website-plan.config.md +26 -0
- package/dist/knowledge/references/zod.decorators.chainable-runtime.md +13 -0
- package/dist/knowledge/references/zod.decorators.decorator-vocabulary.md +7 -0
- package/dist/knowledge/references/zod.decorators.document-sequence.md +65 -0
- package/dist/knowledge/references/zod.decorators.schema-metadata.md +1 -0
- package/dist/knowledge/references/zod.decorators.shared-structural-methods.md +21 -0
- package/dist/knowledge/references/zod.factories.bigdecimal.md +1 -0
- package/dist/knowledge/references/zod.factories.code.md +1 -0
- package/dist/knowledge/references/zod.factories.duration.md +1 -0
- package/dist/knowledge/references/zod.factories.money.md +1 -0
- package/dist/knowledge/registries/assurance-authority-bases.json +1 -1
- package/dist/knowledge/registries/framework-topics.json +337 -1
- package/dist/knowledge/registries/playbooks.json +18 -18
- package/dist/knowledge/registries/source-tags.json +1435 -873
- package/dist/knowledge/rules/live-context-door.md +1 -1
- package/dist/knowledge/skills/INDEX.md +3 -1
- package/dist/knowledge/skills/application-consumer-documentation-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/application-database-migrations/SKILL.md +14 -3
- 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 +6 -1
- package/dist/knowledge/skills/backend-custom-operation/SKILL.md +256 -9
- package/dist/knowledge/skills/backend-custom-operation/references/after-the-operation.md +42 -0
- package/dist/knowledge/skills/backend-custom-operation/references/framework-audit-log-event-api.md +220 -0
- package/dist/knowledge/skills/brand-logo-authoring/SKILL.md +5 -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/compliance-document-authoring/references/document-composition-privacy-notice.md +2 -1
- package/dist/knowledge/skills/config-app-shell/SKILL.md +58 -5
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-items-api.md +461 -0
- package/dist/knowledge/skills/config-app-shell/references/framework-launcher-visibility-api.md +80 -0
- package/dist/knowledge/skills/config-design-system/SKILL.md +28 -6
- package/dist/knowledge/skills/config-navigation/SKILL.md +14 -3
- package/dist/knowledge/skills/config-saas/SKILL.md +25 -11
- package/dist/knowledge/skills/config-saas/references/compliance-declarations.md +51 -1
- package/dist/knowledge/skills/config-saas/references/framework-audit-trail-config-api.md +62 -2
- package/dist/knowledge/skills/config-saas-backend/SKILL.md +6 -1
- package/dist/knowledge/skills/configure-billing/SKILL.md +18 -4
- package/dist/knowledge/skills/email-add-template/SKILL.md +27 -5
- 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 +128 -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/flows-actors-chat-assistant/SKILL.md +10 -2
- package/dist/knowledge/skills/flows-actors-llm-agent-invocation/SKILL.md +18 -4
- package/dist/knowledge/skills/frontend-component-catalog/SKILL.md +11 -3
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md +2 -1
- package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md +8 -0
- package/dist/knowledge/skills/i18n-rerun-pipeline/SKILL.md +18 -4
- package/dist/knowledge/skills/i18n-translation-rerun/SKILL.md +10 -2
- package/dist/knowledge/skills/infra-environment-config/SKILL.md +6 -1
- package/dist/knowledge/skills/local-environment-bootstrap/SKILL.md +6 -1
- 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-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 +11 -3
- package/dist/knowledge/skills/market-companion-prompt-enrichment/references/framework-companion-behavior-api.md +1 -1
- package/dist/knowledge/skills/market-generation-cli/SKILL.md +21 -11
- package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md +11 -6
- 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/model-cost-attribution/references/framework-work-unit-api.md +26 -0
- package/dist/knowledge/skills/module-companion-exports/SKILL.md +7 -1
- package/dist/knowledge/skills/module-relationships/SKILL.md +31 -4
- package/dist/knowledge/skills/pdf-template-authoring/SKILL.md +4 -2
- package/dist/knowledge/skills/provider-address-lookup/SKILL.md +14 -3
- package/dist/knowledge/skills/provider-frontend-file-picker/SKILL.md +6 -1
- package/dist/knowledge/skills/provider-operation-calls/SKILL.md +14 -3
- package/dist/knowledge/skills/rate-limit-authoring/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-add-field/references/framework-field-cross-layer-api.md +46 -17
- package/dist/knowledge/skills/resource-add-resource/SKILL.md +14 -2
- package/dist/knowledge/skills/resource-add-resource/references/framework-new-resource-core-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/SKILL.md +29 -3
- package/dist/knowledge/skills/resource-config-wiring/references/framework-collection-operation-declarations.md +19 -4
- package/dist/knowledge/skills/resource-config-wiring/references/framework-operation-audit-api.md +5 -2
- package/dist/knowledge/skills/resource-config-wiring/references/framework-personal-data-declaration-api.md +103 -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-resource-config-api.md +26 -0
- package/dist/knowledge/skills/resource-config-wiring/references/framework-user-notifications-api.md +26 -7
- package/dist/knowledge/skills/resource-custom-view/SKILL.md +10 -2
- package/dist/knowledge/skills/resource-custom-view/references/custom-view-contracts.md +46 -17
- package/dist/knowledge/skills/resource-external-data/references/erasure-suppression.md +2 -2
- package/dist/knowledge/skills/resource-retention-binding/SKILL.md +5 -1
- package/dist/knowledge/skills/resource-schema-authoring/SKILL.md +15 -1
- package/dist/knowledge/skills/resource-schema-authoring/references/computed-totals.md +569 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/document-numbers.md +358 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-decorator-vocabulary-api.md +8 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-shared-decorator-methods-api.md +21 -0
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-special-factories-api.md +7 -2
- package/dist/knowledge/skills/resource-schema-authoring/references/framework-zod-lifecycle-and-chainable-api.md +13 -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 +30 -4
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-collection-filter-presets-api.md +157 -0
- package/dist/knowledge/skills/resource-ui-behavior/references/framework-frontend-resource-ui-contracts-api.md +101 -19
- 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/framework-data-seeding-api.md +148 -4
- package/dist/knowledge/skills/seeding-authoring/references/seed-row-overlay.md +22 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-destinations-catalog.md +43 -0
- package/dist/knowledge/skills/settings-placement-authoring/references/framework-settings-placement-api.md +2 -2
- package/dist/knowledge/skills/spec-companion-exports/SKILL.md +6 -1
- package/dist/knowledge/skills/spec-component-update/SKILL.md +10 -2
- package/dist/knowledge/skills/spec-composite-view-update/SKILL.md +2 -2
- 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/resource-spec-field-routing.md +28 -0
- package/dist/knowledge/skills/spec-update-after-change/SKILL.md +22 -5
- package/dist/knowledge/skills/views-add-composite-view/SKILL.md +6 -1
- package/dist/knowledge/skills/views-add-custom-view/SKILL.md +10 -2
- 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 +221 -37
- package/dist/knowledge/skills/views-composite-authoring/SKILL.md +22 -5
- package/dist/knowledge/skills/views-execution-authoring/SKILL.md +1 -1
- package/dist/knowledge/skills/website-anonymous-session/SKILL.md +32 -2
- package/dist/knowledge/skills/website-blog-authoring/SKILL.md +16 -3
- package/dist/knowledge/skills/website-blog-authoring/references/blog-adapter-api.md +4 -0
- package/dist/knowledge/skills/website-bundle-discipline/SKILL.md +7 -1
- package/dist/knowledge/skills/website-consent-gate-overrides/SKILL.md +13 -1
- package/dist/knowledge/skills/website-factory-advanced/SKILL.md +10 -2
- package/dist/knowledge/skills/website-inbound-contact-forms/SKILL.md +13 -1
- package/dist/knowledge/skills/website-layout-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-marketing-metadata-extension/SKILL.md +19 -1
- package/dist/knowledge/skills/website-navigation-authoring/SKILL.md +55 -18
- package/dist/knowledge/skills/website-navigation-authoring/references/framework-public-document-links-api.md +98 -0
- package/dist/knowledge/skills/website-navigation-authoring/references/worked-examples-header-footer.md +8 -11
- package/dist/knowledge/skills/website-page-authoring/SKILL.md +16 -5
- package/dist/knowledge/skills/website-page-authoring/references/framework-site-context-loader-api.md +3 -0
- package/dist/knowledge/skills/website-primitive-overrides/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-faq/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-feature-benefit-summary/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-feature-detail/SKILL.md +10 -2
- package/dist/knowledge/skills/website-section-hero/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-pricing/SKILL.md +6 -1
- package/dist/knowledge/skills/website-section-social-proof/SKILL.md +12 -2
- package/dist/knowledge/skills/website-seo-aeo-geo/SKILL.md +15 -3
- package/dist/knowledge/skills/website-seo-aeo-geo/references/geo-api.md +16 -1
- package/dist/knowledge/skills/website-seo-aeo-geo/references/seo-api.md +2 -1
- package/dist/knowledge/topic-index.json +1441 -269
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +4 -4
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# saas.frontend.settings-hub.engine-destination-roles
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-frontend-lib`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-frontend-lib`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
/** Org-management destinations are visible to organization owners and admins. */
|
|
13
|
+
const ORG_MANAGEMENT_ROLES: string[] = [CORE_ORG_ROLES.ORG_OWNER, CORE_ORG_ROLES.ORG_ADMIN];
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Application-administration destinations are visible to the application's own super-administrator.
|
|
17
|
+
*
|
|
18
|
+
* ONE role, deliberately, and not the wider `APP_ADMIN_*` family: every destination gated with this
|
|
19
|
+
* is a surface whose resource ALSO requires `APP_ADMIN_SUPER_ADMIN` server-side, so admitting
|
|
20
|
+
* `APP_ADMIN_VIEWER` or `APP_ADMIN_BILLING_MANAGER` here would render a rail entry that answers 403
|
|
21
|
+
* on open — worse than absent, because it reads as a permission the operator has and a bug they hit.
|
|
22
|
+
* Widen this only alongside the operation roles it would then have to match.
|
|
23
|
+
*/
|
|
24
|
+
const APPLICATION_ADMINISTRATION_ROLES: string[] = [CORE_APP_ROLES.APP_ADMIN_SUPER_ADMIN];
|
|
25
|
+
```
|
|
@@ -119,8 +119,8 @@ export interface SettingsDestination {
|
|
|
119
119
|
ref: string;
|
|
120
120
|
/** What the destination renders in its content panel. */
|
|
121
121
|
target: SettingsSectionTarget;
|
|
122
|
-
/** Declarative runtime capability gating (
|
|
123
|
-
runtimeAvailability?:
|
|
122
|
+
/** Declarative runtime capability gating (launcher items' `requiredCapabilities`; roles are `requiredRoles`). */
|
|
123
|
+
runtimeAvailability?: SettingsRuntimeAvailabilityConfig;
|
|
124
124
|
/** Feature flags required to surface this destination (plan/subscription gating). */
|
|
125
125
|
requiredFeatures?: RequiredFeaturesConfig;
|
|
126
126
|
/** RBAC roles required to surface this destination (OR semantics). */
|
|
@@ -89,6 +89,19 @@ export enum AuditApplicationReadAccess {
|
|
|
89
89
|
INDEPENDENT_APPROVAL = 'independent-approval',
|
|
90
90
|
}
|
|
91
91
|
|
|
92
|
+
/**
|
|
93
|
+
* How one of the application's OWN audit event types is classified: the activity it records and the attention it
|
|
94
|
+
* deserves. The same two vocabularies the engine uses for its event types.
|
|
95
|
+
*/
|
|
96
|
+
export const ApplicationAuditEventTypeDeclarationSchema = z.strictObject({
|
|
97
|
+
/** What kind of activity the event records. A business event (an invoice issued, a quote sent) is `data_access`. */
|
|
98
|
+
category: z.enum(AuditEventCategory),
|
|
99
|
+
/** How much attention it deserves: `info` is evidence, `warning` is worth review, `critical` is meant for whoever handles security incidents. A SIEM destination's event filter is what routes on it. */
|
|
100
|
+
severity: z.enum(AuditEventSeverity),
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
export type ApplicationAuditEventTypeDeclaration = z.infer<typeof ApplicationAuditEventTypeDeclarationSchema>;
|
|
104
|
+
|
|
92
105
|
export const AuditTrailConfigSchema = z.object({
|
|
93
106
|
/**
|
|
94
107
|
* Application audit viewer admission. Omitted means ROLE_BASED in every environment.
|
|
@@ -155,7 +168,39 @@ export const AuditTrailConfigSchema = z.object({
|
|
|
155
168
|
* addresses are admitted, never whether the admitted address is the one connected to.
|
|
156
169
|
*/
|
|
157
170
|
allowPrivateNetworkSiemCollectors: z.boolean().optional(),
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* The application's OWN audit event types — the `eventType` values it passes to `AuditLogsBackendService.logEvent`
|
|
174
|
+
* — each with its classification. Keyed by the exact `eventType` string.
|
|
175
|
+
*
|
|
176
|
+
* ── What declaring one changes ─────────────────────────────────────────────
|
|
177
|
+
* - Every row of that type is recorded with the declared `eventCategory` and `severity`, and the SIEM export
|
|
178
|
+
* routes and filters by them. An UNDECLARED application type is recorded as `data_access` / `info`, whatever
|
|
179
|
+
* the event is — a business-critical event is then indistinguishable from routine reads.
|
|
180
|
+
* - The labelling pipeline plans a word for it (`system_enums.CoreAuditableEventType.<eventType>`, the open
|
|
181
|
+
* vocabulary the audit row's `eventType` field names), so the audit views show "Quote issued" instead of
|
|
182
|
+
* `SALES_QUOTE_ISSUED`. Run label generation after adding one.
|
|
183
|
+
*
|
|
184
|
+
* ── What it cannot do ──────────────────────────────────────────────────────
|
|
185
|
+
* It cannot reclassify a FRAMEWORK event type: the engine's own classification is authoritative, and naming one of
|
|
186
|
+
* its event types here is refused at startup. The key must be usable as the last segment of a label key (letters,
|
|
187
|
+
* digits, `_`, `-`).
|
|
188
|
+
*
|
|
189
|
+
* Severity is a property of the event TYPE. A row's `riskLevel` (supplied per emission) is a separate signal and
|
|
190
|
+
* does not change it.
|
|
191
|
+
*
|
|
192
|
+
* @example
|
|
193
|
+
* auditTrail: {
|
|
194
|
+
* applicationEventTypes: {
|
|
195
|
+
* SALES_QUOTE_ISSUED: { category: AuditEventCategory.DATA_ACCESS, severity: AuditEventSeverity.WARNING },
|
|
196
|
+
* },
|
|
197
|
+
* }
|
|
198
|
+
*/
|
|
199
|
+
applicationEventTypes: z.record(z.string().regex(LABEL_KEY_SEGMENT_PATTERN), ApplicationAuditEventTypeDeclarationSchema).optional(),
|
|
158
200
|
});
|
|
159
201
|
|
|
202
|
+
/** The application's declared audit event types, keyed by `eventType` — see `AuditTrailConfig.applicationEventTypes`. */
|
|
203
|
+
export type ApplicationAuditEventTypes = NonNullable<AuditTrailConfig['applicationEventTypes']>;
|
|
204
|
+
|
|
160
205
|
export type AuditTrailConfig = z.infer<typeof AuditTrailConfigSchema>;
|
|
161
206
|
```
|
|
@@ -28,9 +28,11 @@
|
|
|
28
28
|
* dropped, and were removed. The framework's SMS transport serves authentication's one-time codes, not
|
|
29
29
|
* resource notifications.
|
|
30
30
|
*
|
|
31
|
-
* For an EMAIL, create the template
|
|
32
|
-
*
|
|
33
|
-
* and
|
|
31
|
+
* For an EMAIL, create the template the derived reference names: one per operation variant that declares a
|
|
32
|
+
* `variantKey`, since the reference carries it. The startup validator resolves every declared reference through
|
|
33
|
+
* the configured locale chain before the application takes traffic and names the folder to create when one is
|
|
34
|
+
* missing. It REFUSES to start only for an operation with `tokenGeneration` (the email carries the token its flow
|
|
35
|
+
* needs); for any other operation it WARNS and starts, and that email is silently never sent.
|
|
34
36
|
*
|
|
35
37
|
* ## The recipient's preferences are honoured, and three things override them
|
|
36
38
|
*
|
|
@@ -584,6 +584,32 @@ export type ResourceConfiguration_BuilderParameters<
|
|
|
584
584
|
* Declaring this also REQUIRES {@link dataSubjectPolicy}: a retention-governed resource is exactly
|
|
585
585
|
* one that can be handed to `eraseSubjectAsSystem` as a subject, so it must say whether its rows are
|
|
586
586
|
* a person — and if so, whose session an erasure ends.
|
|
587
|
+
*
|
|
588
|
+
* And it REQUIRES three operations, for every `mode` including `RETAIN_ONLY`: `READ`, `LIST` and
|
|
589
|
+
* `UPDATE_MANY`, in `coreOperations` (and so in its core-operation type parameter), each with an
|
|
590
|
+
* `API_CALL` or `INTERNAL_CALL` DEFAULT variant. `UPDATE_MANY` is normally `INTERNAL_CALL`: route-less
|
|
591
|
+
* and still service-resolvable; `REPOSITORY_ONLY` is route-less too but resolves through a different
|
|
592
|
+
* transport, so the factory refuses it when the backend starts (`… to be SERVICE-RESOLVABLE`). Retaining a row still writes to it (the
|
|
593
|
+
* erasure marks `retentionStatus` in place through `updateManyAsSystem`). Do not author
|
|
594
|
+
* `systemAccessPolicy.updateMany` or `seeRetained` as `FORBIDDEN`; both are derived to `ALLOWED`.
|
|
595
|
+
*
|
|
596
|
+
* Checked twice. At COMPILE time the factory refuses a `retentionPolicy` whose core-operation TYPE lacks READ, LIST
|
|
597
|
+
* or UPDATE_MANY (`RetentionPolicyRequiresReadListAndUpdateManyInCoreOperations` in the error). When the BACKEND
|
|
598
|
+
* STARTS it checks what a type cannot see: the `coreOperations` array itself, and that each operation has a
|
|
599
|
+
* service-resolvable default variant. `wildo config check-resources` asks the start-time half without starting it.
|
|
600
|
+
*
|
|
601
|
+
* @example
|
|
602
|
+
* ```ts
|
|
603
|
+
* retentionPolicy: { mode: ErasureRetentionMode.RETAIN_ONLY },
|
|
604
|
+
* dataSubjectPolicy: { kind: ResourceDataSubjectKind.NO_PRINCIPAL },
|
|
605
|
+
* coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, CoreResourceOperation.UPDATE_MANY],
|
|
606
|
+
* operationsConfiguration: {
|
|
607
|
+
* // …READ / LIST as API_CALL defaults…
|
|
608
|
+
* [CoreResourceOperation.UPDATE_MANY]: {
|
|
609
|
+
* variants: [{ variantType: ResourceOperationVariantType.INTERNAL_CALL, isDefault: true, roles: [], riskLevel: ResourceOperationRiskLevel.CRITICAL }],
|
|
610
|
+
* },
|
|
611
|
+
* },
|
|
612
|
+
* ```
|
|
587
613
|
*/
|
|
588
614
|
retentionPolicy?: ResourceRetentionPolicy,
|
|
589
615
|
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# saas.models.roles.definition
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* One role an application declares, and the table of them. Import from `@wildo-ai/saas-models`
|
|
14
|
+
* (`RolesConfiguration`, `CORE_ORG_ROLES`, `CORE_APP_ROLES`, `ResourcePrimaryScope`).
|
|
15
|
+
*
|
|
16
|
+
* An application's own roles live in ONE place: `CUSTOM_ROLES_CONFIGURATION` in
|
|
17
|
+
* `shared-lib/src/engine/roles.ts`, a `RolesConfiguration` keyed by the role's name. Nothing else
|
|
18
|
+
* declares a role — never a resource holding role names or permission lists, which the engine does not
|
|
19
|
+
* read.
|
|
20
|
+
*
|
|
21
|
+
* - `role` — the role's name, equal to its key. Any string; prefer a stable upper-snake name
|
|
22
|
+
* (`FIELD_TECHNICIAN`).
|
|
23
|
+
* - `inheritFrom` — the role whose access this one also receives. A holder of a role satisfies every
|
|
24
|
+
* operation naming that role OR any role up its `inheritFrom` chain. The core organization chain is
|
|
25
|
+
* linear: `ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`. So a custom role inheriting
|
|
26
|
+
* `ORG_MEMBER` is NOT held by an `ORG_ADMIN`: to let administrators do what the custom role does,
|
|
27
|
+
* name both roles on the operation.
|
|
28
|
+
* - `isSystemRole` — `false` for every role an application declares.
|
|
29
|
+
* - `relatedPrimaryScope` — `ResourcePrimaryScope.ORGANIZATIONS` for a role a member holds inside one
|
|
30
|
+
* organization, `ResourcePrimaryScope.APPLICATION` for an application-wide role. Any other scope is
|
|
31
|
+
* ignored at startup with a warning, and the role grants nothing.
|
|
32
|
+
*
|
|
33
|
+
* Declaring a role is one of three steps. An organization role must also be listed in
|
|
34
|
+
* `organizationTypes.<type>.availableOrgRoles` of `wildo.saas.config.ts` (or no member can be given
|
|
35
|
+
* it), and it must be named in the `roles` of the operation variants it unlocks (or holding it changes
|
|
36
|
+
* nothing). People receive it through the engine's members screen and invitations.
|
|
37
|
+
*/
|
|
38
|
+
export const RoleDefinitionSchema = z.object({
|
|
39
|
+
role: RolesSchema,
|
|
40
|
+
inheritFrom: RolesSchema.optional(),
|
|
41
|
+
isSystemRole: z.boolean().default(false),
|
|
42
|
+
relatedPrimaryScope : z.enum(ResourcePrimaryScope),
|
|
43
|
+
});
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
export type RoleDefinition = z.infer<typeof RoleDefinitionSchema>;
|
|
47
|
+
|
|
48
|
+
export const RolesConfigurationSchema = z.record(z.string(), RoleDefinitionSchema).refine(
|
|
49
|
+
(record) => {
|
|
50
|
+
// Validate that all keys are valid roles
|
|
51
|
+
return Object.keys(record).every(key => {
|
|
52
|
+
try {
|
|
53
|
+
RolesSchema.parse(key);
|
|
54
|
+
return true;
|
|
55
|
+
} catch {
|
|
56
|
+
return false;
|
|
57
|
+
}
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
);
|
|
61
|
+
```
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
# saas.models.roles.organization-defaults
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-models`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-models`
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
*
|
|
13
|
+
* The organization roles the engine ships, and how they inherit. Read it to choose what a custom role
|
|
14
|
+
* should `inheritFrom` and which roles an operation must name.
|
|
15
|
+
*
|
|
16
|
+
* The person-holdable chain is linear: `ORG_OWNER → ORG_ADMIN → ORG_MANAGER → ORG_MEMBER → ORG_GUEST`
|
|
17
|
+
* (each holds everything to its right). `ORG_SERVICE_PROVIDER` hangs off `ORG_MEMBER` for experts of a
|
|
18
|
+
* service firm. The entries after `ORG_OWNER` are handler-only or delegated-capability roles: the
|
|
19
|
+
* engine confers them (an inbound handler, a live capability grant), they are never stored on a
|
|
20
|
+
* membership, and a membership naming one is refused. Never inherit from them or assign them.
|
|
21
|
+
*/
|
|
22
|
+
export const DEFAULT_ORGANIZATION_ROLES: RolesConfiguration = {
|
|
23
|
+
[CORE_ORG_ROLES.ORG_GUEST]: {
|
|
24
|
+
role: CORE_ORG_ROLES.ORG_GUEST,
|
|
25
|
+
isSystemRole: true,
|
|
26
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
27
|
+
},
|
|
28
|
+
[CORE_ORG_ROLES.ORG_MEMBER]: {
|
|
29
|
+
role: CORE_ORG_ROLES.ORG_MEMBER,
|
|
30
|
+
inheritFrom: CORE_ORG_ROLES.ORG_GUEST,
|
|
31
|
+
isSystemRole: true,
|
|
32
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
33
|
+
},
|
|
34
|
+
[CORE_ORG_ROLES.ORG_SERVICE_PROVIDER]: {
|
|
35
|
+
role: CORE_ORG_ROLES.ORG_SERVICE_PROVIDER,
|
|
36
|
+
inheritFrom: CORE_ORG_ROLES.ORG_MEMBER,
|
|
37
|
+
isSystemRole: true,
|
|
38
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
39
|
+
},
|
|
40
|
+
[CORE_ORG_ROLES.ORG_MANAGER]: {
|
|
41
|
+
role: CORE_ORG_ROLES.ORG_MANAGER,
|
|
42
|
+
inheritFrom: CORE_ORG_ROLES.ORG_MEMBER,
|
|
43
|
+
isSystemRole: true,
|
|
44
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
45
|
+
},
|
|
46
|
+
[CORE_ORG_ROLES.ORG_ADMIN]: {
|
|
47
|
+
role: CORE_ORG_ROLES.ORG_ADMIN,
|
|
48
|
+
inheritFrom: CORE_ORG_ROLES.ORG_MANAGER,
|
|
49
|
+
isSystemRole: true,
|
|
50
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
51
|
+
},
|
|
52
|
+
[CORE_ORG_ROLES.ORG_OWNER]: {
|
|
53
|
+
role: CORE_ORG_ROLES.ORG_OWNER,
|
|
54
|
+
inheritFrom: CORE_ORG_ROLES.ORG_ADMIN,
|
|
55
|
+
isSystemRole: true,
|
|
56
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
57
|
+
},
|
|
58
|
+
// No `inheritFrom`: handler-only, confers exactly the billing operations that name it (#1629).
|
|
59
|
+
[CORE_ORG_ROLES.ORG_BILLING_PROVIDER_EVENTS]: {
|
|
60
|
+
role: CORE_ORG_ROLES.ORG_BILLING_PROVIDER_EVENTS,
|
|
61
|
+
isSystemRole: true,
|
|
62
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
63
|
+
},
|
|
64
|
+
// No `inheritFrom` on any delegated capability (#1631): each confers exactly the operations that name it, and
|
|
65
|
+
// inheriting anything would make a lent capability's reach a function of what that role grows into later.
|
|
66
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS]: {
|
|
67
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_INVITE_MEMBERS,
|
|
68
|
+
isSystemRole: true,
|
|
69
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
70
|
+
},
|
|
71
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_EXPERTS]: {
|
|
72
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_RELATIONSHIP_EXPERTS,
|
|
73
|
+
isSystemRole: true,
|
|
74
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
75
|
+
},
|
|
76
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_READ_AUDIT_TRAIL]: {
|
|
77
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_READ_AUDIT_TRAIL,
|
|
78
|
+
isSystemRole: true,
|
|
79
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
80
|
+
},
|
|
81
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_SSO_SCIM]: {
|
|
82
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_SSO_SCIM,
|
|
83
|
+
isSystemRole: true,
|
|
84
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
85
|
+
},
|
|
86
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_API_KEYS]: {
|
|
87
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_MANAGE_API_KEYS,
|
|
88
|
+
isSystemRole: true,
|
|
89
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
90
|
+
},
|
|
91
|
+
[CORE_ORG_ROLES.ORG_DELEGATED_APPROVE_ACCESS_GRANTS]: {
|
|
92
|
+
role: CORE_ORG_ROLES.ORG_DELEGATED_APPROVE_ACCESS_GRANTS,
|
|
93
|
+
isSystemRole: true,
|
|
94
|
+
relatedPrimaryScope: ResourcePrimaryScope.ORGANIZATIONS
|
|
95
|
+
}
|
|
96
|
+
};
|
|
97
|
+
```
|
|
@@ -285,6 +285,32 @@ export {
|
|
|
285
285
|
WEBSITE_VISITOR_CONSENT_STORAGE_KEY,
|
|
286
286
|
} from '../compliance/privacy/consent-purposes.shared';
|
|
287
287
|
|
|
288
|
+
/**
|
|
289
|
+
* The governed documents an application serves as public pages, and their paths (#2588) — read by the marketing
|
|
290
|
+
* website's footer, which links the privacy notice and the terms on the application's origin. Carved into an
|
|
291
|
+
* import-free atom (`public-governed-documents.shared.ts`) so the footer and the router that mounts those pages name
|
|
292
|
+
* them from ONE source: a website copying `'/privacy'` would be a second copy that drifts.
|
|
293
|
+
*/
|
|
294
|
+
export {
|
|
295
|
+
LEGAL_NOTICE_ROUTE_PATH,
|
|
296
|
+
PUBLIC_GOVERNED_DOCUMENT_REFS,
|
|
297
|
+
PUBLIC_GOVERNED_DOCUMENT_ROUTE_PATHS,
|
|
298
|
+
resolvePublicGovernedDocumentRoutePath,
|
|
299
|
+
type PublicGovernedDocumentRefName,
|
|
300
|
+
} from '../compliance/documents/public-governed-documents.shared';
|
|
301
|
+
|
|
302
|
+
/**
|
|
303
|
+
* Whether the operator owes a legal notice (imprint), derived from where it is established (#2588). The marketing
|
|
304
|
+
* website's build reads it to decide whether the footer links the application's `/legal-notice` page, from the same
|
|
305
|
+
* function the application's projection uses. An import-free atom over the import-free jurisdiction table.
|
|
306
|
+
*/
|
|
307
|
+
export {
|
|
308
|
+
E_COMMERCE_DIRECTIVE_EEA_EFTA_STATES,
|
|
309
|
+
E_COMMERCE_INFORMATION_DUTY_OTHER_JURISDICTIONS,
|
|
310
|
+
legalNoticeOwed,
|
|
311
|
+
type LegalNoticeEstablishment,
|
|
312
|
+
} from '../compliance/privacy/legal-notice-obligation.shared';
|
|
313
|
+
|
|
288
314
|
/**
|
|
289
315
|
* The tier rule (#328) is enforced by every facet's `compose*Providers`,
|
|
290
316
|
* three of which are browser-bound and reach this package only here. It
|
|
@@ -91,6 +91,7 @@
|
|
|
91
91
|
* locale={runtime.locale}
|
|
92
92
|
* defaultLocale={runtime.defaultLocale}
|
|
93
93
|
* appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}
|
|
94
|
+
* legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}
|
|
94
95
|
* apiOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.apiOrigin}
|
|
95
96
|
* labelPack={runtime.labelPack}
|
|
96
97
|
* designTokens={WEBSITE_SITE_CONTEXT.rootConfig.designTokens}
|
|
@@ -270,6 +271,13 @@ export interface WebsitePageBridgeIslandProps {
|
|
|
270
271
|
* the consumer's job and the whole point of removing the fallback.
|
|
271
272
|
*/
|
|
272
273
|
appOrigin?: string;
|
|
274
|
+
/**
|
|
275
|
+
* Whether the operator owes a legal notice (imprint), forwarded into `WebsiteRuntimeContext.legalNoticeOwed` for the
|
|
276
|
+
* footer's legal links (#2588). An island prop for the reason `appOrigin` is one: the page reads it from
|
|
277
|
+
* `WEBSITE_SITE_CONTEXT.legalNoticeOwed`, derived at build time from `wildo.saas.config.ts`. Every page rendering
|
|
278
|
+
* the footer forwards it; the legal links refuse to render without it.
|
|
279
|
+
*/
|
|
280
|
+
legalNoticeOwed?: boolean;
|
|
273
281
|
/**
|
|
274
282
|
* The application's public pricing catalogue (#1835), forwarded into
|
|
275
283
|
* `WebsiteRuntimeContext.pricingCatalog` for `useWebsitePricingCatalog()`. Plain JSON-safe data
|
|
@@ -300,6 +308,7 @@ export function createWebsitePageBridgeIsland(
|
|
|
300
308
|
frontendProviders,
|
|
301
309
|
apiOrigin,
|
|
302
310
|
appOrigin,
|
|
311
|
+
legalNoticeOwed,
|
|
303
312
|
pricingCatalog,
|
|
304
313
|
}: WebsitePageBridgeIslandProps): ReactNode {
|
|
305
314
|
/*
|
|
@@ -330,6 +339,7 @@ export function createWebsitePageBridgeIsland(
|
|
|
330
339
|
...(deps.consentBannerComponent !== undefined ? { consentBannerComponent: deps.consentBannerComponent } : {}),
|
|
331
340
|
apiOrigin,
|
|
332
341
|
appOrigin,
|
|
342
|
+
...(legalNoticeOwed !== undefined ? { legalNoticeOwed } : {}),
|
|
333
343
|
...(pricingCatalog !== undefined ? { pricingCatalog } : {}),
|
|
334
344
|
};
|
|
335
345
|
return (
|
|
@@ -205,6 +205,9 @@ function composeEffectiveChromeLabelKeys(
|
|
|
205
205
|
// So is the provider-component slot's refusal wording (#1703): a site placing an address lookup must not
|
|
206
206
|
// ship its consent-required or unavailable state as a raw key.
|
|
207
207
|
for (const key of WEBSITE_PROVIDER_COMPONENT_LABEL_KEYS) set.add(key);
|
|
208
|
+
// And the legal links (#2588): one key per public governed document, so a document the framework adds is a missing
|
|
209
|
+
// label at the next build rather than a footer that cannot name it.
|
|
210
|
+
for (const key of WEBSITE_LEGAL_LABEL_KEYS) set.add(key);
|
|
208
211
|
return Array.from(set);
|
|
209
212
|
}
|
|
210
213
|
|
|
@@ -10,6 +10,15 @@
|
|
|
10
10
|
|
|
11
11
|
```typescript
|
|
12
12
|
*
|
|
13
|
+
* The marker the scaffold puts on every PLACEHOLDER line of `llms.txt` (the summary, the generic
|
|
14
|
+
* landing entry, the generic topic). A file still carrying it holds the template's instruction to a
|
|
15
|
+
* developer, not a description of the product, so it is never served: an AI assistant quoting it would
|
|
16
|
+
* repeat "Replace this line" as the product's summary. The marker sits on the line it guards, so
|
|
17
|
+
* replacing the line removes it, and a file is served once no placeholder is left.
|
|
18
|
+
*/
|
|
19
|
+
export const LLMS_TXT_UNAUTHORED_MARKER = 'wildo:llms-txt-unauthored';
|
|
20
|
+
|
|
21
|
+
/**
|
|
13
22
|
* Read the hand-authored `llms.txt` body for the marketing site.
|
|
14
23
|
*
|
|
15
24
|
* Publication policy:
|
|
@@ -17,6 +26,9 @@
|
|
|
17
26
|
* - `seo.llmsTxt?.enabled === true` → read the file if present, else `null`
|
|
18
27
|
* - `seo.llmsTxt === undefined` or `enabled === undefined` → auto-detect:
|
|
19
28
|
* publish when the file exists, otherwise return `null`
|
|
29
|
+
* - in every case, a file still carrying {@link LLMS_TXT_UNAUTHORED_MARKER} → `null`. A route returns
|
|
30
|
+
* `new Response(null, { status: 404 })` for `null`: a prerendered route writes any non-null body
|
|
31
|
+
* to the build output, so a text body would be served as the file with status 200
|
|
20
32
|
*/
|
|
21
33
|
export function readLlmsTxtBody(
|
|
22
34
|
siteContext: WebsiteSiteContext,
|
|
@@ -34,7 +46,8 @@ export function readLlmsTxtBody(
|
|
|
34
46
|
}
|
|
35
47
|
|
|
36
48
|
try {
|
|
37
|
-
|
|
49
|
+
const body = readFileSync(filePath, 'utf-8');
|
|
50
|
+
return body.includes(LLMS_TXT_UNAUTHORED_MARKER) ? null : body;
|
|
38
51
|
} catch (cause) {
|
|
39
52
|
throw new Error(
|
|
40
53
|
`[llms-txt-server] Could not read llms.txt at ${filePath}. ` +
|
|
@@ -102,6 +102,18 @@ export interface WebsiteSiteContext {
|
|
|
102
102
|
* React island as JSON-serializable data.
|
|
103
103
|
*/
|
|
104
104
|
readonly frontendProviders?: FrontendProvidersBlock;
|
|
105
|
+
/**
|
|
106
|
+
* Whether the operator owes a LEGAL NOTICE (imprint): derived by `loadWebsiteSiteContext` from
|
|
107
|
+
* `operatorComplianceIdentity.establishmentJurisdiction` in `wildo.saas.config.ts` with `legalNoticeOwed`, so the
|
|
108
|
+
* site and the application's `/legal-notice` page answer from the one declaration (#2588). `false` when the
|
|
109
|
+
* establishment is outside the EU, the EEA, the UK and Switzerland, or not declared yet.
|
|
110
|
+
*
|
|
111
|
+
* Every page forwards it to its bridge island beside `appOrigin`: the footer's legal links read it from
|
|
112
|
+
* `WebsiteRuntimeContext` and refuse to render without it, so a page that forgets it fails its build rather than
|
|
113
|
+
* dropping an obligation silently. Optional here only because a context composed by hand (a test) has no
|
|
114
|
+
* application config to derive it from; the loader always sets it.
|
|
115
|
+
*/
|
|
116
|
+
readonly legalNoticeOwed?: boolean;
|
|
105
117
|
}
|
|
106
118
|
|
|
107
119
|
/**
|
|
@@ -139,6 +151,7 @@ export function composeWebsiteSiteContext(
|
|
|
139
151
|
rootConfig: parts.rootConfig,
|
|
140
152
|
websiteConfig: parts.websiteConfig,
|
|
141
153
|
frontendProviders: parts.frontendProviders,
|
|
154
|
+
...(parts.legalNoticeOwed === undefined ? {} : { legalNoticeOwed: parts.legalNoticeOwed }),
|
|
142
155
|
});
|
|
143
156
|
}
|
|
144
157
|
```
|
|
@@ -327,6 +327,8 @@ export interface WebsiteBlogPostBridgeIslandProps {
|
|
|
327
327
|
/** Product origin for navigation and call-to-action components inside the blog island.
|
|
328
328
|
* Supplied by the Astro page from websiteConfig, just as on ordinary page bridges. */
|
|
329
329
|
appOrigin?: string;
|
|
330
|
+
/** Whether the operator owes a legal notice, from `WEBSITE_SITE_CONTEXT.legalNoticeOwed`, as on ordinary page bridges (#2588). */
|
|
331
|
+
legalNoticeOwed?: boolean;
|
|
330
332
|
}
|
|
331
333
|
|
|
332
334
|
const EMPTY_MDX_COMPONENTS: WebsiteMdxComponentsMap = Object.freeze({});
|
|
@@ -358,6 +360,7 @@ export function createWebsiteBlogPostBridgeIsland(
|
|
|
358
360
|
skipToMainContentLabelKey,
|
|
359
361
|
frontendProviders,
|
|
360
362
|
appOrigin,
|
|
363
|
+
legalNoticeOwed,
|
|
361
364
|
}: WebsiteBlogPostBridgeIslandProps): ReactNode {
|
|
362
365
|
const MdxBody = slugToMdxBody[slug];
|
|
363
366
|
if (MdxBody === undefined) {
|
|
@@ -397,6 +400,7 @@ export function createWebsiteBlogPostBridgeIsland(
|
|
|
397
400
|
navigation,
|
|
398
401
|
skipToMainContentLabelKey,
|
|
399
402
|
appOrigin,
|
|
403
|
+
...(legalNoticeOwed !== undefined ? { legalNoticeOwed } : {}),
|
|
400
404
|
...(deps.consentBannerComponent !== undefined ? { consentBannerComponent: deps.consentBannerComponent } : {}),
|
|
401
405
|
frontendProviderRegistry,
|
|
402
406
|
providerComponentRegistry,
|
|
@@ -59,6 +59,8 @@ import {
|
|
|
59
59
|
type WildoSaasConfig,
|
|
60
60
|
} from '@wildo-ai/platform-config-lib';
|
|
61
61
|
|
|
62
|
+
import { legalNoticeOwed } from '@wildo-ai/saas-models/public-runtime';
|
|
63
|
+
|
|
62
64
|
import { composeWebsiteSiteContext, type WebsiteSiteContext } from '../astro/website-site-context';
|
|
63
65
|
import type { WebsiteRootConfig } from '../schemas/manifests/website-root-config.shared.schemas';
|
|
64
66
|
import { loadWebsiteConfig, resolveStaticWebsiteServiceEntry } from './load-website-config';
|
|
@@ -149,6 +151,7 @@ export async function loadWebsiteSiteContext(input: LoadWebsiteSiteContextInput)
|
|
|
149
151
|
artifactPath: resolveFrontendServicesArtifactPath(resolvePath(saasRoot)),
|
|
150
152
|
serviceKey: websiteServiceKey,
|
|
151
153
|
}),
|
|
154
|
+
legalNoticeOwed: legalNoticeOwed(saasConfig.operatorComplianceIdentity) === true,
|
|
152
155
|
});
|
|
153
156
|
}
|
|
154
157
|
```
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
# saas.website.legal.public-document-links
|
|
2
|
+
|
|
3
|
+
## Import Origins
|
|
4
|
+
|
|
5
|
+
- `@wildo-ai/saas-website`
|
|
6
|
+
|
|
7
|
+
## Source Excerpts
|
|
8
|
+
|
|
9
|
+
### Origin Package: `@wildo-ai/saas-website`
|
|
10
|
+
|
|
11
|
+
```tsx
|
|
12
|
+
*
|
|
13
|
+
* The site's LEGAL LINKS: one link per public governed document the application serves (its privacy notice and its
|
|
14
|
+
* terms), each to the page the application itself serves it at, on the APPLICATION's origin. Render it once in the
|
|
15
|
+
* site footer.
|
|
16
|
+
*
|
|
17
|
+
* Total over the public documents: a document the framework adds is linked by every site at its next build, and its
|
|
18
|
+
* label is a framework-owned key every locale pack must carry (`WEBSITE_LEGAL_LABEL_KEYS`). The page paths come from
|
|
19
|
+
* the same constant the application's router mounts, so a link cannot point where no page is.
|
|
20
|
+
*
|
|
21
|
+
* When the operator owes a LEGAL NOTICE (imprint) — established in the EU, the EEA, the UK or Switzerland, derived at build time from
|
|
22
|
+
* `operatorComplianceIdentity.establishmentJurisdiction` — a last link goes to the application's `/legal-notice` page.
|
|
23
|
+
* Directive 2000/31/EC Art. 5(1) wants that information "easily, directly and permanently accessible", which a footer
|
|
24
|
+
* link on every page is. An operator who owes none gets no link.
|
|
25
|
+
* spec-cite: Directive 2000/31/EC Art. 5(1)
|
|
26
|
+
*
|
|
27
|
+
* A same-tab link, not `external`: a legal page is something the visitor reads and comes back from, and an unexpected
|
|
28
|
+
* new window is the worse experience. The application's page shows the published document, or says plainly that it is
|
|
29
|
+
* not published yet.
|
|
30
|
+
*
|
|
31
|
+
* Throws when the page did not forward `appOrigin` or `legalNoticeOwed` to its bridge island, like the scaffold's
|
|
32
|
+
* `useAppOrigin`: a legal link pointing nowhere, or an owed one silently missing, must fail the build that produced
|
|
33
|
+
* it, not ship.
|
|
34
|
+
*
|
|
35
|
+
* Import from `@wildo-ai/saas-website`.
|
|
36
|
+
*
|
|
37
|
+
* @example
|
|
38
|
+
* // website/src/components/FooterComponent.tsx
|
|
39
|
+
* <WebsitePublicDocumentLinks className="wt-footer__legal" />
|
|
40
|
+
*/
|
|
41
|
+
export function WebsitePublicDocumentLinks({ className }: WebsitePublicDocumentLinksProps): ReactNode {
|
|
42
|
+
const { appOrigin, legalNoticeOwed } = useWebsiteRuntime();
|
|
43
|
+
const headingId = useId();
|
|
44
|
+
const heading = useWebsiteLabelByKey(WEBSITE_LEGAL_LINKS_HEADING_LABEL_KEY);
|
|
45
|
+
const legalNoticeLabel = useWebsiteLabelByKey(WEBSITE_LEGAL_NOTICE_LABEL_KEY);
|
|
46
|
+
if (!appOrigin) {
|
|
47
|
+
throw new Error(
|
|
48
|
+
'[saas-website] WebsitePublicDocumentLinks needs the application origin. The page rendering it must forward '
|
|
49
|
+
+ '`appOrigin={WEBSITE_SITE_CONTEXT.websiteConfig.appOrigin}` to its bridge island.',
|
|
50
|
+
);
|
|
51
|
+
}
|
|
52
|
+
if (legalNoticeOwed === undefined) {
|
|
53
|
+
throw new Error(
|
|
54
|
+
'[saas-website] WebsitePublicDocumentLinks needs to know whether a legal notice is owed. The page rendering it '
|
|
55
|
+
+ 'must forward `legalNoticeOwed={WEBSITE_SITE_CONTEXT.legalNoticeOwed}` to its bridge island.',
|
|
56
|
+
);
|
|
57
|
+
}
|
|
58
|
+
const origin = appOrigin.replace(/\/+$/u, '');
|
|
59
|
+
return (
|
|
60
|
+
<nav aria-labelledby={headingId} className={className} data-website-legal-links="">
|
|
61
|
+
<span id={headingId} hidden>{heading}</span>
|
|
62
|
+
<ul>
|
|
63
|
+
{WEBSITE_PUBLIC_DOCUMENT_REF_NAMES.map((refName) => (
|
|
64
|
+
<WebsitePublicDocumentLink key={refName} refName={refName} href={`${origin}${PUBLIC_GOVERNED_DOCUMENT_ROUTE_PATHS[PUBLIC_GOVERNED_DOCUMENT_REFS[refName]]}`} />
|
|
65
|
+
))}
|
|
66
|
+
{legalNoticeOwed ? (
|
|
67
|
+
<li>
|
|
68
|
+
<WebsiteLink href={`${origin}${LEGAL_NOTICE_ROUTE_PATH}`}>{legalNoticeLabel}</WebsiteLink>
|
|
69
|
+
</li>
|
|
70
|
+
) : null}
|
|
71
|
+
</ul>
|
|
72
|
+
</nav>
|
|
73
|
+
);
|
|
74
|
+
}
|
|
75
|
+
WebsitePublicDocumentLinks.displayName = 'WebsitePublicDocumentLinks';
|
|
76
|
+
```
|
|
@@ -55,7 +55,8 @@
|
|
|
55
55
|
* mechanic: omitting the block means "auto-detect from file
|
|
56
56
|
* presence" rather than "use a static schema default". The helper
|
|
57
57
|
* `readLlmsTxtBody(...)` publishes when `src/content/llms.txt`
|
|
58
|
-
* exists and
|
|
58
|
+
* exists and carries no `LLMS_TXT_UNAUTHORED_MARKER`, and returns
|
|
59
|
+
* `null` otherwise.
|
|
59
60
|
*
|
|
60
61
|
* **Validation**:
|
|
61
62
|
* - `siteName` is `z.string().min(1)` — empty strings would emit
|
|
@@ -105,6 +105,13 @@ export interface WebsiteRuntimeContextValue {
|
|
|
105
105
|
* place to change it.
|
|
106
106
|
*/
|
|
107
107
|
appOrigin?: string;
|
|
108
|
+
/**
|
|
109
|
+
* Whether the operator owes a legal notice (imprint), from `WebsiteSiteContext.legalNoticeOwed` (#2588). Forwarded
|
|
110
|
+
* by every page beside `appOrigin`, for the same reason: it is derived from Node-loaded configuration a client
|
|
111
|
+
* island cannot read. `WebsitePublicDocumentLinks` links the application's `/legal-notice` page when it is `true`
|
|
112
|
+
* and refuses to render when it is absent.
|
|
113
|
+
*/
|
|
114
|
+
legalNoticeOwed?: boolean;
|
|
108
115
|
/**
|
|
109
116
|
* Flat `Record<string, string>` label pack for the active locale.
|
|
110
117
|
* Lookup keys MUST be fully-composed `website.<page>.<section>.<slot>`
|
|
@@ -21,6 +21,8 @@
|
|
|
21
21
|
* - `false` → suppress publication even if the file exists
|
|
22
22
|
* - `undefined` → auto-detect (`readLlmsTxtBody` publishes when the
|
|
23
23
|
* file exists, returns `null` when absent)
|
|
24
|
+
* - never while the file still carries `LLMS_TXT_UNAUTHORED_MARKER`,
|
|
25
|
+
* the scaffold's placeholder marker, whatever `enabled` says
|
|
24
26
|
*
|
|
25
27
|
* Keeping the "auto-detect when undefined" convention in the HELPER
|
|
26
28
|
* (not as a schema default) is deliberate: schema defaults are static,
|
|
@@ -163,9 +163,35 @@ export const WebsiteSectionPlanSchema = z.strictObject({
|
|
|
163
163
|
* vision's own one-liner — but the judge reads it.
|
|
164
164
|
*/
|
|
165
165
|
drawsOnRefs: z.array(NonEmptyStringSchema).default([]),
|
|
166
|
+
/**
|
|
167
|
+
* The requirements this section's CAPABILITY claims rest on, by their refs (#2507): functional or non-functional.
|
|
168
|
+
* A citation, named like `valuePillars[].backedByBenefitRefs`, not a delivery like a roadmap phase's field.
|
|
169
|
+
*
|
|
170
|
+
* A market benefit says what a buyer wants; it does not say the product does it. One generated site promised
|
|
171
|
+
* "country workflow guidance with its limits stated", drawn from a market benefit, while the product shipped an
|
|
172
|
+
* empty place for an administrator to write guidance. A section that says the product DOES something cites the
|
|
173
|
+
* requirement behind it. The citation is necessary, not sufficient: a requirement is a commitment, so when the
|
|
174
|
+
* section is built its author is told whether the tasks serving each cited requirement have landed, whether a run
|
|
175
|
+
* reported it still unmet, and which roadmap phase delivers it. Only what has been delivered is described as
|
|
176
|
+
* available; the rest is described as planned.
|
|
177
|
+
*
|
|
178
|
+
* Reported when empty on the feature kinds ({@link WEBSITE_CAPABILITY_CLAIM_SECTION_KINDS}, `CAPABILITY_CLAIM_UNBACKED`).
|
|
179
|
+
* Any other kind may cite requirements too, and one that cites none describes no capability as available.
|
|
180
|
+
*/
|
|
181
|
+
backedByRequirementRefs: z.array(NonEmptyStringSchema).default([]),
|
|
166
182
|
});
|
|
167
183
|
export type WebsiteSectionPlan = z.infer<typeof WebsiteSectionPlanSchema>;
|
|
168
184
|
|
|
185
|
+
/**
|
|
186
|
+
* The section kinds whose job is to say what the product DOES (#2507), reported when they cite no requirement. The
|
|
187
|
+
* build-time boundary binds every kind alike: a hero, a pricing table or an FAQ answer describes as available only
|
|
188
|
+
* what its own citations back.
|
|
189
|
+
*/
|
|
190
|
+
export const WEBSITE_CAPABILITY_CLAIM_SECTION_KINDS: readonly WebsiteSectionKind[] = [
|
|
191
|
+
WebsiteSectionKind.FEATURE_BENEFIT_SUMMARY,
|
|
192
|
+
WebsiteSectionKind.FEATURE_DETAIL,
|
|
193
|
+
];
|
|
194
|
+
|
|
169
195
|
/** One page of the marketing site. */
|
|
170
196
|
export const WebsitePagePlanSchema = z.strictObject({
|
|
171
197
|
/** `page-<slug>`, stamped by the trusted runtime; the route and the sections file are named from it. */
|