@warpgogol/werkstatt-shared 0.14.0 → 0.14.1

package/README.md

@@ -4,6 +4,8 @@
 
 Stack-agnostic shared infrastructure extracted from `werkstatt-site` (RFC-0868). Owns checks, integration, ontology, passport, share, and surface domains consumed by both the Werkstatt engine and the site plugin.
 
+> Engineered at [Warpgogol](https://warpgogol.com) · Released as open source.
+
 ---
 
 ## What this package does
@@ -62,36 +64,36 @@ const url = slugUrl("Über uns", "de"); // "ueber-uns"
 
 ### Semantic extraction (RFC-0901)
 
-| Export | Purpose |
-| --- | --- |
+| Export                          | Purpose                                                     |
+| ------------------------------- | ----------------------------------------------------------- |
 | `splitSentences(text, locale?)` | Locale-aware sentence boundary detection (`de`, `uk`, `en`) |
 
 ### Canonical entity URL (RFC-0910)
 
-| Export | Purpose |
-| --- | --- |
+| Export                      | Purpose                                         |
+| --------------------------- | ----------------------------------------------- |
 | `canonicalRootUrl(baseUrl)` | Unprefixed root URL for JSON-LD entity identity |
 
 ### Placeholder route filtering (RFC-0917)
 
-| Export | Purpose |
-| --- | --- |
+| Export                         | Purpose                                                      |
+| ------------------------------ | ------------------------------------------------------------ |
 | `hasPlaceholderRoutes(routes)` | Detect Astro dynamic route templates (`[slug]`, `[version]`) |
 
 ---
 
 ## Architecture
 
-| Directory | Purpose |
-| --- | --- |
-| `src/index.ts` | Main barrel export |
-| `src/checks/` | Content validators, SEO validators, surface expand/bake |
-| `src/integration/` | CRM, funnel, hub, sharding, QStash adapters |
-| `src/ontology/` | Catalogs, enums, Sternsystem owner types |
-| `src/passport/` | DHT signing, identity signing, schema validation |
-| `src/share/` | Slug, semantic, URL canonicalization, routes, middleware, access protection |
-| `src/surface/` | Surface expand/bake helpers and labels |
-| `src/content/` | SystemManifest types and content schema |
+| Directory          | Purpose                                                                     |
+| ------------------ | --------------------------------------------------------------------------- |
+| `src/index.ts`     | Main barrel export                                                          |
+| `src/checks/`      | Content validators, SEO validators, surface expand/bake                     |
+| `src/integration/` | CRM, funnel, hub, sharding, QStash adapters                                 |
+| `src/ontology/`    | Catalogs, enums, Sternsystem owner types                                    |
+| `src/passport/`    | DHT signing, identity signing, schema validation                            |
+| `src/share/`       | Slug, semantic, URL canonicalization, routes, middleware, access protection |
+| `src/surface/`     | Surface expand/bake helpers and labels                                      |
+| `src/content/`     | SystemManifest types and content schema                                     |
 
 ---
 
@@ -133,3 +135,11 @@ After CI completes, verify the new version on [npmjs.com/package/@warpgogol/werk
 ## License
 
 Apache-2.0
+
+## Open Engineering
+
+This package originated from production engineering work at [Warpgogol](https://warpgogol.com), an engineering studio in Germany.
+
+We publish reusable parts of our infrastructure when they can be useful beyond our own projects. It is published independently of any Warpgogol commercial service. Using this package does not create any dependency on Warpgogol.
+
+Built for real systems. Shared openly.

package/README.uk.md

@@ -4,6 +4,8 @@
 
 Спільна інфраструктура, незалежна від стеку, витягнута з `werkstatt-site` (RFC-0868). Володіє доменами checks, integration, ontology, passport, share та surface, які споживають рушій Werkstatt та site-плагін.
 
+> Розроблено в [Warpgogol](https://warpgogol.com) · Опубліковано як open source.
+
 ---
 
 ## Що робить цей пакет
@@ -62,14 +64,14 @@ const url = slugUrl("Über uns", "de"); // "ueber-uns"
 
 ### Семантична екстракція (RFC-0901)
 
-| Експорт | Призначення |
-| --- | --- |
+| Експорт                         | Призначення                                          |
+| ------------------------------- | ---------------------------------------------------- |
 | `splitSentences(text, locale?)` | Локалізоване виявлення меж речень (`de`, `uk`, `en`) |
 
 ### Канонічний URL сутності (RFC-0910)
 
-| Експорт | Призначення |
-| --- | --- |
+| Експорт                     | Призначення                                                     |
+| --------------------------- | --------------------------------------------------------------- |
 | `canonicalRootUrl(baseUrl)` | Непрефіксований кореневий URL для JSON-LD ідентичності сутності |
 
 ### Фільтрація плейсхолдер-маршрутів (RFC-0917)
@@ -82,16 +84,16 @@ const url = slugUrl("Über uns", "de"); // "ueber-uns"
 
 ## Архітектура
 
-| Директорія | Призначення |
-| --- | --- |
-| `src/index.ts` | Головний barrel-експорт |
-| `src/checks/` | Валідатори контенту, SEO-валідатори, surface expand/bake |
-| `src/integration/` | Адаптери CRM, funnel, hub, sharding, QStash |
-| `src/ontology/` | Каталоги, enum-и, типи Sternsystem owner |
-| `src/passport/` | DHT-підписування, підписування ідентичності, валідація схем |
-| `src/share/` | Slug, семантика, канонізація URL, маршрути, middleware, захист доступу |
-| `src/surface/` | Хелпери surface expand/bake та мітки |
-| `src/content/` | Типи SystemManifest та схема контенту |
+| Директорія         | Призначення                                                            |
+| ------------------ | ---------------------------------------------------------------------- |
+| `src/index.ts`     | Головний barrel-експорт                                                |
+| `src/checks/`      | Валідатори контенту, SEO-валідатори, surface expand/bake               |
+| `src/integration/` | Адаптери CRM, funnel, hub, sharding, QStash                            |
+| `src/ontology/`    | Каталоги, enum-и, типи Sternsystem owner                               |
+| `src/passport/`    | DHT-підписування, підписування ідентичності, валідація схем            |
+| `src/share/`       | Slug, семантика, канонізація URL, маршрути, middleware, захист доступу |
+| `src/surface/`     | Хелпери surface expand/bake та мітки                                   |
+| `src/content/`     | Типи SystemManifest та схема контенту                                  |
 
 ---
 
@@ -133,3 +135,11 @@ pnpm exec repo-extract --config packages/werkstatt-shared/extract.config.yaml --
 ## Ліцензія
 
 Apache-2.0
+
+## Відкрита інженерія
+
+Цей пакет походить із виробничої інженерної роботи в [Warpgogol](https://warpgogol.com), інженерній студії в Німеччині.
+
+Ми публікуємо багаторазові частини нашої інфраструктури, коли вони можуть бути корисними поза нашими власними проєктами. Він публікується незалежно від будь-якого комерційного сервісу Warpgogol. Використання цього пакету не створює жодної залежності від Warpgogol.
+
+Створено для реальних систем. Поширюється відкрито.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/werkstatt-shared",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "private": false,
   "type": "module",
   "engines": {
@@ -262,6 +262,10 @@
       "types": "./src/share/redirects.ts",
       "default": "./src/share/redirects.ts"
     },
+    "./share/remediation": {
+      "types": "./src/share/remediation/remediation-catalog.ts",
+      "default": "./src/share/remediation/remediation-catalog.ts"
+    },
     "./share/rfc0042-utils": {
       "types": "./src/share/rfc0042-utils.ts",
       "default": "./src/share/rfc0042-utils.ts"
@@ -1309,6 +1313,7 @@
     "build": "pnpm exec tsc -p tsconfig.json --noEmit",
     "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest"
   },
   "publishConfig": {
@@ -1350,6 +1355,7 @@
     "gsap": "^3.15.0",
     "typescript": "^6.0.3",
     "typescript-eslint": "8.68.0",
+    "@vitest/coverage-v8": "^4.1.11",
     "vitest": "^4.1.11"
   },
   "packageManager": "pnpm@11.10.0"

package/src/checks/result-helpers.ts

@@ -13,6 +13,7 @@ ruleId = command; diagnosticsResult takes rich Diagnostic[] with registered ids.
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0029 review: Initial creation to fix systemic exit-code bug across check files.</item>
+  <item>RFC-1027: Auto-populate Diagnostic.remediation from REMEDIATION_CATALOG in diagnosticsResult().</item>
 </CHANGE_SUMMARY>
 */
 
@@ -22,6 +23,7 @@ import type {
   KernelCommandResult,
   KernelNextStep,
 } from "@warpgogol/werkstatt-engine/kernel";
+import { lookupRemediation } from "../share/remediation/remediation-catalog.ts";
 
 function defaultFailNextSteps(command: string): KernelNextStep[] {
   return [
@@ -66,10 +68,25 @@ export function diagnosticsResult(
   diagnostics: Diagnostic[],
   nextSteps?: KernelNextStep[],
 ): KernelCommandResult<CheckResult> {
+  const enrichedDiagnostics = diagnostics.map((d) => {
+    if (d.remediation) return d;
+    const pattern = lookupRemediation(d.ruleId);
+    if (!pattern) return d;
+    return {
+      ...d,
+      remediation: {
+        ruleId: pattern.ruleId,
+        action: pattern.action,
+        ...(pattern.template !== undefined && { template: pattern.template }),
+        ...(pattern.docRef !== undefined && { docRef: pattern.docRef }),
+        ...(pattern.targetFiles !== undefined && { targetFiles: pattern.targetFiles }),
+      },
+    };
+  });
   const summary = {
-    error: diagnostics.filter((d) => d.severity === "error").length,
-    warning: diagnostics.filter((d) => d.severity === "warning").length,
-    info: diagnostics.filter((d) => d.severity === "info").length,
+    error: enrichedDiagnostics.filter((d) => d.severity === "error").length,
+    warning: enrichedDiagnostics.filter((d) => d.severity === "warning").length,
+    info: enrichedDiagnostics.filter((d) => d.severity === "info").length,
   };
   const status: CheckResult["status"] =
     summary.error > 0 ? "fail" : summary.warning > 0 ? "warn" : "pass";
@@ -77,7 +94,7 @@ export function diagnosticsResult(
     nextSteps ?? (summary.error > 0 ? defaultFailNextSteps(command) : undefined);
   const counts = formatCounts(summary.error, summary.warning);
   return {
-    data: { command, status, diagnostics, summary },
+    data: { command, status, diagnostics: enrichedDiagnostics, summary },
     exitCode: summary.error > 0 ? 1 : 0,
     summary: counts ? `[${command}] ${counts}` : `[${command}]`,
     nextSteps: resolvedNextSteps,

package/src/checks/tests/remediation-auto-populate.test.ts

@@ -0,0 +1,83 @@
+/*
+<MODULE_CONTRACT>
+  <purpose>RFC-1027: unit tests for diagnosticsResult() remediation auto-population.</purpose>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1027: initial tests for remediation auto-population from REMEDIATION_CATALOG.</item>
+</CHANGE_SUMMARY>
+*/
+
+import { test, expect } from "vitest";
+import { diagnosticsResult } from "../result-helpers.ts";
+import type { Diagnostic } from "@warpgogol/werkstatt-engine/kernel";
+
+test("diagnosticsResult: auto-populates remediation from catalog for known ruleId", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "GEN-FILES-01",
+      severity: "error",
+      message: "Generated file is stale",
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation).toBeDefined();
+  expect(result.data!.diagnostics[0].remediation?.ruleId).toBe("GEN-FILES-01");
+  expect(result.data!.diagnostics[0].remediation?.action).toContain("Regenerate");
+  expect(result.data!.diagnostics[0].remediation?.docRef).toBe(
+    "docs/authoring/generated-files-and-templates.md",
+  );
+});
+
+test("diagnosticsResult: does not overwrite existing remediation field", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "GEN-FILES-01",
+      severity: "error",
+      message: "Stale file",
+      remediation: {
+        ruleId: "GEN-FILES-01",
+        action: "Custom action — do not overwrite",
+      },
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation?.action).toBe("Custom action — do not overwrite");
+});
+
+test("diagnosticsResult: no remediation for unknown ruleId", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "UNKNOWN-RULE-999",
+      severity: "warning",
+      message: "Some warning",
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation).toBeUndefined();
+});
+
+test("diagnosticsResult: preserves fixHint alongside remediation", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "GEN-FILES-01",
+      severity: "error",
+      message: "Stale",
+      fixHint: "Run the generator",
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].fixHint).toBe("Run the generator");
+  expect(result.data!.diagnostics[0].remediation).toBeDefined();
+});
+
+test("diagnosticsResult: multiple diagnostics get independent remediation", () => {
+  const diagnostics: Diagnostic[] = [
+    { ruleId: "GEN-FILES-01", severity: "error", message: "err 1" },
+    { ruleId: "PARITY-SECTION-COUNT", severity: "error", message: "err 2" },
+    { ruleId: "UNKNOWN", severity: "info", message: "info 1" },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation?.ruleId).toBe("GEN-FILES-01");
+  expect(result.data!.diagnostics[1].remediation?.ruleId).toBe("PARITY-SECTION-COUNT");
+  expect(result.data!.diagnostics[2].remediation).toBeUndefined();
+});

package/src/integration/vitest.config.ts

@@ -4,5 +4,12 @@ export default defineConfig({
   test: {
     environment: "node",
     include: ["src/**/*.test.ts"],
+    coverage: {
+      provider: "v8",
+      reporter: ["json", "json-summary", "text-summary", "html"],
+      reportsDirectory: "../../.coverage/integration",
+      include: ["src/integration/**/*.ts"],
+      exclude: ["src/integration/**/*.test.ts", "src/integration/**/*.d.ts"],
+    },
   },
 });

package/src/ontology/manifest.ts

@@ -305,6 +305,25 @@ export const componentManifestSchema = manifestBaseSchema.extend({
    * Do not use these five names for any other component manifest.
    */
   cosmicName: moonNameSchema,
+  /**
+   * RFC-1023: JSON Schema (draft-07 compatible) describing the shape of
+   * resolved content returned by getResolvedComponentContent. This is the
+   * flat, merged content (after pageOverride merge), NOT the prose .md
+   * frontmatter schema. Used by props.types.generate to emit
+   * XxxComponentContent interfaces. Required for content-driven components
+   * (those that call getResolvedComponentContent). Optional for structural
+   * components that consume no content.
+   */
+  contentSchema: z.record(z.string(), z.unknown()).optional(),
+  /**
+   * RFC-1023: JSON Schema (draft-07 compatible) describing the shape of
+   * Astro.props accepted by the component — caller-supplied props such as
+   * lang, defaultLang, pageOverride, etc. Used by props.types.generate to
+   * emit XxxComponentProps interfaces. Distinct from contentSchema: propsSchema
+   * describes what the caller passes, contentSchema describes what the
+   * component resolves from content files.
+   */
+  propsSchema: z.record(z.string(), z.unknown()).optional(),
 });
 
 /**

package/src/ontology/schemas/system/tests/growth.test.ts

@@ -0,0 +1,22 @@
+import { describe, it, expect } from "vitest";
+import { systemGrowthSchema, growthVendorSchema } from "../growth.ts";
+
+describe("growthVendorSchema", () => {
+  it("is defined", () => {
+    expect(growthVendorSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => growthVendorSchema.parse(null)).toThrow();
+  });
+});
+
+describe("systemGrowthSchema", () => {
+  it("is defined", () => {
+    expect(systemGrowthSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemGrowthSchema.parse(null)).toThrow();
+  });
+});

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

@@ -0,0 +1,12 @@
+import { describe, it, expect } from "vitest";
+import { systemIntegrationsSchema } from "../integrations.ts";
+
+describe("systemIntegrationsSchema", () => {
+  it("is defined", () => {
+    expect(systemIntegrationsSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemIntegrationsSchema.parse(null)).toThrow();
+  });
+});

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

@@ -0,0 +1,22 @@
+import { describe, it, expect } from "vitest";
+import { systemManifestSchema, systemCollectionSchema } from "../manifest.ts";
+
+describe("systemManifestSchema", () => {
+  it("is defined", () => {
+    expect(systemManifestSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemManifestSchema.parse(null)).toThrow();
+  });
+});
+
+describe("systemCollectionSchema", () => {
+  it("is defined", () => {
+    expect(systemCollectionSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemCollectionSchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/system/tests/page-output.test.ts

@@ -0,0 +1,13 @@
+import { describe, it, expect } from "vitest";
+import { semanticPageTypeSchema } from "../page-output.ts";
+
+describe("semanticPageTypeSchema", () => {
+  it("accepts valid page types", () => {
+    const result = semanticPageTypeSchema.safeParse("home");
+    expect(result.success).toBe(true);
+  });
+
+  it("rejects invalid page type", () => {
+    expect(() => semanticPageTypeSchema.parse("invalid-type")).toThrow();
+  });
+});

package/src/ontology/schemas/system/tests/release.test.ts

@@ -0,0 +1,22 @@
+import { describe, it, expect } from "vitest";
+import { systemPassportSchema, systemReleaseSchema } from "../release.ts";
+
+describe("systemPassportSchema", () => {
+  it("is defined", () => {
+    expect(systemPassportSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemPassportSchema.parse(null)).toThrow();
+  });
+});
+
+describe("systemReleaseSchema", () => {
+  it("is defined", () => {
+    expect(systemReleaseSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemReleaseSchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/system/tests/text.test.ts

@@ -0,0 +1,18 @@
+import { describe, it, expect } from "vitest";
+import { systemTextSchema, systemTextNormalizeSchema } from "../text.ts";
+
+describe("systemTextSchema", () => {
+  it("is defined", () => {
+    expect(systemTextSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemTextSchema.parse(null)).toThrow();
+  });
+});
+
+describe("systemTextNormalizeSchema", () => {
+  it("is defined", () => {
+    expect(systemTextNormalizeSchema).toBeDefined();
+  });
+});

package/src/ontology/schemas/system/tests/verification.test.ts

@@ -0,0 +1,12 @@
+import { describe, it, expect } from "vitest";
+import { systemVerificationSchema } from "../verification.ts";
+
+describe("systemVerificationSchema", () => {
+  it("is defined", () => {
+    expect(systemVerificationSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => systemVerificationSchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/tests/biome.test.ts

@@ -0,0 +1,19 @@
+import { describe, it, expect } from "vitest";
+import { biomeProvenanceSchema, biomeAxesSchema } from "../biome.ts";
+
+describe("biomeProvenanceSchema", () => {
+  it("is defined", () => {
+    expect(biomeProvenanceSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => biomeProvenanceSchema.parse(null)).toThrow();
+  });
+});
+
+describe("biomeAxesSchema", () => {
+  it("is defined and parseable", () => {
+    expect(biomeAxesSchema).toBeDefined();
+    expect(() => biomeAxesSchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/tests/capability.test.ts

@@ -0,0 +1,22 @@
+import { describe, it, expect } from "vitest";
+import { capabilityInputOutputSchema, capabilityRecordSchema } from "../capability.ts";
+
+describe("capabilityInputOutputSchema", () => {
+  it("is defined", () => {
+    expect(capabilityInputOutputSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => capabilityInputOutputSchema.parse(null)).toThrow();
+  });
+});
+
+describe("capabilityRecordSchema", () => {
+  it("is defined", () => {
+    expect(capabilityRecordSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => capabilityRecordSchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/tests/constellation.test.ts

@@ -0,0 +1,22 @@
+import { describe, it, expect } from "vitest";
+import { constellationSlotSchema, constellationSchema } from "../constellation.ts";
+
+describe("constellationSlotSchema", () => {
+  it("is defined", () => {
+    expect(constellationSlotSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => constellationSlotSchema.parse(null)).toThrow();
+  });
+});
+
+describe("constellationSchema", () => {
+  it("is defined", () => {
+    expect(constellationSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => constellationSchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/tests/dns-records.test.ts

@@ -0,0 +1,13 @@
+import { describe, it, expect } from "vitest";
+import { dnsRecordTypeSchema } from "../dns-records.ts";
+
+describe("dnsRecordTypeSchema", () => {
+  it("accepts valid DNS record types", () => {
+    const result = dnsRecordTypeSchema.safeParse("A");
+    expect(result.success).toBe(true);
+  });
+
+  it("rejects invalid type", () => {
+    expect(() => dnsRecordTypeSchema.parse("INVALID")).toThrow();
+  });
+});

package/src/ontology/schemas/tests/manifest-resolver.test.ts

@@ -0,0 +1,13 @@
+import { describe, it, expect } from "vitest";
+import { getSectionPropsSchema } from "../manifest-resolver.ts";
+
+describe("getSectionPropsSchema", () => {
+  it("is an async function", () => {
+    expect(typeof getSectionPropsSchema).toBe("function");
+  });
+
+  it("returns null for unknown archetype", async () => {
+    const result = await getSectionPropsSchema("nonexistent-archetype", "/nonexistent");
+    expect(result).toBeNull();
+  });
+});

package/src/ontology/schemas/tests/page-entry.test.ts

@@ -0,0 +1,22 @@
+import { describe, it, expect } from "vitest";
+import { BlockEntrySchema, PageEntrySchema } from "../page-entry.ts";
+
+describe("BlockEntrySchema", () => {
+  it("is defined", () => {
+    expect(BlockEntrySchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => BlockEntrySchema.parse(null)).toThrow();
+  });
+});
+
+describe("PageEntrySchema", () => {
+  it("is defined", () => {
+    expect(PageEntrySchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => PageEntrySchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/tests/section-archetype.test.ts

@@ -0,0 +1,12 @@
+import { describe, it, expect } from "vitest";
+import { sectionArchetypeSchema } from "../section-archetype.ts";
+
+describe("sectionArchetypeSchema", () => {
+  it("is defined", () => {
+    expect(sectionArchetypeSchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => sectionArchetypeSchema.parse(null)).toThrow();
+  });
+});

package/src/ontology/schemas/tests/site-family.test.ts

@@ -0,0 +1,18 @@
+import { describe, it, expect } from "vitest";
+import { siteFamilySchema, SiteFamilyContract } from "../site-family.ts";
+
+describe("siteFamilySchema", () => {
+  it("is defined", () => {
+    expect(siteFamilySchema).toBeDefined();
+  });
+
+  it("rejects null", () => {
+    expect(() => siteFamilySchema.parse(null)).toThrow();
+  });
+});
+
+describe("SiteFamilyContract", () => {
+  it("is the same schema as siteFamilySchema", () => {
+    expect(SiteFamilyContract).toBe(siteFamilySchema);
+  });
+});

package/src/ontology/schemas/tests/system.test.ts

@@ -0,0 +1,20 @@
+import { describe, it, expect } from "vitest";
+import * as systemModule from "../system.ts";
+
+describe("system.ts barrel re-exports", () => {
+  it("re-exports systemManifestSchema", () => {
+    expect(systemModule.systemManifestSchema).toBeDefined();
+  });
+
+  it("re-exports systemIntegrationsSchema", () => {
+    expect(systemModule.systemIntegrationsSchema).toBeDefined();
+  });
+
+  it("re-exports systemPassportSchema", () => {
+    expect(systemModule.systemPassportSchema).toBeDefined();
+  });
+
+  it("re-exports systemReleaseSchema", () => {
+    expect(systemModule.systemReleaseSchema).toBeDefined();
+  });
+});