@warpgogol/werkstatt-shared 0.2.0

package/src/ontology/blueprints/ratgeber.yaml

@@ -0,0 +1,62 @@
+# Blueprint: ratgeber (RFC-0500)
+# Editorial knowledge hub — article collection with category taxonomy.
+# RFC-0500: restructured from flat topic list into editorial hub with CollectionPage semantic type.
+id: ratgeber
+entitlement: pseo
+
+dataset:
+  collection: articles
+  status: active
+
+axes:
+  - id: article
+    universe: { collection: articles, field: slug }
+    match: { recordField: slug }
+
+levels:
+  - depth: 0
+    slug: { de: ratgeber, uk: porady }
+    constellation: ratgeber-hub
+    geo: twin-only
+    titleTemplate: { de: Ratgeber, uk: Поради }
+    intro:
+      de: "Verständliche Antworten auf die häufigsten Fragen rund um Website, lokale Sichtbarkeit und digitales Fundament für kleines Gewerbe und Handwerk."
+      uk: "Зрозумілі відповіді на найпоширеніші питання про сайт, локальну видимість і цифровий фундамент для малого бізнесу та ремесла."
+    semanticType: collection
+    hub:
+      cardFields:
+        - category
+        - title
+        - question
+        - summary
+        - articleType
+        - readTime
+        - reviewedAt
+      reservedSlugs:
+        - redaktion
+  - depth: 1
+    slug: { de: "ratgeber/{article}", uk: "porady/{article}" }
+    constellation: ratgeber-article
+    geo: full
+    titleTemplate: { de: "{article.title}", uk: "{article.title}" }
+    semanticType: article
+
+policy:
+  minRecordsPerDepth: { 0: 0, 1: 1 }
+  noindexBelowPerDepth: { 1: 1 }
+  redirectPolicy: nearest-ancestor
+  trailingSlash: true
+  maxStubDepth: 1
+  substanceMin: 20
+  maxThinShare: 0.5
+  bake: lazy
+  statusGate:
+    allowedStatuses:
+      - published
+    excludedStatuses:
+      - draft
+      - review-required
+
+linking:
+  children: { limit: 12 }
+  siblings: { limit: 8 }

package/src/ontology/blueprints/website-local.yaml

