@warpgogol/werkstatt-shared 0.12.0 → 0.14.0

package/src/integration/tests/lagebild-ingress.test.ts

@@ -0,0 +1,118 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Unit tests for the Lagebild ingress HTTP client. Verifies payload
+construction, idempotency key generation, and network error handling.</purpose>
+<non-goals>
+  <item>Do not make real HTTP calls — fetch is mocked.</item>
+</non-goals>
+</MODULE_CONTRACT>
+*/
+
+import { test, expect, vi } from "vitest";
+import {
+  submitIngress,
+  buildIdempotencyKey,
+  LAGEBILD_INGRESS_CONTRACT_VERSION,
+  type LagebildIngressConfig,
+} from "../lagebild-ingress.ts";
+
+const baseConfig: LagebildIngressConfig = {
+  apiUrl: "https://lagebild-api.example.workers.dev",
+  apiKey: "lbk_test_key_0001",
+  tenantId: "ten_warpgogol000001",
+  sourceSystemId: "site_warpgogol_com",
+};
+
+test("buildIdempotencyKey is stable and combines tenant + submission", () => {
+  const key = buildIdempotencyKey("ten_abc", "sub_123");
+  expect(key).toBe("ten_abc:sub_123");
+  expect(buildIdempotencyKey("ten_abc", "sub_123")).toBe(key);
+});
+
+test("submitIngress sends POST with correct headers and payload", async () => {
+  const fetchSpy = vi.spyOn(globalThis, "fetch").mockResolvedValue(
+    new Response(
+      JSON.stringify({
+        submission_id: "sub_test00000000000001",
+        accepted: true,
+        is_replay: false,
+        correlation_id: null,
+      }),
+      { status: 200, headers: { "Content-Type": "application/json" } },
+    ),
+  );
+
+  const result = await submitIngress(baseConfig, {
+    submissionId: "sub_test00000000000001",
+    idempotencyKey: "ten_warpgogol000001:sub_test00000000000001",
+    interactionKind: "contact_message",
+    identityClaims: [
+      { claim_type: "email", value: "test@example.com" },
+      { claim_type: "person_name", value: "Test User" },
+    ],
+    message: "Hello from the test",
+    origin: { page_uri: "https://example.com/contact", locale: "de" },
+  });
+
+  expect(result.accepted).toBe(true);
+  expect(result.is_replay).toBe(false);
+
+  expect(fetchSpy).toHaveBeenCalledOnce();
+  const [url, init] = fetchSpy.mock.calls[0] as [string, RequestInit];
+  expect(url).toBe("https://lagebild-api.example.workers.dev/v1/ingress");
+  expect(init.method).toBe("POST");
+  expect((init.headers as Record<string, string>)["Authorization"]).toBe(
+    "Bearer lbk_test_key_0001",
+  );
+
+  const body = JSON.parse(init.body as string) as Record<string, unknown>;
+  expect(body["contract_version"]).toBe(LAGEBILD_INGRESS_CONTRACT_VERSION);
+  expect(body["tenant_id"]).toBe("ten_warpgogol000001");
+  expect(body["source_system_id"]).toBe("site_warpgogol_com");
+  expect(body["interaction_kind"]).toBe("contact_message");
+
+  fetchSpy.mockRestore();
+});
+
+test("submitIngress returns accepted=false on network error", async () => {
+  vi.spyOn(globalThis, "fetch").mockRejectedValue(new Error("connection refused"));
+
+  const result = await submitIngress(baseConfig, {
+    submissionId: "sub_test00000000000002",
+    idempotencyKey: "ten:test2",
+    interactionKind: "inquiry",
+    identityClaims: [{ claim_type: "email", value: "test@example.com" }],
+  });
+
+  expect(result.accepted).toBe(false);
+  expect(result.rejection_class).toBe("network_error");
+
+  vi.restoreAllMocks();
+});
+
+test("submitIngress returns accepted=false on 400 response", async () => {
+  vi.spyOn(globalThis, "fetch").mockResolvedValue(
+    new Response(
+      JSON.stringify({
+        submission_id: "sub_test00000000000003",
+        accepted: false,
+        is_replay: false,
+        rejection_class: "schema_invalid",
+        correlation_id: null,
+      }),
+      { status: 400, headers: { "Content-Type": "application/json" } },
+    ),
+  );
+
+  const result = await submitIngress(baseConfig, {
+    submissionId: "sub_test00000000000003",
+    idempotencyKey: "ten:test3",
+    interactionKind: "inquiry",
+    identityClaims: [{ claim_type: "email", value: "bad" }],
+  });
+
+  expect(result.accepted).toBe(false);
+  expect(result.rejection_class).toBe("schema_invalid");
+
+  vi.restoreAllMocks();
+});

