@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
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: engine-product-definitions
|
|
3
|
-
description: Author and maintain engine-level product definition registries — feature identifiers (`ApplicationFeature` enum), feature definitions (`CUSTOM_FEATURE_DEFINITIONS`), feature profiles (`FEATURE_PROFILES`), unavailability policy (`CUSTOM_UNAVAILABILITY_POLICY`), and the
|
|
3
|
+
description: Author and maintain engine-level product definition registries — feature identifiers (`ApplicationFeature` enum), feature definitions (`CUSTOM_FEATURE_DEFINITIONS`), feature profiles (`FEATURE_PROFILES`), unavailability policy (`CUSTOM_UNAVAILABILITY_POLICY`), and the milestone definition collection (application roles are `application-roles-authoring`). Use when the user says "add a new feature flag", "define a tier profile", "wire an addon-prompt feature", "the feature shows but isn't gated", "add a milestone definition", or any change to the runtime product / feature / milestone taxonomy that complements the spec layer.
|
|
4
4
|
user-invocable: false
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -47,7 +47,7 @@ roles / milestones the app ships.
|
|
|
47
47
|
|--------------------------------------|--------------------------------------------------------------------------------------------|
|
|
48
48
|
| Feature identifiers + definitions | `shared-lib/src/engine/features.ts` |
|
|
49
49
|
| Milestone definitions | `shared-lib/src/engine/milestones.ts` |
|
|
50
|
-
| Role definitions | `shared-lib/src/engine/roles.ts`
|
|
50
|
+
| Role definitions | `shared-lib/src/engine/roles.ts` — see the `application-roles-authoring` skill |
|
|
51
51
|
| Existing engine module contribution | `shared-lib/src/engine/index.ts` |
|
|
52
52
|
| Spec parity | `specifications/src/engine/features/**/*.feature.specification.ts` (and family equivalents) |
|
|
53
53
|
| Runtime consumer (backend) | operation variants declaring `requiredFeatures` |
|
|
@@ -68,16 +68,21 @@ roles / milestones the app ships.
|
|
|
68
68
|
(`spec-feature-update` / `spec-family-update`)
|
|
69
69
|
- Resource field semantics → `spec-resource-update`
|
|
70
70
|
- Backend operation handler logic → `backend-custom-operation`
|
|
71
|
+
- Declaring or enforcing application roles → `application-roles-authoring`
|
|
71
72
|
- Frontend component slot wiring → `engine-component-registration`
|
|
72
73
|
|
|
73
74
|
## Workflow
|
|
74
75
|
|
|
75
76
|
### Step 1: Pick the correct registry
|
|
76
77
|
|
|
77
|
-
`features.ts` for feature flags / limits
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
78
|
+
`features.ts` for feature flags / limits (a typed `ApplicationFeature`
|
|
79
|
+
enum + the `CUSTOM_FEATURE_DEFINITIONS` array + supporting policy maps),
|
|
80
|
+
`milestones.ts` for onboarding / progression milestones
|
|
81
|
+
(`CUSTOM_MILESTONE_DEFINITIONS`). Roles are NOT this pattern: an
|
|
82
|
+
app-defined role is an entry of the `CUSTOM_ROLES_CONFIGURATION`
|
|
83
|
+
record in `roles.ts`, keyed by the role name, and only does something
|
|
84
|
+
once it is offered on an organization type and named on operations —
|
|
85
|
+
follow `application-roles-authoring` for roles and skip the steps below.
|
|
81
86
|
|
|
82
87
|
### Step 2: Add the identifier to the typed enum
|
|
83
88
|
|
|
@@ -422,13 +427,21 @@ Run from the app root, substituting `<MEMBER>`:
|
|
|
422
427
|
|---------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
423
428
|
| Identifiers come from the typed enum | `rg -n "ApplicationFeature\." shared-lib/src/engine/features.ts` |
|
|
424
429
|
| **No string-literal identifiers in definitions** (must be empty) | `rg -n "defineFeature\('[A-Z_]+'" shared-lib/src/engine/features.ts` |
|
|
425
|
-
| Definitions use the typed builder |
|
|
426
|
-
| Every consumption CAP declares `limitSemantic: CEILING` (a cap left on the default FLOOR silently never engages) |
|
|
430
|
+
| Definitions use the typed builder | see the commands below the table |
|
|
431
|
+
| Every consumption CAP declares `limitSemantic: CEILING` (a cap left on the default FLOOR silently never engages) | see the commands below the table |
|
|
427
432
|
| Unavailability behavior uses typed enum | `rg -n "behavior:\s+FeatureUnavailabilityBehavior\." shared-lib/src/engine/features.ts` |
|
|
428
433
|
| **No string-literal behavior** (must be empty) | `rg -n "behavior:\s+'" shared-lib/src/engine/features.ts` |
|
|
429
434
|
| Profile entries reference enum members | `rg -n "ApplicationFeature\.<MEMBER>" shared-lib/src/engine/features.ts` |
|
|
430
435
|
| Spec exists for new identifier | `rg -n "<MEMBER>" specifications/src/engine/features/` |
|
|
431
436
|
|
|
437
|
+
```bash
|
|
438
|
+
# Definitions use the typed builder
|
|
439
|
+
rg -n "defineFeature\(|defineLimitFeature\(" shared-lib/src/engine/features.ts
|
|
440
|
+
|
|
441
|
+
# Every consumption CAP declares `limitSemantic: CEILING` (a cap left on the default FLOOR silently never engages)
|
|
442
|
+
rg -n "defineLimitFeature\(" -A 6 shared-lib/src/engine/features.ts | rg -n "FEATURES_UNLIMITED" -B 3 | rg -n "limitSemantic"
|
|
443
|
+
```
|
|
444
|
+
|
|
432
445
|
Verify identifier → definition → module registration → grant → backend enforcement → frontend presentation → specification. A declared or documented feature alone neither grants access nor protects an operation.
|
|
433
446
|
|
|
434
447
|
## Common Rationalizations
|
|
@@ -360,9 +360,17 @@ export const moduleBackend_FlowsActorsRegistry: {
|
|
|
360
360
|
|
|
361
361
|
| Check | Command |
|
|
362
362
|
|---|---|
|
|
363
|
-
| functionRefs ↔ functionTools |
|
|
363
|
+
| functionRefs ↔ functionTools | see the commands below the table |
|
|
364
364
|
| system is frontend-visible | `rg "visibility:\s*FlowActorSystem_Visibility.FRONTEND" backend-api/src/modules` |
|
|
365
|
-
| view ↔ system ↔ launcher refs align |
|
|
365
|
+
| view ↔ system ↔ launcher refs align | see the commands below the table |
|
|
366
|
+
|
|
367
|
+
```bash
|
|
368
|
+
# functionRefs ↔ functionTools
|
|
369
|
+
rg "functionRefs|resourceReadTool|functionRef:" backend-api/src/modules/*/addons/flows-actors
|
|
370
|
+
|
|
371
|
+
# view ↔ system ↔ launcher refs align
|
|
372
|
+
rg "systemRef|viewRef:|ref:\s*'" frontend/src/modules/*/app-level-views frontend/src/modules/*/app-shell.module.frontend.ts
|
|
373
|
+
```
|
|
366
374
|
|
|
367
375
|
## Common Rationalizations
|
|
368
376
|
|
|
@@ -327,10 +327,24 @@ Run from the app root, substituting `<module>`:
|
|
|
327
327
|
| Agent is registered, not just declared | `rg -n "agents:\s*\[" backend-api/src/modules/<module>/addons/flows-actors` |
|
|
328
328
|
| Operation key agrees across config + operationDefinition | `rg -n "operationKey:" backend-api/src/modules/<module>/addons/flows-actors` |
|
|
329
329
|
| Every structured agent's callers pass a schema | `rg -n -U "GENERATE_STRUCTURED[\s\S]{0,400}schema:" backend-api/src` |
|
|
330
|
-
| Output is unwrapped, not used bare |
|
|
331
|
-
| **No tools on a one-shot agent** (should be empty) |
|
|
332
|
-
| **No hand-rolled provider SDK call** (should be empty) |
|
|
333
|
-
| **No API key read in app code** (should be empty) |
|
|
330
|
+
| Output is unwrapped, not used bare | see the commands below the table |
|
|
331
|
+
| **No tools on a one-shot agent** (should be empty) | see the commands below the table |
|
|
332
|
+
| **No hand-rolled provider SDK call** (should be empty) | see the commands below the table |
|
|
333
|
+
| **No API key read in app code** (should be empty) | see the commands below the table |
|
|
334
|
+
|
|
335
|
+
```bash
|
|
336
|
+
# Output is unwrapped, not used bare
|
|
337
|
+
rg -n "invokeAgent\(" -A 4 backend-api/src | rg "\.output"
|
|
338
|
+
|
|
339
|
+
# No tools on a one-shot agent (should be empty)
|
|
340
|
+
rg -n -U "GENERATE_(TEXT|STRUCTURED)[\s\S]{0,600}functionRefs" backend-api/src
|
|
341
|
+
|
|
342
|
+
# No hand-rolled provider SDK call (should be empty)
|
|
343
|
+
rg -n "@ai-sdk/|new Anthropic\(|new OpenAI\(" backend-api/src
|
|
344
|
+
|
|
345
|
+
# No API key read in app code (should be empty)
|
|
346
|
+
rg -n "ANTHROPIC_API_KEY|OPENAI_API_KEY" backend-api/src
|
|
347
|
+
```
|
|
334
348
|
|
|
335
349
|
## Common Rationalizations
|
|
336
350
|
|
|
@@ -169,10 +169,18 @@ Run from the app root, substituting `<View>` for the view's file:
|
|
|
169
169
|
|---|---|
|
|
170
170
|
| The view imports framework components | `rg -n "from '@wildo-ai/saas-frontend-lib'" <View>` |
|
|
171
171
|
| No deep import into the frontend library | `rg -n "@wildo-ai/saas-frontend-lib/" <View>` |
|
|
172
|
-
| No hand-written colour |
|
|
173
|
-
| No hand-written surface treatment |
|
|
172
|
+
| No hand-written colour | see the commands below the table |
|
|
173
|
+
| No hand-written surface treatment | see the commands below the table |
|
|
174
174
|
| No unexplained `preset` pass-through | `rg -n "preset=" <View>` |
|
|
175
175
|
|
|
176
|
+
```bash
|
|
177
|
+
# No hand-written colour
|
|
178
|
+
rg -n "#[0-9a-fA-F]{3,8}\b|rgba?\(" <View>
|
|
179
|
+
|
|
180
|
+
# No hand-written surface treatment
|
|
181
|
+
rg -n "className=\"[^\"]*(border|rounded|shadow|bg-)" <View>
|
|
182
|
+
```
|
|
183
|
+
|
|
176
184
|
The second through fifth greps should return zero matches in a finished view.
|
|
177
185
|
The second is not a judgement call — a deep import into the library is forbidden
|
|
178
186
|
outright; the rest are lines to re-check against step 5, not automatic defects.
|
|
@@ -219,7 +227,7 @@ once you have a candidate.
|
|
|
219
227
|
- **Ai Elements / Meta** (7) — `AI_AgentCapabilities`, `AI_AgentCard`, `AI_AgentList`, `AI_AgentPromptSpec`, `AI_Context`, `AI_ModelSelector`, `AI_OpenInChat`
|
|
220
228
|
- **Ai Elements / Shared** (2) — `AI_Loader`, `AI_Shimmer`
|
|
221
229
|
- **Ai Elements / Trace** (5) — `AI_ChainOfThought`, `AI_Checkpoint`, `AI_InlineCitation`, `AI_Plan`, `AI_Reasoning`
|
|
222
|
-
- **App** (
|
|
230
|
+
- **App** (11) — `AppLayout_ConsentGate`, `AppLayout_DocumentAcceptanceGate`, `AppLayout_ErrorBoundary`, `AppLayout_Home`, `AppLayout_MainContainer`, `AppLayout_RouterErrorBoundary`, `Files_UploadGrantDrop`, `PublicLayout_LegalNotice`, `PublicLayout_MainContainer`, `PublicLayout_StaticContentContainer`, `PublicLayout_Terms`
|
|
223
231
|
- **Auth** (14) — `Auth_AuthCallback`, `Auth_ConfirmEmail`, `Auth_EnrollmentRequired`, `Auth_Invitation`, `Auth_MagicLinkVerify`, `Auth_Main`, `Auth_MfaChallenge`, `Auth_OAuthConsent`, `Auth_OAuthLoggedOut`, `Auth_OAuthLogoutConfirm`, `Auth_OneOffSession`, `Auth_OrganizationOnboarding`, `Auth_PasswordLost`, `Auth_Register`
|
|
224
232
|
- **Billing** (6) — `BillingPortalLink`, `InvoiceHistory`, `PlanChangePreview`, `PricingTable`, `SubscriptionStatus`, `UsageDashboard`
|
|
225
233
|
- **Data Display** (10) — `Avatar`, `Badge`, `DescriptionDetails`, `DescriptionList`, `DescriptionTerm`, `Duration`, `Identifier`, `Kbd`, `NotificationIndicator`, `Timeline`
|
package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-catalog.md
CHANGED
|
@@ -114,7 +114,7 @@ an application reaches those through configuration, never through JSX.
|
|
|
114
114
|
| `AI_Plan` | Card + collapsible composition for structured plans. | Use when agents emit explicit multi-step plans. | Avoid for unstructured prose-only replies. |
|
|
115
115
|
| `AI_Reasoning` | Collapsible content area with streaming-friendly layout. | Use when showing model reasoning separate from final answer. | Avoid when reasoning must not be displayed. |
|
|
116
116
|
|
|
117
|
-
## App (
|
|
117
|
+
## App (11)
|
|
118
118
|
|
|
119
119
|
| Component | Renders | Use when | Avoid when |
|
|
120
120
|
| --- | --- | --- | --- |
|
|
@@ -125,6 +125,7 @@ an application reaches those through configuration, never through JSX.
|
|
|
125
125
|
| `AppLayout_MainContainer` | Root layout preset wiring `useAppShellLayout` with sidebar, toolbars, overlays, and loading gates. | Use as the top-level wrapper for signed-in SaaS experiences. | Avoid for marketing or auth-only public pages — use `PUBLIC_LAYOUTS_MAIN_CONTAINER`. |
|
|
126
126
|
| `AppLayout_RouterErrorBoundary` | ErrorDisplay presets for 404/403/5xx, application crashes, and unknown failures. | Use at the router boundary wrapping navigable content. | Avoid for isolated component errors — use `APP_LAYOUTS_ERROR_BOUNDARY`. |
|
|
127
127
|
| `Files_UploadGrantDrop` | Focused public shell — the target field and its constraints, one file chooser, one upload, then a terminal state (received, already used, expired, cancelled). | Reached only through a grant’s `uploadPageUrl`. It is the fallback for an assistant host that cannot perform the upload itself; a host that can run a command uses the grant’s curl example instead. | Never as a general upload surface — authenticated uploads go through the resource file fields, and nothing on this page is reachable without a grant token. |
|
|
128
|
+
| `PublicLayout_LegalNotice` | Public legal layout listing the legal name, establishment address and contact always, marking any of those three the operator has not declared yet, and listing legal form, representatives, trade register, VAT number, supervisory authority and regulated profession when declared; it states that no notice is published when the operator owes none. | Use on `/legal-notice`, the route the application router mounts from the public-documents atom and the marketing website links when the notice is owed. | Avoid for governed documents with releases (privacy notice, terms: use the public governed-document page) and for any text the operator did not declare: this page never drafts or invents a particular. |
|
|
128
129
|
| `PublicLayout_MainContainer` | Minimal full-viewport wrapper driven by `usePublicShellLayout`. In card mode it may open the card with a brand header: the mark when one resolves, and the name — set from the TYPOGRAPHY.HEADING recipe, and not a heading element, since the card content owns the page heading. The login page may pass `organizationBranding` from identification; an explicit shell identity still wins. Tenant color is a decorative identity accent, not a replacement for accessible application theme tokens. Other public pages keep their defaults. | Use for auth flows, static marketing content, and other pre-app surfaces. | Avoid for authenticated app shells — use `APP_LAYOUTS_MAIN_CONTAINER`. |
|
|
129
130
|
| `PublicLayout_StaticContentContainer` | Thin wrapper around centered content within the public shell. | Use for legal, help, or marketing pages that do not need auth chrome. | Avoid for authenticated app surfaces. |
|
|
130
131
|
| `PublicLayout_Terms` | Public legal-document layout that shows release version and effective date for a release, a draft notice for an unreleased draft, and a "not yet established" note beneath any clause the document states is incomplete; it shows no partial content when nothing may be displayed, and withholds unapproved releases and drafts only when the application arms its governed-document approval gate (`compliance.governedDocumentApprovalGate`), the same switch every acceptance surface reads. | Use on `/privacy`, `/terms` and future stable-definition public document routes. | Avoid for authenticated governance records, off-site documents, or rendering a draft candidate directly — drafts reach this page only as projected public documents. |
|
package/dist/knowledge/skills/frontend-component-catalog/references/framework-component-usage.md
CHANGED
|
@@ -3259,6 +3259,14 @@ import { ProgressionTrackerVariant } from '@wildo-ai/saas-models';
|
|
|
3259
3259
|
<ProgressionMilestoneTracker variant={ProgressionTrackerVariant.DETAILED} className="w-full" />
|
|
3260
3260
|
```
|
|
3261
3261
|
|
|
3262
|
+
## `PublicLayout_LegalNotice`
|
|
3263
|
+
|
|
3264
|
+
Public legal-notice (imprint) page at `/legal-notice`, rendering the operator identity particulars an information-society service provider established in the EU, the EEA, the UK or Switzerland must publish, from the application's `compliance.legalNotice` (projected from `operatorComplianceIdentity` by `wildo config legal-notice`).
|
|
3265
|
+
|
|
3266
|
+
**Composition**
|
|
3267
|
+
|
|
3268
|
+
- Preset implementation ships from `@wildo-ai/presets-components`; runtime resolution uses the component registry in `@wildo-ai/saas-frontend-lib`.
|
|
3269
|
+
|
|
3262
3270
|
## `PublicLayout_MainContainer`
|
|
3263
3271
|
|
|
3264
3272
|
Public / unauthenticated layout container with optional centered card chrome, and — when the application opts in via `publicShellIdentityMode` — the surface identity at the top of that card.
|
|
@@ -217,13 +217,27 @@ Run from the app root, substituting `<source>` and `<target>`:
|
|
|
217
217
|
| Invariant | Command |
|
|
218
218
|
|--------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
219
219
|
| Engine barrel uses the scanner (single owner) | `rg -n 'scanCustomLabelsDirectory' backend-api/src/engine/i18n/index.ts` |
|
|
220
|
-
| At least one per-unit source-locale file exists |
|
|
221
|
-
| Per-unit count matches between source and target |
|
|
222
|
-
| Lock file is up-to-date with both locales |
|
|
220
|
+
| At least one per-unit source-locale file exists | see the commands below the table |
|
|
221
|
+
| Per-unit count matches between source and target | see the commands below the table |
|
|
222
|
+
| Lock file is up-to-date with both locales | see the commands below the table |
|
|
223
223
|
| **No empty values** in any per-unit file (must be empty) | `rg -n '":\s*""' backend-api/src/engine/i18n -g '*.ts'` |
|
|
224
224
|
| **No hard-coded product strings** in JSX touched in this change | `rg -n ">[A-Z][a-z]+ [A-Z][a-z]" frontend/src/modules/<slug>/` |
|
|
225
225
|
| Every per-unit file preserves the auto-generated header | `rg --files-without-match "DO NOT EDIT THIS FILE MANUALLY" backend-api/src/engine/i18n -g '*.ts'` (output should be empty) |
|
|
226
|
-
| **No** monolithic `labels.<locale>.ts` (must be empty) |
|
|
226
|
+
| **No** monolithic `labels.<locale>.ts` (must be empty) | see the commands below the table |
|
|
227
|
+
|
|
228
|
+
```bash
|
|
229
|
+
# At least one per-unit source-locale file exists
|
|
230
|
+
rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | head
|
|
231
|
+
|
|
232
|
+
# Per-unit count matches between source and target
|
|
233
|
+
diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | sed 's/<source>/X/' | sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | sed 's/<target>/X/' | sort)
|
|
234
|
+
|
|
235
|
+
# Lock file is up-to-date with both locales
|
|
236
|
+
rg -n '"localeCode":\s*"(<source>|<target>)"' wildo-saas.lock.json
|
|
237
|
+
|
|
238
|
+
# No monolithic `labels.<locale>.ts` (must be empty)
|
|
239
|
+
rg --files backend-api/src/engine/i18n -g 'labels.*.ts' | rg -v '/'
|
|
240
|
+
```
|
|
227
241
|
|
|
228
242
|
The high-signal invariant is **"per-unit count matches between
|
|
229
243
|
source and target"** combined with **"no empty values"** — drift
|
|
@@ -210,11 +210,19 @@ Run from the app root, substituting `<source>` and `<target>`:
|
|
|
210
210
|
|
|
211
211
|
| Invariant | Command |
|
|
212
212
|
|------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------|
|
|
213
|
-
| At least one target-locale per-unit file exists |
|
|
214
|
-
| Source-locale per-unit count matches target-locale count |
|
|
213
|
+
| At least one target-locale per-unit file exists | see the commands below the table |
|
|
214
|
+
| Source-locale per-unit count matches target-locale count | see the commands below the table |
|
|
215
215
|
| Lock file tracks the target locale | `rg -n '"localeCode":\s*"<target>"' wildo-saas.lock.json` |
|
|
216
216
|
| **No empty translated values** in target files (must be empty) | `rg -n '":\s*""' backend-api/src/engine/i18n -g '*.<target>.ts'` |
|
|
217
217
|
|
|
218
|
+
```bash
|
|
219
|
+
# At least one target-locale per-unit file exists
|
|
220
|
+
rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | head
|
|
221
|
+
|
|
222
|
+
# Source-locale per-unit count matches target-locale count
|
|
223
|
+
diff <(rg --files backend-api/src/engine/i18n -g '*.<source>.ts' | sed 's/<source>/X/' | sort) <(rg --files backend-api/src/engine/i18n -g '*.<target>.ts' | sed 's/<target>/X/' | sort)
|
|
224
|
+
```
|
|
225
|
+
|
|
218
226
|
The high-signal invariants are **"source per-unit count matches
|
|
219
227
|
target per-unit count"** combined with **"no empty translated
|
|
220
228
|
values"** — drift in either direction means the translation rerun
|
|
@@ -890,11 +890,16 @@ Run from the app root, substituting `<env>`:
|
|
|
890
890
|
| Typed `BackingServiceSource` enum used per backing service | `rg -n "source:\s*BackingServiceSource\." infrastructure/<env>/wildo.infra.*.config.ts` |
|
|
891
891
|
| Every `MANAGED` declaration is MongoDB Atlas (anything else is refused) | `rg -n "BackingServiceSource\.MANAGED" infrastructure/*/wildo.infra.*.config.ts` — every hit must be `mongodb` with `provider: 'atlas'` |
|
|
892
892
|
| Audit capability has an audit store in EVERY env (both sides must match) | `rg -n "COMPLIANCE_AUDIT_TRAIL" wildo.saas.config.ts` then `rg -ln "immudb:" infrastructure/*/wildo.infra.*.config.ts` |
|
|
893
|
-
| **No secrets** in infra file (must be empty) |
|
|
893
|
+
| **No secrets** in infra file (must be empty) | see the commands below the table |
|
|
894
894
|
| Custom environment uses the remote filename | Inspect `infrastructure/<env>/wildo.infra.remote.config.ts` for every non-local ID. |
|
|
895
895
|
| Optional local companion binding is deliberate | Inspect `devCompanion` when present; omission is schema-valid. |
|
|
896
896
|
| Remote runtime mode is explicit | Inspect `runtimeEnvironment`; remote Kubernetes additionally requires `remoteProvider`. `deployment` is optional. |
|
|
897
897
|
|
|
898
|
+
```bash
|
|
899
|
+
# No secrets in infra file (must be empty)
|
|
900
|
+
rg -n "(password|apiKey|secret|token):\s*['\"]" infrastructure/<env>/wildo.infra.*.config.ts
|
|
901
|
+
```
|
|
902
|
+
|
|
898
903
|
Validate the environment slug and its filename separately from the closed
|
|
899
904
|
runtime/source enums. Keep secret values outside authored infrastructure.
|
|
900
905
|
|
|
@@ -448,9 +448,14 @@ Run from the app root, substituting `<env>` (typically `local`):
|
|
|
448
448
|
| Generated `config.json` rendered for the env | `ls .wildo-saas/infrastructure/environments/<env>/generated/config/config.json` |
|
|
449
449
|
| Compose file declares every authored backing service (e.g. clamav) | `rg -n "^ clamav:" .wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml` |
|
|
450
450
|
| **No empty `host:container` port mapping** in the compose (must be empty) | `rg -n "^\s+- \":\"" .wildo-saas/infrastructure/environments/<env>/docker-compose/docker-compose.wildo-platform.yml` |
|
|
451
|
-
| **No secret values** in the authored infra config (must be empty) |
|
|
451
|
+
| **No secret values** in the authored infra config (must be empty) | see the commands below the table |
|
|
452
452
|
| `secrets.json` has not been re-written by an unintended sync | `git status --porcelain infrastructure/<env>/secrets/secrets.json` (should be empty unless you explicitly rotated) |
|
|
453
453
|
|
|
454
|
+
```bash
|
|
455
|
+
# No secret values in the authored infra config (must be empty)
|
|
456
|
+
rg -n "(password|apiKey|secret|token):\s*['\"]" infrastructure/<env>/wildo.infra.<env>.config.ts
|
|
457
|
+
```
|
|
458
|
+
|
|
454
459
|
Compare the authored hosting choices, the selected environment's
|
|
455
460
|
`backingServices` state and the generated workloads together. Each enabled
|
|
456
461
|
self-hosted service should have its expected workload and resolved ports;
|
|
@@ -428,11 +428,19 @@ export const aiAssistantWeeklyDigestBenefit: FeatureBenefitConfig = {
|
|
|
428
428
|
| Invariant | Command |
|
|
429
429
|
|-------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
|
|
430
430
|
| Every benefit file uses the typed `FeatureBenefitConfig` | `rg -n ":\s+FeatureBenefitConfig" specifications/src/market/value-proposition/` |
|
|
431
|
-
| Every benefit declares a non-empty `deliveredBy` |
|
|
431
|
+
| Every benefit declares a non-empty `deliveredBy` | see the commands below the table |
|
|
432
432
|
| `THRESHOLD` benefits are intentional (find them all) | `rg -n "BenefitKanoCategory.THRESHOLD" specifications/src/market/` |
|
|
433
|
-
| `REVERSE` benefits live with `ANTI_TARGET` ICPs |
|
|
433
|
+
| `REVERSE` benefits live with `ANTI_TARGET` ICPs | see the commands below the table |
|
|
434
434
|
| No `LocalizedString` shapes inside benefits | `rg -n "LocalizedString" specifications/src/market/value-proposition/` |
|
|
435
435
|
|
|
436
|
+
```bash
|
|
437
|
+
# Every benefit declares a non-empty `deliveredBy`
|
|
438
|
+
rg -n "FeatureBenefitConfig" -A 8 specifications/src/market/ | rg "deliveredBy:\s*\["
|
|
439
|
+
|
|
440
|
+
# `REVERSE` benefits live with `ANTI_TARGET` ICPs
|
|
441
|
+
rg -n "BenefitKanoCategory.REVERSE" -B 4 specifications/src/market/ | rg "ANTI_TARGET|icp-anti-"
|
|
442
|
+
```
|
|
443
|
+
|
|
436
444
|
## Common Rationalizations
|
|
437
445
|
|
|
438
446
|
| Rationalization | Reality |
|
|
@@ -507,10 +507,18 @@ export const inHouseNotionAlternative: MarketAlternativeConfig = {
|
|
|
507
507
|
| Invariant | Command |
|
|
508
508
|
|-----------|---------|
|
|
509
509
|
| Every alternative file uses the typed `MarketAlternativeConfig` | `rg -n ":\s+MarketAlternativeConfig" specifications/src/market/` |
|
|
510
|
-
| Every alternative declares both `whenChosen` and `whenWeBeat` |
|
|
511
|
-
| `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` |
|
|
510
|
+
| Every alternative declares both `whenChosen` and `whenWeBeat` | see the commands below the table |
|
|
511
|
+
| `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url` | see the commands below the table |
|
|
512
512
|
| At least one positioning references each alternative | `rg -n "alt-" specifications/src/market/positioning.ts` |
|
|
513
513
|
|
|
514
|
+
```bash
|
|
515
|
+
# Every alternative declares both `whenChosen` and `whenWeBeat`
|
|
516
|
+
rg -n "MarketAlternativeConfig" -A 12 specifications/src/market/ | rg "whenChosen|whenWeBeat"
|
|
517
|
+
|
|
518
|
+
# `STATUS_QUO` / `ADJACENT_PROXY` / `IN_HOUSE_BUILD` alternatives have no `url`
|
|
519
|
+
rg -n "STATUS_QUO|ADJACENT_PROXY|IN_HOUSE_BUILD" -A 6 specifications/src/market/ | rg -v "url"
|
|
520
|
+
```
|
|
521
|
+
|
|
514
522
|
## Common Rationalizations
|
|
515
523
|
|
|
516
524
|
| Rationalization | Reality |
|
|
@@ -296,9 +296,17 @@ What earns its place:
|
|
|
296
296
|
|----------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------|
|
|
297
297
|
| Snapshot uses the typed `MarketSnapshot` contract | `rg -n ":\s+MarketSnapshot" specifications/src/market/index.ts` |
|
|
298
298
|
| Snapshot version is V2 (Phase-3 surface) | `rg -n "version:\s+MarketSnapshotVersion\.V2" specifications/src/market/index.ts` |
|
|
299
|
-
| No `LocalizedString` / `MarketLocaleConfig` references inside `market/` |
|
|
299
|
+
| No `LocalizedString` / `MarketLocaleConfig` references inside `market/` | see the commands below the table |
|
|
300
300
|
| Geographies use ISO 3166-1 alpha-2 codes or recognized region tags | `rg -n "geographies:" specifications/src/market/` (visually verify each value is `[A-Z]{2}` or one of `EMEA / NAM / APAC / LATAM / MENA / GLOBAL`; the validator enforces this at boot) |
|
|
301
|
-
| Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` |
|
|
301
|
+
| Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }` | see the commands below the table |
|
|
302
|
+
|
|
303
|
+
```bash
|
|
304
|
+
# No `LocalizedString` / `MarketLocaleConfig` references inside `market/`
|
|
305
|
+
rg -n "LocalizedString|MarketLocaleConfig" specifications/src/market/
|
|
306
|
+
|
|
307
|
+
# Anti-target ICPs carry `purposeMix: { adoption: 0, revenue: 0 }`
|
|
308
|
+
rg -n "ICPPriority.ANTI_TARGET" -A 3 specifications/src/market/ | rg "adoption:\s*0,\s*revenue:\s*0"
|
|
309
|
+
```
|
|
302
310
|
|
|
303
311
|
## Common Rationalizations
|
|
304
312
|
|
|
@@ -65,6 +65,17 @@ Locate the surfaces that may need editing using these app-relative globs:
|
|
|
65
65
|
|
|
66
66
|
### Step 1 — Pick the category name
|
|
67
67
|
|
|
68
|
+
Start from what the creator said the product IS: their one-liner, the
|
|
69
|
+
workflow they named and what they left out. The category keeps every
|
|
70
|
+
stage of that workflow and puts nothing they excluded at its centre: a
|
|
71
|
+
category under which a stated stage disappears is the wrong category,
|
|
72
|
+
not a sharper one. Better market words for the creator's own kind of
|
|
73
|
+
product are fine. When your name is a different kind of product from
|
|
74
|
+
the one the creator named, add a `notes[]` entry starting `Reframe:`
|
|
75
|
+
that quotes their framing, names yours and says why, so they can
|
|
76
|
+
overturn it. Never list the creator's own framing among
|
|
77
|
+
`rejectedCategories`.
|
|
78
|
+
|
|
68
79
|
The name is the words you want a buyer to repeat back. It should
|
|
69
80
|
be:
|
|
70
81
|
|
|
@@ -80,14 +91,14 @@ explaining it to a smart friend who has never seen the product.
|
|
|
80
91
|
|
|
81
92
|
### Step 3 — Author 2–5 `rejectedCategories`
|
|
82
93
|
|
|
83
|
-
For each: `name`, `
|
|
94
|
+
For each: `name`, `rationale`. These are the neighbouring
|
|
84
95
|
categories buyers might think we are — and which we explicitly
|
|
85
|
-
turn down. The `
|
|
96
|
+
turn down. The `rationale` line is the verbatim AI / landing-copy
|
|
86
97
|
ammunition for the comparison.
|
|
87
98
|
|
|
88
99
|
### Step 4 — Author 2–4 `differentiationDimensions`
|
|
89
100
|
|
|
90
|
-
For each: `name`, `
|
|
101
|
+
For each: `name`, `description`. These are the axes where
|
|
91
102
|
we are deliberately better than the average competitor in our
|
|
92
103
|
category. They are what AI prompts pull when asked to argue our
|
|
93
104
|
position.
|
|
@@ -166,8 +177,8 @@ export type MarketCategoryConfig = z.infer<typeof MarketCategoryConfigSchema>;
|
|
|
166
177
|
|
|
167
178
|
A complete, schema-shaped `MarketCategoryConfig` from the
|
|
168
179
|
reference application — a productized category with
|
|
169
|
-
explicit `rejectedCategories` (with `
|
|
170
|
-
`differentiationDimensions` (with `
|
|
180
|
+
explicit `rejectedCategories` (with `rationale`) and
|
|
181
|
+
`differentiationDimensions` (with `description`):
|
|
171
182
|
|
|
172
183
|
|
|
173
184
|
## Usage Example
|
|
@@ -251,9 +262,12 @@ quartet is what the snapshot validator audits.
|
|
|
251
262
|
defensive, none looks unfocused)
|
|
252
263
|
- [ ] At least 2 `differentiationDimensions` (no-axis category is
|
|
253
264
|
unactionable)
|
|
254
|
-
- [ ] Every `rejectedCategory` carries a `
|
|
265
|
+
- [ ] Every `rejectedCategory` carries a `rationale`
|
|
255
266
|
- [ ] Every `differentiationDimension` carries a
|
|
256
|
-
`
|
|
267
|
+
`description`
|
|
268
|
+
- [ ] The category keeps every workflow stage the creator named,
|
|
269
|
+
and a name of a different kind of product from theirs carries a
|
|
270
|
+
`Reframe:` note
|
|
257
271
|
|
|
258
272
|
### Grep invariants
|
|
259
273
|
|
|
@@ -326,9 +326,14 @@ export const communityIndieHackersChannel: MarketChannelConfig = {
|
|
|
326
326
|
| Invariant | Command |
|
|
327
327
|
|-----------|---------|
|
|
328
328
|
| Every channel file uses the typed `MarketChannelConfig` | `rg -n ":\s+MarketChannelConfig" specifications/src/market/` |
|
|
329
|
-
| Every channel declares non-empty `buyingJourneyStages` |
|
|
329
|
+
| Every channel declares non-empty `buyingJourneyStages` | see the commands below the table |
|
|
330
330
|
| No `LocalizedString` shapes in channel files | `rg -n "LocalizedString" specifications/src/market/channels.ts` |
|
|
331
331
|
|
|
332
|
+
```bash
|
|
333
|
+
# Every channel declares non-empty `buyingJourneyStages`
|
|
334
|
+
rg -n "MarketChannelConfig" -A 8 specifications/src/market/ | rg "buyingJourneyStages:\s*\["
|
|
335
|
+
```
|
|
336
|
+
|
|
332
337
|
## Common Rationalizations
|
|
333
338
|
|
|
334
339
|
| Rationalization | Reality |
|
|
@@ -651,7 +651,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
|
|
|
651
651
|
const trimmed = value.trim();
|
|
652
652
|
if (trimmed.length === 0) return undefined;
|
|
653
653
|
if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
|
|
654
|
-
throw new
|
|
654
|
+
throw new IntrospectionInputValidationError(
|
|
655
655
|
`buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
|
|
656
656
|
+ `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
|
|
657
657
|
+ `not a sentence — translation prose belongs in the LLM output, not the tag.`,
|
|
@@ -2893,9 +2893,17 @@ function detectMessageTemplatePlaceholderMismatch(
|
|
|
2893
2893
|
|
|
2894
2894
|
| Invariant | Command |
|
|
2895
2895
|
|--------------------------------------------------------------------|--------------------------------------------------------------------------|
|
|
2896
|
-
| Behavior IDs registered in the companion model |
|
|
2896
|
+
| Behavior IDs registered in the companion model | see the commands below the table |
|
|
2897
2897
|
| Handlers wired into the builtin handler map | `rg -n "buildMarketContextBlock\(" --type ts` |
|
|
2898
|
-
| Specifications companion exports `marketSpecification` |
|
|
2898
|
+
| Specifications companion exports `marketSpecification` | see the commands below the table |
|
|
2899
|
+
|
|
2900
|
+
```bash
|
|
2901
|
+
# Behavior IDs registered in the companion model
|
|
2902
|
+
rg -n "market-context-for-(feature|icp)" --type ts
|
|
2903
|
+
|
|
2904
|
+
# Specifications companion exports `marketSpecification`
|
|
2905
|
+
rg -n "marketSpecification" --type ts | rg "companion-exports"
|
|
2906
|
+
```
|
|
2899
2907
|
|
|
2900
2908
|
## Common Rationalizations
|
|
2901
2909
|
|
|
@@ -541,7 +541,7 @@ function normalizeOutputLanguage(value: string | undefined): string | undefined
|
|
|
541
541
|
const trimmed = value.trim();
|
|
542
542
|
if (trimmed.length === 0) return undefined;
|
|
543
543
|
if (trimmed.length > MAX_OUTPUT_LANGUAGE_LENGTH) {
|
|
544
|
-
throw new
|
|
544
|
+
throw new IntrospectionInputValidationError(
|
|
545
545
|
`buildMarketContextBlock: \`outputLanguage\` is ${trimmed.length} chars long `
|
|
546
546
|
+ `(max ${MAX_OUTPUT_LANGUAGE_LENGTH}). Pass a BCP-47 tag (e.g. \`'fr'\`, \`'pt-BR'\`), `
|
|
547
547
|
+ `not a sentence — translation prose belongs in the LLM output, not the tag.`,
|
|
@@ -134,10 +134,10 @@ intent picker (feature-scoped vs ICP-scoped sections). It is
|
|
|
134
134
|
**never** consumed for placeholder substitution and is not gated by
|
|
135
135
|
`requiredInputs[]`.
|
|
136
136
|
|
|
137
|
-
If a required flag is missing, the
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
137
|
+
If a required flag is missing, the request is refused as a bad
|
|
138
|
+
request naming the exact missing input — it surfaces precisely on
|
|
139
|
+
the CLI as `Market generation failed: …`. An unknown ref or template
|
|
140
|
+
name is refused the same way, with the refs the snapshot does hold. There is no "guess based on the snapshot"
|
|
141
141
|
fallback by design (D17 / framework-mindset).
|
|
142
142
|
|
|
143
143
|
### Step 3 — Pick the output language
|
|
@@ -707,19 +707,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
|
|
|
707
707
|
}
|
|
708
708
|
}
|
|
709
709
|
|
|
710
|
-
|
|
710
|
+
/*
|
|
711
|
+
* The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
|
|
712
|
+
* named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
|
|
713
|
+
* its name across the subprocess boundary: the controller answers 400 with the message instead of a
|
|
714
|
+
* sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
|
|
715
|
+
* `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
|
|
716
|
+
* the AUTHORED template, which no change to the request can fix.
|
|
717
|
+
*/
|
|
718
|
+
export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
|
|
711
719
|
public readonly missing: MarketMessageRequiredInput[];
|
|
712
720
|
constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
|
|
713
721
|
super(
|
|
714
722
|
`Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
|
|
715
723
|
+ `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
|
|
716
724
|
);
|
|
717
|
-
this.name = 'MarketPromptMissingRequiredInputError';
|
|
718
725
|
this.missing = missing;
|
|
719
726
|
}
|
|
720
727
|
}
|
|
721
728
|
|
|
722
|
-
export class MarketPromptUnknownRefError extends
|
|
729
|
+
export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
|
|
723
730
|
public readonly entityKind: string;
|
|
724
731
|
public readonly providedRef: string;
|
|
725
732
|
constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
|
|
@@ -727,19 +734,17 @@ export class MarketPromptUnknownRefError extends Error {
|
|
|
727
734
|
`No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
|
|
728
735
|
+ `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
|
|
729
736
|
);
|
|
730
|
-
this.name = 'MarketPromptUnknownRefError';
|
|
731
737
|
this.entityKind = entityKind;
|
|
732
738
|
this.providedRef = providedRef;
|
|
733
739
|
}
|
|
734
740
|
}
|
|
735
741
|
|
|
736
|
-
export class MarketPromptTemplateNotFoundError extends
|
|
742
|
+
export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
|
|
737
743
|
constructor(templateRef: string, knownRefs: string[]) {
|
|
738
744
|
super(
|
|
739
745
|
`No MarketMessageTemplate found with ref \`${templateRef}\`. `
|
|
740
746
|
+ `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
|
|
741
747
|
);
|
|
742
|
-
this.name = 'MarketPromptTemplateNotFoundError';
|
|
743
748
|
}
|
|
744
749
|
}
|
|
745
750
|
|
|
@@ -1491,7 +1496,12 @@ above is derived from this shape).
|
|
|
1491
1496
|
| The CLI command class is registered in the `Market` category | `rg -n "category:\\s*CommandCategory\\.Market" --type ts` |
|
|
1492
1497
|
| The companion HTTP route the CLI POSTs to | `rg -n "/api/companion/market/generate" --type ts` |
|
|
1493
1498
|
| The default timeout constant has not drifted | `rg -n "MARKET_COMPANION_DEFAULT_TIMEOUT_MS\\s*=\\s*90_000" --type ts` |
|
|
1494
|
-
| The renderer's typed errors surface to the CLI |
|
|
1499
|
+
| The renderer's typed errors surface to the CLI | see the commands below the table |
|
|
1500
|
+
|
|
1501
|
+
```bash
|
|
1502
|
+
# The renderer's typed errors surface to the CLI
|
|
1503
|
+
rg -n "MarketPrompt(MissingRequiredInput|UnknownRef|UnknownPlaceholder|TemplateNotFound)Error" --type ts
|
|
1504
|
+
```
|
|
1495
1505
|
|
|
1496
1506
|
## Common Rationalizations
|
|
1497
1507
|
|
package/dist/knowledge/skills/market-generation-cli/references/framework-market-generation-cli.md
CHANGED
|
@@ -529,19 +529,26 @@ export class MarketPromptUnknownPlaceholderError extends Error {
|
|
|
529
529
|
}
|
|
530
530
|
}
|
|
531
531
|
|
|
532
|
-
|
|
532
|
+
/*
|
|
533
|
+
* The three errors below describe the CALLER's request — a flag it did not pass, a ref or template it
|
|
534
|
+
* named that the snapshot does not hold — so they extend `IntrospectionInputValidationError` and carry
|
|
535
|
+
* its name across the subprocess boundary: the controller answers 400 with the message instead of a
|
|
536
|
+
* sanitized 500 (#2365). They keep their own classes for `instanceof`; their `name` is the contract.
|
|
537
|
+
* `MarketPromptUnknownPlaceholderError` above stays a plain error: an unknown placeholder is a fault in
|
|
538
|
+
* the AUTHORED template, which no change to the request can fix.
|
|
539
|
+
*/
|
|
540
|
+
export class MarketPromptMissingRequiredInputError extends IntrospectionInputValidationError {
|
|
533
541
|
public readonly missing: MarketMessageRequiredInput[];
|
|
534
542
|
constructor(templateRef: string, missing: MarketMessageRequiredInput[]) {
|
|
535
543
|
super(
|
|
536
544
|
`Template \`${templateRef}\` declares requiredInputs ${missing.map(m => `\`${m}\``).join(', ')} `
|
|
537
545
|
+ `but the caller did not provide them. Pass the matching CLI flag(s) (e.g. \`--icp\`, \`--benefit\`, \`--objection\`, \`--channel\`).`,
|
|
538
546
|
);
|
|
539
|
-
this.name = 'MarketPromptMissingRequiredInputError';
|
|
540
547
|
this.missing = missing;
|
|
541
548
|
}
|
|
542
549
|
}
|
|
543
550
|
|
|
544
|
-
export class MarketPromptUnknownRefError extends
|
|
551
|
+
export class MarketPromptUnknownRefError extends IntrospectionInputValidationError {
|
|
545
552
|
public readonly entityKind: string;
|
|
546
553
|
public readonly providedRef: string;
|
|
547
554
|
constructor(entityKind: string, providedRef: string, knownRefs: string[]) {
|
|
@@ -549,19 +556,17 @@ export class MarketPromptUnknownRefError extends Error {
|
|
|
549
556
|
`No ${entityKind} found with ref \`${providedRef}\` in the authored MarketSnapshot. `
|
|
550
557
|
+ `Known ${entityKind} refs: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none)'}.`,
|
|
551
558
|
);
|
|
552
|
-
this.name = 'MarketPromptUnknownRefError';
|
|
553
559
|
this.entityKind = entityKind;
|
|
554
560
|
this.providedRef = providedRef;
|
|
555
561
|
}
|
|
556
562
|
}
|
|
557
563
|
|
|
558
|
-
export class MarketPromptTemplateNotFoundError extends
|
|
564
|
+
export class MarketPromptTemplateNotFoundError extends IntrospectionInputValidationError {
|
|
559
565
|
constructor(templateRef: string, knownRefs: string[]) {
|
|
560
566
|
super(
|
|
561
567
|
`No MarketMessageTemplate found with ref \`${templateRef}\`. `
|
|
562
568
|
+ `Known templates: ${knownRefs.length > 0 ? knownRefs.map(r => `\`${r}\``).join(', ') : '(none — author one in `specifications/src/market/messaging/`)'}.`,
|
|
563
569
|
);
|
|
564
|
-
this.name = 'MarketPromptTemplateNotFoundError';
|
|
565
570
|
}
|
|
566
571
|
}
|
|
567
572
|
|