@@ -0,0 +1,309 @@
+# Blueprint: website-local v2 (RFC-0238)
+# Five-axis geo-demand cascade: industry × country × region × city × demand.
+# Datasets live in the app: apps/<app>/src/content/surface/{industries,demands}/<lang>/*.md
+# Geo axes (country, region, city) are resolved from @warpgogol/geo (RFC-0237).
+# Gated by the single `pseo` entitlement (RFC-0169 / RFC-0240).
+id: website-local
+entitlement: pseo
+
+# The record set the eligibility engine counts. Each demand record lists the industries,
+# country, region, and city it applies to; a tuple is live when matching records exist.
+dataset:
+  collection: demands
+  status: active
+
+axes:
+  - id: industry
+    universe: { collection: industries, field: slug }
+    match: { recordField: industries }
+  - id: country
+    universe: { provider: geo.countries }
+    match: { recordField: country }
+  - id: region
+    universe: { provider: geo.regions }
+    match: { recordField: region }
+  - id: city
+    universe: { provider: geo.cities }
+    match: { recordField: city }
+  - id: demand
+    universe: { collection: demands, field: slug }
+    match: { recordField: slug }
+
+levels:
+  - depth: 0
+    slug: { de: website, uk: sait }
+    constellation: website-pillar
+    geo: twin-only
+    semanticType: collection
+    titleTemplate:
+      de: "Website für Handwerk und Gewerbe | Branchenübersicht | Warpgogol"
+      uk: "Сайт для ремесла та бізнесу | Огляд галузей | Warpgogol"
+    descriptionTemplate:
+      de: "Wie das Digitale Fundament an Elektriker, Friseure und andere lokale Betriebe angepasst wird: Leistungen, Einsatzgebiet, Kontaktwege und passende Funktionen."
+      uk: "Як Цифровий фундамент адаптується до електриків, перукарів та іншого локального бізнесу: послуги, зона роботи, шляхи контакту та відповідні функції."
+    intro:
+      de: "Das Digitale Fundament bleibt dasselbe. Aufbau, Inhalte, Kontaktwege und optionale Funktionen werden an den jeweiligen Betrieb angepasst. Hinweise zur lokalen Sichtbarkeit im Ratgeber [Lokale Sichtbarkeit](/ratgeber/lokale-sichtbarkeit/)."
+      uk: "Цифровий фундамент залишається тим самим. Структуру, контент, шляхи контакту та додаткові функції адаптуємо до конкретного бізнесу. Вказівки щодо локальної видимості у пораднику [Локальна видимість](/porady/lokalna-vydymist/)."
+    pillar:
+      hero:
+        eyebrow:
+          de: Digitales Fundament für Ihr Gewerbe
+          uk: Цифровий фундамент для вашого бізнесу
+        heading:
+          de: Welche Website braucht Ihr Betrieb?
+          uk: Який сайт потрібен вашому бізнесу?
+        lead:
+          de: "Ein Elektrikerbetrieb, ein Friseursalon und eine Gebäudereinigung benötigen nicht dieselben Inhalte und Kontaktwege. Hier sehen Sie, wie das Digitale Fundament an unterschiedliche Gewerbe angepasst wird."
+          uk: "Електромонтаж, перукарня та прибирання будівель потребують різного контенту та шляхів контакту. Тут видно, як Цифровий фундамент адаптується до різних видів бізнесу."
+        primaryCta:
+          label:
+            de: Gewerbe auswählen
+            uk: Обрати галузь
+          target: "#industry-catalog"
+        secondaryCta:
+          label:
+            de: Digitales Fundament verstehen
+            uk: Зрозуміти Цифровий фундамент
+          target: digitalesFundament
+      adaptation:
+        heading:
+          de: Was sich je nach Gewerbe verändert
+          uk: Що змінюється залежно від галузі
+        dimensions:
+          - heading:
+              de: Leistungen und Sprache
+              uk: Послуги та мова
+            body:
+              de: Welche Leistungen unterschieden werden und wie Kunden sie nennen.
+              uk: Які послуги потрібно розрізняти і як їх називають клієнти.
+          - heading:
+              de: Einsatzgebiet
+              uk: Зона роботи
+            body:
+              de: "Ob der Betrieb an einem Standort, in einem Radius, in mehreren Städten, mit Notdienst oder nur nach Termin arbeitet."
+              uk: "Чи працює бізнес на одному місці, в певному радіусі, у кількох містах, з аварійною службою чи лише за записом."
+          - heading:
+              de: Kontakt und Handlung
+              uk: Контакт та дія
+            body:
+              de: "Welche Aktionen wichtig sind: Anruf, Termin, Notdienst, Angebot, Rückruf, Wegbeschreibung."
+              uk: "Які дії важливі: дзвінок, запис, аварійна служба, пропозиція, зворотний дзвінок, маршрут."
+          - heading:
+              de: Nachweise und Vertrauen
+              uk: Докази та довіра
+            body:
+              de: "Welche Angaben helfen, den Betrieb einzuschätzen: Qualifikationen, Meisterbetrieb, Fotos, Bewertungen, Öffnungszeiten."
+              uk: "Які відомості допомагають оцінити бізнес: кваліфікації, майстерність, фото, відгуки, години роботи."
+      catalogHeading:
+        de: "Gewerbe auswählen"
+        uk: "Обрати галузь"
+      productPrice:
+        heading:
+          de: "Gleiche Grundlage, angepasste Struktur"
+          uk: "Спільна основа, адаптована структура"
+        body:
+          de: "Die Branche verändert nicht automatisch den Basispreis. Zusätzliche Seiten, Sprachen, Buchungsfunktionen oder Integrationen werden gesondert vereinbart."
+          uk: "Галузь не змінює автоматично базову ціну. Додаткові сторінки, мови, функції бронювання чи інтеграції узгоджуються окремо."
+        priceRef: "business-profile.offerings/digital-foundation.presentation.price"
+      finalCta:
+        heading:
+          de: Ihr Gewerbe ist noch nicht aufgeführt?
+          uk: Вашої галузі ще немає в списку?
+        body:
+          de: "Beschreiben Sie kurz Ihren Betrieb, Ihre Leistungen und Ihr Einsatzgebiet. Warpgogol prüft, wie das Digitale Fundament für Ihre Situation aufgebaut werden kann."
+          uk: "Коротко опишіть свій бізнес, послуги та зону роботи. Warpgogol перевірить, як Цифровий фундамент можна побудувати для вашої ситуації."
+        primaryCta:
+          label:
+            de: Unverbindliche Anfrage starten
+            uk: "Почати необов'язковий запит"
+          target: contact
+        secondaryCta:
+          label:
+            de: Preis ansehen
+            uk: Переглянути ціну
+          target: pricing
+  - depth: 1
+    slug: { de: "website/{industry}", uk: "sait/{industry}" }
+    constellation: website-industry
+    geo: full
+    titleTemplate:
+      {
+        de: "Website für {industry.name} erstellen lassen",
+        uk: "Сайт для напрямку: {industry.name}",
+      }
+    # RFC-0492: industry dossier configuration
+    dossier:
+      gate:
+        minServiceCategories: 5
+        minCustomerJourneys: 3
+        minTrustSignals: 4
+        minArchitectureEntries: 1
+        minModuleMappings: 3
+        minUniqueFaq: 5
+      claimRestrictions:
+        - "mehr Anfragen"
+        - "mehr Termin-Anfragen"
+        - "echte Aufträge"
+        - "steigt die Wahrscheinlichkeit"
+        - "weniger Streuverluste"
+        - "höhere Conversion"
+        - "besser gefunden"
+        - "stärkstes Conversion-Signal"
+      doorwayMaxFlaggedShare: 0.30
+      duplicateMaxSimilarity: 0.70
+      mode: warn
+  - depth: 2
+    slug: { de: "website/{industry}/{country}", uk: "sait/{industry}/{country}" }
+    constellation: website-country
+    geo: full
+    titleTemplate:
+      {
+        de: "Website für {industry.name} in {country.name}",
+        uk: "{industry.name}: сайт у {country.name}",
+      }
+  - depth: 3
+    slug: { de: "website/{industry}/{region}", uk: "sait/{industry}/{region}" }
+    constellation: website-region
+    geo: full
+    titleTemplate:
+      {
+        de: "Website für {industry.name} in {region.name}",
+        uk: "{industry.name}: сайт у регіоні {region.name}",
+      }
+  - depth: 4
+    slug: { de: "website/{industry}/{city}", uk: "sait/{industry}/{city}" }
+    constellation: website-city
+    geo: full
+    titleTemplate:
+      {
+        de: "Website für {industry.name} in {city.name}",
+        uk: "{industry.name}: сайт у місті {city.name}",
+      }
+  - depth: 5
+    slug: { de: "website/{industry}/{city}/{demand}", uk: "sait/{industry}/{city}/{demand}" }
+    constellation: bedarfskarte
+    geo: full
+    titleTemplate:
+      {
+        de: "{demand.name} für {industry.name} in {city.name}",
+        uk: "{demand.name} для {industry.name} у {city.name}",
+      }
+    # RFC-0497: intersection gate — depth-5 pages require explicit intersection records
+    intersection:
+      gate:
+        minLocalServiceQuestions: 3
+        minScenarios: 2
+        minLocalEvidence: 2
+        minUniqueContentBlocks: 1
+        minUniqueFaq: 3
+        minSources: 1
+      similarity:
+        similarityToIndustryPage: 0.70
+        similarityToCityPage: 0.70
+        similarityToServicePage: 0.70
+        similarityToOtherIntersections: 0.70
+      substanceIndependenceThreshold: 0.50
+      mode: warn
+
+policy:
+  minRecordsPerDepth: { 0: 0, 1: 1, 2: 1, 3: 1, 4: 1, 5: 1 }
+  noindexBelowPerDepth: { 5: 1 }
+  redirectPolicy: nearest-ancestor
+  trailingSlash: true
+  maxStubDepth: 1
+  # RFC-0194 / RFC-0238: anti-thin-content. A Bedarfskarte below substanceMin is auto-noindexed;
+  # pseo.validate fails if more than maxThinShare of a family is thin.
+  substanceMin: 24
+  substanceMinPerDepth: { 0: 24, 1: 36, 4: 52, 5: 64 }
+  # RFC-0274: d5 Bedarfskarten require tuple-specific proof before indexability.
+  evidencePerDepth:
+    5:
+      existenceSource: works
+      minWerkEvidence: 1
+      approvedNarrative: required
+      requiredRecordFields:
+        - searchedAs
+        - neededPage
+        - trustProofs
+        - leadLosingMistakes
+      preferredEvidenceSources:
+        - works
+        - references
+        - verifiedClaims
+      minTupleSpecificFacts: 2
+      freshness: valid-and-current
+      duplicate:
+        method: shingle
+        maxSimilarityWithinCluster: 0.86
+      leadImage: warning
+      mode: error
+  depthRoles:
+    1:
+      indexability: index
+    2:
+      indexability: navigation-noindex
+      canonicalTarget: tradeHub
+      follow: true
+      includeInSitemap: false
+      geo: off
+    3:
+      indexability: navigation-noindex
+      canonicalTarget: tradeHub
+      follow: true
+      includeInSitemap: false
+      geo: off
+    4:
+      indexability: evidence-gated
+      localEvidence:
+        minVerifiedFacts: 3
+        minCitySpecificQa: 1
+        minUniqueTokenShare: 0.30
+        maxBodySimilarityWithinBranch: 0.70
+  demandPerDepth:
+    5:
+      minVolume: 20
+      allowIntents: [commercial, transactional]
+      missing: do-not-emit
+      staleAfterDays: 365
+  maxThinShare: 0.4
+  # RFC-0240: the region-hub level (d3) is the regional-hub upsell — suppressed on the base `pseo`
+  # tier and unlocked only when the resolved entitlements report `pseo.regionalUnlocked`.
+  regionalGateDepths: [3]
+
+linking:
+  children: { limit: 12 }
+  siblings: { limit: 8 }
+  teasers:
+    relevance:
+      - { sharedAxis: industry, weight: 5 }
+      - { sharedAxis: demand, weight: 4 }
+      - { sharedAxis: city, weight: 3 }
+
+# RFC-0196 / RFC-0238: Freshness Ledger. Per-depth SLA tuned for five-level cascade.
+freshness:
+  field: lastVerified
+  slaDaysPerDepth: { 0: 3650, 1: 540, 2: 540, 3: 540, 4: 365, 5: 270 }
+  # "all": an aggregate page decays only when every contributing record is stale.
+  mode: all
+
+rotation:
+  variantsByTupleHash: true
+
+projection:
+  title:
+    de: Website erstellen lassen
+
+# RFC-0197/0207: build-time, frozen, provenanced LLM enrichment.
+enrichedFields:
+  - field: narrative
+    promptId: website-local-narrative
+    kind: narrative
+    scope: tuple
+    scopeDepth: 5
+    maxTokens: 800
+  - field: localMarket
+    promptId: local-market-signal
+    kind: field
+    scope: tuple
+    scopeDepth: 5
+    maxTokens: 200