package/src/observability/typed-refs.ts

@@ -15,7 +15,7 @@
 */
 
 import type { MetricsPusher } from "./pusher.ts";
-import { WARPGOGOL_METRIC_REGISTRY } from "./metric-registry.ts";
+import type { WARPGOGOL_METRIC_REGISTRY } from "./metric-registry.ts";
 
 type LabelKeys<L extends readonly string[]> = L[number];
 type LabelMap<L extends readonly string[]> = Partial<Record<LabelKeys<L>, string>>;

package/src/ontology/analytics/matomo-fleet.registry.yaml

@@ -15,7 +15,7 @@ sites:
     siteId: "1"
     matomoCloudHost: warpgogol.matomo.cloud
     status: active
-    provisionedAt: "2026-08-08"
+    provisionedAt: 2026-08-08
     dimensions:
       visit:
         client_id: 1

package/src/ontology/archetypes/index.json

@@ -135,15 +135,15 @@
       "layer": "component"
     },
     {
-      "id": "currency-selector",
-      "displayName": "Currency Selector",
-      "semanticRole": "component-currency-selector",
+      "id": "cycle-toggle",
+      "displayName": "Cycle Toggle",
+      "semanticRole": "component-cycle-toggle",
       "version": "1.0.0",
       "layoutHint": "split",
       "acceptedCosmicNames": [
-        "Portia"
+        "Cupid"
       ],
-      "sourceFile": "packages/werkstatt-site/src/domain/ontology/archetypes/components/currency-selector.yaml",
+      "sourceFile": "packages/werkstatt-site/src/domain/ontology/archetypes/components/cycle-toggle.yaml",
       "layer": "component"
     },
     {
@@ -750,7 +750,7 @@
     "component-brand-label",
     "component-copyright",
     "component-currency-aware-price-display",
-    "component-currency-selector",
+    "component-cycle-toggle",
     "component-footer-promo",
     "component-lang-switcher",
     "component-layout",
@@ -814,9 +814,10 @@
     "Proteus": "@warpgogol/werkstatt-site/ui/components/brand-label",
     "Charon": "@warpgogol/werkstatt-site/ui/components/copyright",
     "Rosalind": "@warpgogol/werkstatt-site/ui/components/currency-aware-price-display",
-    "Portia": "@warpgogol/werkstatt-site/ui/components/currency-selector",
+    "Cupid": "@warpgogol/werkstatt-site/ui/components/cycle-toggle",
     "Galatea": "@warpgogol/werkstatt-site/ui/components/donation-card",
     "Puck": "@warpgogol/werkstatt-site/ui/components/effects",
+    "Prospero": "@warpgogol/werkstatt-site/ui/components/external-link-qr-modal",
     "Nereid": "@warpgogol/werkstatt-site/ui/components/footer-promo",
     "Ophelia": "@warpgogol/werkstatt-site/ui/components/lang-switcher",
     "Umbriel": "@warpgogol/werkstatt-site/ui/components/layout",
@@ -892,8 +893,9 @@
     "brand-label": "Proteus",
     "copyright": "Charon",
     "currency-aware-price-display": "Rosalind",
-    "currency-selector": "Portia",
+    "cycle-toggle": "Cupid",
     "section-shell": "Puck",
+    "external-link-qr-modal": "Prospero",
     "footer-promo": "Nereid",
     "lang-switcher": "Ophelia",
     "layout": "Umbriel",
@@ -975,9 +977,10 @@
     "Ariel": "breadcrumbs",
     "Charon": "copyright",
     "Rosalind": "price-display",
-    "Portia": "currency-selector",
+    "Cupid": "cycle-toggle",
     "Galatea": "person-profile",
     "Puck": "section-shell",
+    "Prospero": "layout-shell",
     "Titania": "footer",
     "Nereid": "footer-promo",
     "Oberon": "header",

package/src/ontology/archetypes/index.yaml

@@ -1,5 +1,5 @@
 schemaVersion: 1.0.0
-totalCount: 58
+totalCount: 59
 entries:
   - id: approach
     displayName: Approach
@@ -100,14 +100,14 @@ entries:
       - Rosalind
     sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/components/currency-aware-price-display.yaml
     layer: component
-  - id: currency-selector
-    displayName: Currency Selector
-    semanticRole: component-currency-selector
+  - id: cycle-toggle
+    displayName: Cycle Toggle
+    semanticRole: component-cycle-toggle
     version: 1.0.0
     layoutHint: split
     acceptedCosmicNames:
-      - Portia
-    sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/components/currency-selector.yaml
+      - Cupid
+    sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/components/cycle-toggle.yaml
     layer: component
   - id: donation-card
     displayName: Donation Card
@@ -163,6 +163,15 @@ entries:
       - Nereid
     sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/components/footer-promo.yaml
     layer: component
+  - id: gratitude
+    displayName: Gratitude
+    semanticRole: client-gratitude
+    version: 1.0.0
+    layoutHint: card-grid
+    acceptedCosmicNames:
+      - Gonggong
+    sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/sections/gratitude.yaml
+    layer: section
   - id: hero
     displayName: Hero
     semanticRole: hero
@@ -528,6 +537,7 @@ sectionRoles:
   - article-index
   - audience-self-identification
   - breadcrumbs
+  - client-gratitude
   - client-ownership-disclosure
   - consent-gated-chat-launcher
   - credits-gallery
@@ -560,7 +570,7 @@ componentRoles:
   - component-brand-label
   - component-copyright
   - component-currency-aware-price-display
-  - component-currency-selector
+  - component-cycle-toggle
   - component-footer-promo
   - component-lang-switcher
   - component-layout
@@ -599,6 +609,7 @@ planetImportPaths:
   Elara: "@warpgogol/werkstatt-site/ui/sections/dynamic-status-block"
   Atlas: "@warpgogol/werkstatt-site/ui/sections/faq-list"
   Dione: "@warpgogol/werkstatt-site/ui/sections/final-cta"
+  Gonggong: "@warpgogol/werkstatt-site/ui/sections/gratitude"
   Europa: "@warpgogol/werkstatt-site/ui/sections/hero"
   Phobos: "@warpgogol/werkstatt-site/ui/sections/hero-decision-card"
   Ganymede: "@warpgogol/werkstatt-site/ui/sections/impact"
@@ -622,9 +633,10 @@ planetImportPaths:
   Proteus: "@warpgogol/werkstatt-site/ui/components/brand-label"
   Charon: "@warpgogol/werkstatt-site/ui/components/copyright"
   Rosalind: "@warpgogol/werkstatt-site/ui/components/currency-aware-price-display"
-  Portia: "@warpgogol/werkstatt-site/ui/components/currency-selector"
+  Cupid: "@warpgogol/werkstatt-site/ui/components/cycle-toggle"
   Galatea: "@warpgogol/werkstatt-site/ui/components/donation-card"
   Puck: "@warpgogol/werkstatt-site/ui/components/effects"
+  Prospero: "@warpgogol/werkstatt-site/ui/components/external-link-qr-modal"
   Nereid: "@warpgogol/werkstatt-site/ui/components/footer-promo"
   Ophelia: "@warpgogol/werkstatt-site/ui/components/lang-switcher"
   Umbriel: "@warpgogol/werkstatt-site/ui/components/layout"
@@ -675,6 +687,7 @@ blockTypeToCosmicName:
   dynamic-status-block: Elara
   faq-list: Atlas
   final-cta: Dione
+  gratitude: Gonggong
   hero: Europa
   hero-decision-card: Phobos
   impact: Ganymede
@@ -698,8 +711,9 @@ blockTypeToCosmicName:
   brand-label: Proteus
   copyright: Charon
   currency-aware-price-display: Rosalind
-  currency-selector: Portia
+  cycle-toggle: Cupid
   section-shell: Puck
+  external-link-qr-modal: Prospero
   footer-promo: Nereid
   lang-switcher: Ophelia
   layout: Umbriel
@@ -754,6 +768,7 @@ roleByCosmicName:
   Elara: data-driven-status-indicator
   Atlas: approach
   Dione: final-cta
+  Gonggong: client-gratitude
   Europa: hero
   Phobos: hero
   Ganymede: impact
@@ -778,9 +793,10 @@ roleByCosmicName:
   Ariel: breadcrumbs
   Charon: copyright
   Rosalind: price-display
-  Portia: currency-selector
+  Cupid: cycle-toggle
   Galatea: person-profile
   Puck: section-shell
+  Prospero: layout-shell
   Titania: footer
   Nereid: footer-promo
   Oberon: header

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

@@ -95,8 +95,8 @@ levels:
               de: "Welche Angaben helfen, den Betrieb einzuschätzen: Qualifikationen, Meisterbetrieb, Fotos, Bewertungen, Öffnungszeiten."
               uk: "Які відомості допомагають оцінити бізнес: кваліфікації, майстерність, фото, відгуки, години роботи."
       catalogHeading:
-        de: "Gewerbe auswählen"
-        uk: "Обрати галузь"
+        de: Gewerbe auswählen
+        uk: Обрати галузь
       productPrice:
         heading:
           de: "Gleiche Grundlage, angepasste Struktur"
@@ -104,7 +104,7 @@ levels:
         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"
+        priceRef: business-profile.offerings/digital-foundation.presentation.price
       finalCta:
         heading:
           de: Ihr Gewerbe ist noch nicht aufgeführt?
@@ -141,14 +141,14 @@ levels:
         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"
+        - 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

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

@@ -22,7 +22,7 @@ axes:
 
 levels:
   - depth: 0
-    slug: { de: "leistungen/website-service", uk: "posluhy/sait-service" }
+    slug: { de: leistungen/website-service, uk: posluhy/sait-service }
     constellation: website-service-root
     geo: twin-only
     semanticType: collection
@@ -51,25 +51,25 @@ levels:
         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"
+        - 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:

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

@@ -2,8 +2,8 @@ id: lead.submit
 version: 1
 kind: action
 title:
-  de: "Anfrage senden"
-  en: "Submit a lead"
+  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."

package/src/ontology/enums.ts

@@ -87,7 +87,7 @@ export type SemanticRole = string;
  * section-cta     | [RFC-0104] Single CTA / CTA group primitive
  * section-image   | [RFC-0104] Authored image primitive with fade masks
  * site-background | [RFC-0105] Full-viewport background shell-layer component
- * currency-selector | [RFC-0743] Currency selector dropdown for multi-currency sites
+ * cycle-toggle     | [RFC-0946] Generic cycle toggle button with localStorage persistence
  * price-display    | [RFC-0743] Currency-aware price display with pre-rendered variants
  * scroll-to-top   | [RFC-0768] Floating scroll-to-top button with Lenis smooth scrolling
  */
@@ -107,7 +107,7 @@ export const ComponentRoleValues = [
   "section-cta",
   "section-image",
   "site-background",
-  "currency-selector",
+  "cycle-toggle",
   "price-display",
   "scroll-to-top",
 ] as const;

package/src/ontology/external-surfaces/jsonld-types.yaml

@@ -105,31 +105,31 @@ surfacePolicy:
 # Enforced by surface.media-leakage.validate and surface.contract.validate.
 mediaLeakagePolicy:
   prohibitedStrings:
-    - pattern: "Gemini"
+    - pattern: Gemini
       matchingStrategy: context-aware
       contextSelector: "[data-credit-context], figcaption, details, dl"
       reason: "AI model name is internal metadata, not visitor-facing"
-    - pattern: "AIPlatform"
+    - pattern: AIPlatform
       matchingStrategy: whole-word
-      reason: "Internal enum value (CreditPartyKind)"
-    - pattern: "Organization"
+      reason: Internal enum value (CreditPartyKind)
+    - pattern: Organization
       matchingStrategy: context-aware
       contextSelector: "[data-credit-context], figcaption, details, dl"
-      reason: "Internal enum value (CreditPartyKind) — only as media author label"
-    - pattern: "commissioned-warpgogol-material"
+      reason: Internal enum value (CreditPartyKind) — only as media author label
+    - pattern: commissioned-warpgogol-material
       matchingStrategy: whole-word
-      reason: "Internal enum value (MaterialSourceType)"
-    - pattern: "linked-public-source"
+      reason: Internal enum value (MaterialSourceType)
+    - pattern: linked-public-source
       matchingStrategy: whole-word
-      reason: "Internal enum value"
-    - pattern: "Copyright © 2026 Warpgogol"
+      reason: Internal enum value
+    - pattern: Copyright © 2026 Warpgogol
       matchingStrategy: exact
       contextSelector: ":not(footer):not([data-footer])"
-      reason: "Repetitive copyright boilerplate — per-material usage status is on /bildnachweise/"
+      reason: Repetitive copyright boilerplate — per-material usage status is on /bildnachweise/
   requiredLabels:
-    - label: "Konzeptillustration"
+    - label: Konzeptillustration
       lang: de
-    - label: "Концептуальна ілюстрація"
+    - label: Концептуальна ілюстрація
       lang: uk
   requiredLinkPattern: "/bildnachweise/#"
-  aiImageAttribute: "data-ai-generated"
+  aiImageAttribute: data-ai-generated

package/src/ontology/external-surfaces/url-schema.yaml

@@ -77,7 +77,7 @@ routePatterns:
         type: string
     generated: true
   # RFC-0512: Team JSON endpoints (machine-readable profiles)
-  - pattern: "/team/profiles.json"
+  - pattern: /team/profiles.json
     params: {}
     generated: true
   - pattern: "/team/:slug/profile.json"

package/src/ontology/index.ts

@@ -81,6 +81,7 @@ export {
   SiteFamilyContract,
   sectionArchetypeSchema,
   systemManifestSchema,
+  systemCollectionSchema,
 } from "./schemas/index.ts";
 export type {
   Constellation,
@@ -106,6 +107,7 @@ export type {
   SystemManifest,
   SystemPagePin,
   SystemPlanetPin,
+  SystemCollectionData,
 } from "./schemas/index.ts";
 
 // ---------------------------------------------------------------------------

package/src/ontology/schemas/index.ts

@@ -63,8 +63,13 @@ export type {
   SectionArchetypeLayoutHint,
 } from "./section-archetype.ts";
 
-export { systemManifestSchema } from "./system.ts";
-export type { SystemManifest, SystemPagePin, SystemPlanetPin } from "./system.ts";
+export { systemManifestSchema, systemCollectionSchema } from "./system.ts";
+export type {
+  SystemManifest,
+  SystemPagePin,
+  SystemPlanetPin,
+  SystemCollectionData,
+} from "./system.ts";
 
 // Architecture review 2026-07-10: Re-export growthVendorSchema for @warpgogol/werkstatt-site/growth/config.ts.
 export { growthVendorSchema } from "./system.ts";

package/src/ontology/schemas/system/integrations.ts

@@ -128,7 +128,7 @@ export const systemIntegrationsSchema = z.object({
    * (e.g. uchat, stripe, operator), and whether the pilot is `enabled`. UChat is the
    * conversation runtime — it renders the funnel and requests transitions; it never
    * owns the graph, pricing, or canonical state. Make.com is never a source. Validated
-   * by `funnel.contract.validate` / `funnel.stage.validate` / `funnel.lagebild.validate`.
+   * by `funnel.contract.validate` / `funnel.stage.validate` / `funnel.crm.validate`.
    * Absent ⇒ the funnel validators are a no-op pass (funnel not yet enabled for the app).
    */
   funnel: z

package/src/ontology/schemas/system/manifest.ts

@@ -8,6 +8,7 @@
 <CHANGE_SUMMARY>
   <item>RFC-0303 Phase 3: extracted from schemas/system.ts as part of the domain split.</item>
   <item>RFC-0377: added optional `audience` field to the per-page pin schema.</item>
+  <item>ADR-0062: added `ctaTarget` to identity, `sectionNav` + `ctaTarget` to page pins, created `systemCollectionSchema` for content collection typing.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -79,6 +80,13 @@ export const systemManifestSchema = z.object({
      * brief.validate can cross-check the brief against the running app identity.
      */
     domain: z.string().min(1).optional(),
+
+    /**
+     * ADR-0062: App-level default CTA target — the pageId of the contact/CTA page.
+     * Per-page `ctaTarget` in pages[] overrides this app-level default.
+     * Used by resolve-route.ts to populate `ctaTarget` in PageRouteData.
+     */
+    ctaTarget: z.string().min(1).optional(),
   }),
 
   /**
@@ -222,7 +230,7 @@ export const systemManifestSchema = z.object({
                 enabled: z.boolean(),
                 cosmicMoon: z.string().min(1),
                 pin: z.string().min(1),
-                props: z.record(z.string(), z.any()).optional(),
+                props: z.record(z.string(), z.unknown()).optional(),
               })
               .optional(),
           })
@@ -247,6 +255,19 @@ export const systemManifestSchema = z.object({
           )
           .optional()
           .default([]),
+
+        /**
+         * RFC-0922 / ADR-0062: per-page section nav toggle. When false, the
+         * page template skips extractSectionNavItems and the Header secondary
+         * nav strip is omitted. Defaults to true when absent.
+         */
+        sectionNav: z.boolean().optional(),
+
+        /**
+         * ADR-0062: per-page CTA target override. When present, overrides the
+         * app-level `identity.ctaTarget` for this page.
+         */
+        ctaTarget: z.string().min(1).optional(),
       }),
     )
     .optional()
@@ -498,3 +519,19 @@ export type SystemManifest = z.infer<typeof systemManifestSchema>;
 export type SystemPagePin = NonNullable<SystemManifest["pages"]>[number];
 /** A single planet pin within a page-route entry. */
 export type SystemPlanetPin = NonNullable<SystemManifest["pages"][number]["planets"]>[number];
+
+/**
+ * ADR-0062: Lenient schema for the `system` Astro content collection.
+ *
+ * `systemManifestSchema` is the strict validation schema used by `system.manifest.validate`.
+ * The content collection schema needs to be more lenient:
+ *   - `.partial()` — all top-level fields are optional (system.md content varies per site)
+ *   - `.loose()` — unknown top-level keys pass through (e.g. `policy`, `seo`)
+ *
+ * This schema is used in `src/content/config.ts` via `defineCollection({ schema: systemCollectionSchema })`.
+ * It provides compile-time typing for `getCollection("system")` consumers, eliminating `as any` casts.
+ */
+export const systemCollectionSchema = systemManifestSchema.partial().loose();
+
+/** Inferred type for the `system` content collection data. */
+export type SystemCollectionData = z.infer<typeof systemCollectionSchema>;

package/src/ontology/schemas/system.ts

@@ -49,5 +49,10 @@ export {
   pageOutputSchema,
 } from "./system/page-output.ts";
 
-export { systemManifestSchema } from "./system/manifest.ts";
-export type { SystemManifest, SystemPagePin, SystemPlanetPin } from "./system/manifest.ts";
+export { systemManifestSchema, systemCollectionSchema } from "./system/manifest.ts";
+export type {
+  SystemManifest,
+  SystemPagePin,
+  SystemPlanetPin,
+  SystemCollectionData,
+} from "./system/manifest.ts";

package/src/ontology/shared-section-props/common.ts

@@ -155,6 +155,17 @@ export const EFFECT_STACK_ITEM_SCHEMA = {
         skewX: { type: "number", minimum: -15, maximum: 15 },
       },
     },
+    {
+      type: "object",
+      additionalProperties: false,
+      required: ["kind", "enabled"],
+      properties: {
+        kind: { const: "lighten" },
+        enabled: { type: "boolean" },
+        opacity: { type: "number", minimum: 0, maximum: 1 },
+        color: EFFECT_COLOR_SCHEMA,
+      },
+    },
   ],
 };
 

package/src/ontology/shared-section-props/visual-header.ts

@@ -88,7 +88,7 @@ export const SECTION_VISUAL_FRAGMENT: JsonSchemaFragment = {
         },
       },
     },
-    density: { enum: ["compact", "normal", "spacious"] },
+    density: { enum: ["compact", "normal", "spacious", "flush"] },
     tone: { enum: ["default", "warning", "success", "muted"] },
     containerVariant: { enum: ["default", "narrow", "full"] },
     motion: {