package/src/ontology/blueprints/website-service.yaml

@@ -0,0 +1,84 @@
+# Blueprint: website-service (RFC-0496)
+# Service dossier pages — a separate surface from website-local.
+# Two axes: industry × service. One level: depth-1 (service dossier).
+# Datasets live in the app: apps/<app>/src/content/surface/services/<lang>/*.md
+# Gated by the single `pseo` entitlement (RFC-0169 / RFC-0240).
+id: website-service
+entitlement: pseo
+
+# The record set the eligibility engine counts. Each service record lists the
+# industry and service slug it applies to; a tuple is live when a matching record exists.
+dataset:
+  collection: services
+  status: active
+
+axes:
+  - id: industry
+    universe: { collection: industries, field: slug }
+    match: { recordField: industryId }
+  - id: service
+    universe: { collection: services, field: slug }
+    match: { recordField: slug }
+
+levels:
+  - depth: 0
+    slug: { de: "leistungen/website-service", uk: "posluhy/sait-service" }
+    constellation: website-service-root
+    geo: twin-only
+    semanticType: collection
+    titleTemplate: { de: "Website-Services | Warpgogol", uk: "Сайт-сервіси | Warpgogol" }
+  - depth: 1
+    slug: { de: "website/{industry}/service", uk: "sait/{industry}/service" }
+    constellation: website-service-industry
+    geo: full
+    titleTemplate:
+      { de: "Website-Services für {industry.name}", uk: "Сайт-сервіси для {industry.name}" }
+  - depth: 2
+    slug: { de: "website/{industry}/{service}", uk: "sait/{industry}/{service}" }
+    constellation: website-service
+    geo: full
+    titleTemplate:
+      {
+        de: "{service.name} für {industry.name} — Website-Struktur",
+        uk: "{service.name} для {industry.name} — структура сайту",
+      }
+    # RFC-0496: service dossier configuration
+    service:
+      gate:
+        minServiceVariants: 3
+        minCustomerQuestions: 3
+        minPriceModels: 3
+        minFaq: 5
+        minPageStructure: 1
+      claimRestrictions:
+        - "mehr Anfragen"
+        - "mehr Termin-Anfragen"
+        - "mehr Buchungen"
+        - "echte Aufträge"
+        - "steigt die Wahrscheinlichkeit"
+        - "weniger Streuverluste"
+        - "höhere Conversion"
+        - "besser gefunden"
+        - "stärkstes Conversion-Signal"
+        - "garantierte Ergebnisse"
+        - "guaranteed results"
+        - "no. 1"
+        - "number one"
+        - "leading provider"
+        - "top rated"
+        - "beste Preis"
+        - "best price"
+        - "cheapest"
+        - "günstigste"
+      mode: warn
+
+policy:
+  minRecordsPerDepth: { 0: 0, 1: 1, 2: 1 }
+  trailingSlash: true
+  maxStubDepth: 2
+
+linking:
+  parent:
+    surface: website-local
+    depth: 1
+    joinField: industryId

package/src/ontology/capabilities/lead.submit.yaml

@@ -0,0 +1,44 @@
+id: lead.submit
+version: 1
+kind: action
+title:
+  de: "Anfrage senden"
+  en: "Submit a lead"
+description:
+  de: "Reicht eine Kontaktanfrage (Name, E-Mail, Nachricht) beim Gewerbe ein. Die Anfrage wird asynchron zugestellt — die Bestätigung signalisiert Annahme, nicht Zustellung."
+  en: "Submit a contact request (name, email, message) to the business. The request is delivered asynchronously — the confirmation signals acceptance, not delivery."
+input:
+  type: object
+  required: [name, email, message]
+  additionalProperties: false
+  properties:
+    name:
+      type: string
+      minLength: 1
+      maxLength: 200
+    email:
+      type: string
+      format: email
+      maxLength: 254
+    message:
+      type: string
+      minLength: 1
+      maxLength: 5000
+output:
+  type: object
+  required: [accepted]
+  additionalProperties: false
+  properties:
+    accepted:
+      type: boolean
+integration:
+  eventKind: lead
+  source: agent
+requires:
+  entitlements: [agent.actions]
+  sections: [send-message]
+humanEquivalent:
+  sectionType: send-message
+limits:
+  perMinutePerIp: 3
+  maxPayloadBytes: 10240

package/src/ontology/cosmic/index.ts

@@ -0,0 +1,48 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Barrel export for the @warpgogol/werkstatt-shared/ontology/cosmic sub-path.
+Re-exports all three closed catalogs, their union types, and Zod schemas
+so consumers can import from a single entry point (DNA-23, RFC-0025).
+</purpose>
+<non-goals>
+  <item>Do not add runtime logic.</item>
+  <item>Do not import from outside the cosmic directory or zod.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>Wave 1 (RFC-0025): Initial creation — cosmic barrel with cross-catalog union.</item>
+</CHANGE_SUMMARY>
+*/
+
+import { z } from "zod";
+import { StarCatalog } from "./star-catalog.ts";
+import { PlanetCatalog } from "./planet-catalog.ts";
+import { MoonCatalog } from "./moon-catalog.ts";
+
+// Re-export individual catalogs, schemas, and types
+export { StarCatalog, starNameSchema } from "./star-catalog.ts";
+export type { StarName } from "./star-catalog.ts";
+
+export { PlanetCatalog, planetNameSchema } from "./planet-catalog.ts";
+export type { PlanetName } from "./planet-catalog.ts";
+
+export { MoonCatalog, moonNameSchema } from "./moon-catalog.ts";
+export type { MoonName } from "./moon-catalog.ts";
+
+// ── Cross-catalog union ────────────────────────────────────────────────────
+// CosmicName is the full set of valid cosmicName values across all layers.
+// Use the per-layer schemas (starNameSchema, planetNameSchema, moonNameSchema)
+// for layer-specific validation; cosmicNameSchema accepts any catalog entry.
+
+export type CosmicName =
+  | import("./star-catalog.ts").StarName
+  | import("./planet-catalog.ts").PlanetName
+  | import("./moon-catalog.ts").MoonName;
+
+/** Runtime schema that accepts any name from any catalog. */
+export const cosmicNameSchema = z.union([
+  z.enum(StarCatalog),
+  z.enum(PlanetCatalog),
+  z.enum(MoonCatalog),
+]);