@warpgogol/werkstatt-shared 0.14.0 → 0.15.0

package/src/semantic/jsonld/tests/video.test.ts

@@ -0,0 +1,84 @@
+import { describe, expect, it } from "vitest";
+import { buildVideoObjectNodes } from "../video.ts";
+import { createJsonLdContext } from "../context.ts";
+import { makePage } from "../../tests/helpers.ts";
+
+describe("buildVideoObjectNodes", () => {
+  it("returns empty array when no blocks have video data", () => {
+    const page = makePage({ blocks: [{ id: "b1", heading: "Test" }] });
+    const ctx = createJsonLdContext(page);
+    expect(buildVideoObjectNodes(ctx)).toEqual([]);
+  });
+
+  it("builds VideoObject nodes for blocks with video data", () => {
+    const page = makePage({
+      blocks: [
+        {
+          id: "vid-1",
+          heading: "Video Section",
+          video: {
+            seo: { name: "Intro Video", description: "An intro", uploadDate: "2024-01-15" },
+            manifest: {
+              posterUrl: "https://example.com/poster.jpg",
+              contentUrl: "https://example.com/video.mp4",
+              durationSec: 90,
+            },
+          },
+        },
+      ],
+    });
+    const ctx = createJsonLdContext(page);
+    const nodes = buildVideoObjectNodes(ctx);
+    expect(nodes).toHaveLength(1);
+    expect(nodes[0]["@type"]).toBe("VideoObject");
+    expect(nodes[0].name).toBe("Intro Video");
+    expect(nodes[0].description).toBe("An intro");
+    expect(nodes[0].uploadDate).toBe("2024-01-15");
+    expect(nodes[0].thumbnailUrl).toBe("https://example.com/poster.jpg");
+    expect(nodes[0].contentUrl).toBe("https://example.com/video.mp4");
+    expect(nodes[0].duration).toBe("PT1M30S");
+  });
+
+  it("formats duration correctly for hours, minutes, seconds", () => {
+    const page = makePage({
+      blocks: [
+        {
+          id: "vid-2",
+          heading: "Long Video",
+          video: {
+            seo: { name: "Long", description: "Long", uploadDate: "2024-01-15" },
+            manifest: {
+              posterUrl: "https://example.com/p.jpg",
+              contentUrl: "https://example.com/v.mp4",
+              durationSec: 3661,
+            },
+          },
+        },
+      ],
+    });
+    const ctx = createJsonLdContext(page);
+    const nodes = buildVideoObjectNodes(ctx);
+    expect(nodes[0].duration).toBe("PT1H1M1S");
+  });
+
+  it("omits duration when durationSec is not provided", () => {
+    const page = makePage({
+      blocks: [
+        {
+          id: "vid-3",
+          heading: "No Duration",
+          video: {
+            seo: { name: "NoDur", description: "No dur", uploadDate: "2024-01-15" },
+            manifest: {
+              posterUrl: "https://example.com/p.jpg",
+              contentUrl: "https://example.com/v.mp4",
+            },
+          },
+        },
+      ],
+    });
+    const ctx = createJsonLdContext(page);
+    const nodes = buildVideoObjectNodes(ctx);
+    expect(nodes[0].duration).toBeUndefined();
+  });
+});

package/src/semantic/jsonld/tests/webpage.test.ts

@@ -0,0 +1,93 @@
+import { describe, expect, it } from "vitest";
+import { buildWebPageNode } from "../webpage.ts";
+import { createJsonLdContext } from "../context.ts";
+import { makePage } from "../../tests/helpers.ts";
+
+describe("buildWebPageNode", () => {
+  it("builds WebPage node for content type", () => {
+    const page = makePage({ type: "content" });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node["@type"]).toEqual(["WebPage"]);
+    expect(node["@id"]).toBe(ctx.webpageId);
+    expect(node.url).toBe(page.url);
+    expect(node.name).toBe("Test Page");
+    expect(node.description).toBe("A test page description");
+    expect(node.inLanguage).toBe("de");
+  });
+
+  it("uses heading for name when available", () => {
+    const page = makePage({ heading: "Custom Heading" });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node.headline).toBe("Custom Heading");
+  });
+
+  it("uses title for headline", () => {
+    const page = makePage({ title: "Page Title" });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node.name).toBe("Page Title");
+  });
+
+  it("emits CollectionPage for collection type", () => {
+    const page = makePage({ type: "collection" });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node["@type"]).toEqual(["WebPage", "CollectionPage"]);
+  });
+
+  it("emits AboutPage for about type", () => {
+    const page = makePage({ type: "about" });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node["@type"]).toEqual(["WebPage", "AboutPage"]);
+  });
+
+  it("emits ProfilePage for person type", () => {
+    const page = makePage({ type: "person" });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node["@type"]).toEqual(["WebPage", "ProfilePage"]);
+  });
+
+  it("links to organization via publisher", () => {
+    const page = makePage();
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node.publisher).toEqual({ "@id": ctx.ids.organization });
+  });
+
+  it("links to breadcrumb when breadcrumbs > 1", () => {
+    const page = makePage({
+      breadcrumbs: [
+        { name: "Home", url: "https://example.com/de/" },
+        { name: "Page", url: "https://example.com/de/page/" },
+      ],
+    });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node.breadcrumb).toEqual({ "@id": ctx.breadcrumbId });
+  });
+
+  it("omits breadcrumb when only one crumb", () => {
+    const page = makePage({
+      breadcrumbs: [{ name: "Home", url: "https://example.com/de/" }],
+    });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node.breadcrumb).toBeUndefined();
+  });
+
+  it("emits primaryImage when present", () => {
+    const page = makePage({
+      primaryImage: { url: "https://example.com/img.jpg" },
+    });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebPageNode(ctx);
+    expect(node.primaryImageOfPage).toEqual({
+      "@type": "ImageObject",
+      url: "https://example.com/img.jpg",
+    });
+  });
+});

package/src/semantic/jsonld/tests/website.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "vitest";
+import { buildWebSiteNode } from "../website.ts";
+import { createJsonLdContext } from "../context.ts";
+import { makePage } from "../../tests/helpers.ts";
+
+describe("buildWebSiteNode", () => {
+  it("builds WebSite node with organization URL and language", () => {
+    const page = makePage({ lang: "de" });
+    const ctx = createJsonLdContext(page);
+    const node = buildWebSiteNode(ctx);
+    expect(node["@type"]).toBe("WebSite");
+    expect(node["@id"]).toBe(ctx.ids.website);
+    expect(node.url).toBe(page.organization.url);
+    expect(node.inLanguage).toBe("de");
+    expect(node.publisher).toEqual({ "@id": ctx.ids.organization });
+  });
+
+  it("uses organization name for WebSite name", () => {
+    const page = makePage({
+      organization: makePage().organization,
+    });
+    page.organization.name = "Test Org";
+    const ctx = createJsonLdContext(page);
+    const node = buildWebSiteNode(ctx);
+    expect(node.name).toBe("Test Org");
+  });
+});

package/src/semantic/jsonld/types.ts

@@ -0,0 +1,24 @@
+// test-adjacency: exempt — pure type definitions
+/*
+<MODULE_CONTRACT>
+<purpose>Maintains packages/share/src/semantic/jsonld/types.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
+<non-goals>
+  <item>Do not implement JSON-LD processing logic.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
+</CHANGE_SUMMARY>
+*/
+
+export type JsonLdNode = Record<string, unknown>;
+
+export type JsonLdDocument = {
+  "@context": "https://schema.org";
+  "@graph": JsonLdNode[];
+};

package/src/{share/semantic → semantic}/jsonld/webpage.ts

@@ -6,8 +6,13 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added type expansion for donate/faq/news page variants.</item>
   <item>RFC-0372: speakable reads from unified page.blocks instead of answerBlocks.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/src/semantic/jsonld/website.ts

@@ -0,0 +1,32 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Maintains packages/share/src/semantic/jsonld/website.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
+<non-goals>
+  <item>Do not parse raw content.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
+</CHANGE_SUMMARY>
+*/
+
+import type { JsonLdContext } from "./context.ts";
+import type { JsonLdNode } from "./types.ts";
+
+export function buildWebSiteNode(context: JsonLdContext): JsonLdNode {
+  const { page, ids } = context;
+
+  return {
+    "@type": "WebSite",
+    "@id": ids.website,
+    url: page.organization.url,
+    name: page.organization.name,
+    inLanguage: page.lang,
+    publisher: { "@id": ids.organization },
+  };
+}

package/src/{share/semantic → semantic}/jsonld.ts

@@ -7,8 +7,13 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added initiative list graph node, breadcrumb fallback, and shared dedupe utility.</item>
   <item>RFC-0912: added VideoObject node composition for opted-in content video blocks.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/src/{share/semantic → semantic}/llms.ts

@@ -7,9 +7,16 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added full llms.txt generation and optional title-aware page labels.</item>
-  <item>RFC-0184: canonical Markdown links, blockquoted summary, absolute URLs, llms-full.txt reference, and empty-section filtering.</item>
   <item>RFC-0372: formatBlocks reads from unified page.blocks instead of answerBlocks + contentBlocks.</item>
+  <item>RFC-1075: emit canonicalUri for organization and offer in llms-full.txt.</item>
+  <item>RFC-1076: add formatClaims section in buildLlmsFull for claim provenance.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
+  <history>RFC-0184</history>
 </CHANGE_SUMMARY>
 */
 
@@ -119,6 +126,9 @@ function formatInitiatives(page: SemanticPageModel): string {
 
 function formatOrganizationFacts(site: SemanticSiteModel): string[] {
   return [
+    ...(site.organization.canonicalUri
+      ? [`- Canonical URI: ${site.organization.canonicalUri}`]
+      : []),
     `- Name: ${site.organization.legalName ?? site.organization.name}`,
     ...(site.organization.foundingYear ? [`- Founded: ${site.organization.foundingYear}`] : []),
     ...(site.organization.registration
@@ -182,7 +192,8 @@ function formatOffer(site: SemanticSiteModel): string[] {
   const offer = site.organization.offer;
   if (
     !offer ||
-    (!offer.prices?.length &&
+    (!offer.canonicalUri &&
+      !offer.prices?.length &&
       !offer.guarantees?.length &&
       !offer.growthModules?.length &&
       !offer.changePrice &&
@@ -192,6 +203,9 @@ function formatOffer(site: SemanticSiteModel): string[] {
     return [];
   }
   const lines: string[] = ["## Offer"];
+  if (offer.canonicalUri) {
+    lines.push(`- Canonical URI: ${offer.canonicalUri}`);
+  }
   if (offer.prices?.length) {
     lines.push(...offer.prices.map((price) => `- ${price.label}: ${price.amount}`));
   }
@@ -281,6 +295,29 @@ function formatTeam(site: SemanticSiteModel): string[] {
   return lines;
 }
 
+/** RFC-1076: render projected claims with their evidence references. */
+function formatClaims(site: SemanticSiteModel): string[] {
+  if (!site.claims?.length) return [];
+  const lines: string[] = ["## Claims"];
+  for (const claim of site.claims) {
+    lines.push(`### ${claim.statement}`);
+    lines.push(`- Class: ${claim.claimClass}`);
+    if (claim.verificationLevel) lines.push(`- Verification: ${claim.verificationLevel}`);
+    if (claim.confidence) lines.push(`- Confidence: ${claim.confidence}`);
+    if (claim.evidence.length > 0) {
+      lines.push("- Evidence:");
+      for (const ref of claim.evidence) {
+        const sha = ref.sha256 ? ` — sha256: ${ref.sha256}` : "";
+        lines.push(`  - ${ref.kind}: ${ref.label}${sha}`);
+      }
+    } else {
+      lines.push("- Evidence: none");
+    }
+  }
+  lines.push("");
+  return lines;
+}
+
 function toAbsoluteUrl(site: SemanticSiteModel, pathname: string): string {
   const rawBase = site.organization.url ?? site.baseUrl;
   const base = (() => {
@@ -380,6 +417,7 @@ export function buildLlmsFull(site: SemanticSiteModel): string {
     ...formatServices(site),
     ...formatLocation(site),
     ...formatTeam(site),
+    ...formatClaims(site),
   ].filter((s) => s.length > 0);
 
   return [

package/src/{share/semantic → semantic}/models.ts

@@ -1,3 +1,4 @@
+// test-adjacency: exempt — pure type definitions
 /*
 <MODULE_CONTRACT>
 <purpose>Defines types for semantic data structures used throughout the Warpgogol ecosystem.</purpose>
@@ -6,49 +7,31 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-0133: backfilled MODULE_MAP and CHANGE_SUMMARY markers for compass.validate compliance.</item>
-  <item>RFC-0165/0167: SemanticImage.contentImage flag + PageOutputProjection.image (author-declared per-page content illustration, single source for image:image + top-precedence og:image).</item>
-  <item>RFC-0328: Added "legal" to the SemanticPageType closed enum.</item>
-  <item>RFC-0490: Added "collection" to the SemanticPageType closed enum.</item>
-  <item>RFC-0508: Added "participant" to the SemanticPageType closed enum.</item>
   <item>RFC-0372: Unified SemanticBlock type replaces SemanticAnswerBlock + SemanticContentBlock; SemanticPageModel.blocks replaces answerBlocks/contentBlocks/bodyText.</item>
   <item>RFC-0912: Added VideoSeoData type and optional SemanticBlock.video field for opted-in content video structured data.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — tail packages clean
+
+Sweep batch 3: rewrote ~95 purposes across werkstatt-knowledge, werkstatt-shared, godot-game, phaser-game, lifecycle-core, projektarchiv-*, portal-*, billing-*, typescript (CONTRACT-02/PURPOSE-02). Real KEY_DECISIONS on 5 godot utils, non-goals on 5 CONTRACT-03 files, headers on 4 headerless files, CS-07 history literal fix on 2 files. Policy: vitest.config.ts + test-fixtures testPatterns, worker-configuration.d.ts excludedPath. All non-site/engine packages now 0 diagnostics.</item>
+  <item>RFC-1106: step 4 — single-source SemanticPageType
+
+semanticPageTypeSchema (ontology/schemas/system/page-output.ts) is now the sole declaration of the closed DNA-19 vocabulary. semantic/models.ts derives the type via z.infer and SEMANTIC_PAGE_TYPES via schema.options — the hand-synced union/array and stale circular-dependency comments are deleted.</item>
+  <history>RFC-0133, RFC-0165, RFC-0328, RFC-0490, RFC-0508</history>
 </CHANGE_SUMMARY>
 */
 
-// NOTE: This closed union is mirrored by `semanticPageTypeSchema` in
-// `@warpgogol/werkstatt-shared/ontology/src/schemas/system.ts`. `share` owns the compile-time
-// contract used by lightweight consumers; `ontology` owns the runtime Zod
-// validator for `system.md`. They are kept in sync manually because deriving
-// one from the other would create a circular dependency between the two
-// packages.
-export type SemanticPageType =
-  | "home"
-  | "about"
-  | "projects"
-  | "donationContact"
-  | "openSource"
-  | "content"
-  | "article"
-  | "person"
-  | "participant"
-  | "legal"
-  | "collection";
-
-/** Runtime counterpart to the `SemanticPageType` closed union. Keep in sync manually. */
-export const SEMANTIC_PAGE_TYPES: readonly SemanticPageType[] = [
-  "home",
-  "about",
-  "projects",
-  "donationContact",
-  "openSource",
-  "content",
-  "article",
-  "person",
-  "participant",
-  "legal",
-  "collection",
-];
+import { z } from "zod";
+import { semanticPageTypeSchema } from "../ontology/schemas/system/page-output.ts";
+
+// RFC-1106: semanticPageTypeSchema (ontology/schemas/system/page-output.ts) is
+// the sole declaration of this closed DNA-19 vocabulary. The type and the
+// runtime array derive from it — no hand-synced mirror.
+export type SemanticPageType = z.infer<typeof semanticPageTypeSchema>;
+
+/** Runtime list of the closed vocabulary — derived from the schema's options. */
+export const SEMANTIC_PAGE_TYPES: readonly SemanticPageType[] = semanticPageTypeSchema.options;
 
 export type SemanticBreadcrumb = {
   name: string;
@@ -235,6 +218,8 @@ export type SemanticOfferCapacity = {
 };
 
 export type SemanticOffer = {
+  /** RFC-1075: persistent canonical URI for Linked Data @id. */
+  canonicalUri?: string;
   prices?: SemanticPrice[];
   guarantees?: SemanticGuarantee[];
   growthModules?: SemanticGrowthModule[];
@@ -268,6 +253,8 @@ export type SemanticFaqEntry = {
 };
 
 export type SemanticOrganization = {
+  /** RFC-1075: persistent canonical URI for Linked Data @id. */
+  canonicalUri?: string;
   name: string;
   legalName?: string;
   description: string;
@@ -416,4 +403,6 @@ export type SemanticSiteModel = {
   pages: SemanticPageModel[];
   /** RFC-0789: agent block from system.md, populated by the semantic loader. */
   agent?: { enabled?: boolean };
+  /** RFC-1076: projected claims with evidence provenance, loaded by the semantic loader. */
+  claims?: import("./business-projection.ts").SemanticClaimProvenance[];
 };

package/src/{share/semantic → semantic}/organization-profile.ts

@@ -9,10 +9,12 @@
 <CHANGE_SUMMARY>
   <item>RFC-0148: extracted the shared org-profile assembler from the disk + Astro builders.</item>
   <item>RFC-0910: Organization.url uses canonicalRootUrl (unprefixed root) instead of language-prefixed path.</item>
+  <item>RFC-1075: populate canonicalUri on SemanticOrganization using deriveCanonicalUri.</item>
 </CHANGE_SUMMARY>
 */
 
 import { canonicalRootUrl, getBaseUrl, toAbsoluteUrl } from "./ids.ts";
+import { deriveCanonicalUri } from "./canonical-uri.ts";
 import type {
   SemanticInitiative,
   SemanticLocation,
@@ -106,6 +108,7 @@ export function buildOrganizationProfile(input: OrganizationProfileInput): Seman
     legalName: input.legalName,
     description: input.description,
     url: canonicalRootUrl(baseUrl),
+    ...({ canonicalUri: deriveCanonicalUri(baseUrl, "business") } as { canonicalUri?: string }),
     foundingYear: input.foundingYear,
     email: input.email,
     registration: input.registration,

package/src/{share/semantic → semantic}/page-builders/markdown-page.ts

@@ -7,10 +7,13 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Consolidated 7 copy-paste page builders (impressum, datenschutz, agb, widerruf, open-source, projekte, wir-ueber-uns) into one generic function.</item>
-  <item>Introduced app-agnostic markdown-page semantic builder and breadcrumb normalization.</item>
-  <item>Unified blocksToMarkdown signature — eliminated duplication.</item>
   <item>RFC-0372: MarkdownPageInput now accepts blocks: SemanticBlock[] directly; removed bodyText/contentBlocks/answerBlocks from input and output.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/src/{share/semantic → semantic}/page-utils.ts

@@ -7,11 +7,14 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Extracted from app semantic pages _shared — framework-agnostic utilities moved to packages/share.</item>
-  <item>Unified single blocksToMarkdown signature (was duplicated with different signatures in app).</item>
-  <item>Added slugify export and markdown answer-block extraction utilities.</item>
   <item>RFC-0372: toSemanticAnswerBlocks now returns SemanticBlock[] with blockType: "prose".</item>
   <item>RFC-0915: replaced slugify import from extract.ts with slugId from canonical slug module.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/src/semantic/tests/ai.test.ts

@@ -0,0 +1,55 @@
+import { describe, expect, it } from "vitest";
+import { buildAiTxt } from "../ai.ts";
+
+describe("buildAiTxt", () => {
+  it("generates header from siteUrl", () => {
+    const result = buildAiTxt({ policy: "allow" }, "https://example.com");
+    expect(result).toContain("# ai.txt for example.com");
+    expect(result).toContain("policy: allow");
+  });
+
+  it("includes version and updated", () => {
+    const result = buildAiTxt({ policy: "allow", version: "1.0", updated: "2024-01-01" }, "https://example.com");
+    expect(result).toContain("version: 1.0");
+    expect(result).toContain("updated: 2024-01-01");
+  });
+
+  it("includes optional fields when provided", () => {
+    const result = buildAiTxt({
+      policy: "limited",
+      training: "disallow",
+      usage: ["search", "summarization"],
+      commercial: "no",
+      attribution: "required",
+      license: "CC-BY-4.0",
+    }, "https://example.com");
+    expect(result).toContain("training: disallow");
+    expect(result).toContain("usage: search, summarization");
+    expect(result).toContain("commercial: no");
+    expect(result).toContain("attribution: required");
+    expect(result).toContain("license: CC-BY-4.0");
+  });
+
+  it("emits provider sections", () => {
+    const result = buildAiTxt({
+      policy: "allow",
+      providers: [
+        { name: "OpenAI", policy: "disallow", training: "disallow" },
+        { name: "Anthropic", policy: "allow", url: "https://anthropic.com" },
+      ],
+    }, "https://example.com");
+    expect(result).toContain("[OpenAI]");
+    expect(result).toContain("[Anthropic]");
+    expect(result).toContain("url: https://anthropic.com");
+  });
+
+  it("includes url and contact in header comments", () => {
+    const result = buildAiTxt({
+      policy: "allow",
+      url: "https://example.com/policy",
+      contact: "info@example.com",
+    }, "https://example.com");
+    expect(result).toContain("# See: https://example.com/policy");
+    expect(result).toContain("# Contact: info@example.com");
+  });
+});

package/src/semantic/tests/block-extraction.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, it } from "vitest";
+import { BlockExtractorRegistry, BLOCK_EXTRACTORS } from "../block-extraction.ts";
+import "../block-extractors/index.ts";
+
+describe("BlockExtractorRegistry", () => {
+  it("registers and retrieves extractors", () => {
+    const registry = new BlockExtractorRegistry();
+    registry.register({
+      blockType: "test-block",
+      extract: () => ({ heading: "Test" }),
+    });
+    expect(registry.has("test-block")).toBe(true);
+    expect(registry.get("test-block")?.blockType).toBe("test-block");
+  });
+
+  it("returns undefined for unregistered type", () => {
+    const registry = new BlockExtractorRegistry();
+    expect(registry.get("nonexistent")).toBeUndefined();
+  });
+
+  it("lists registered types", () => {
+    const registry = new BlockExtractorRegistry();
+    registry.register({ blockType: "a", extract: () => ({}) });
+    registry.register({ blockType: "b", extract: () => ({}) });
+    expect(registry.listTypes().sort()).toEqual(["a", "b"]);
+  });
+});
+
+describe("BLOCK_EXTRACTORS", () => {
+  it("is a registry instance with pre-registered extractors", () => {
+    expect(BLOCK_EXTRACTORS).toBeInstanceOf(BlockExtractorRegistry);
+    expect(BLOCK_EXTRACTORS.listTypes().length).toBeGreaterThan(0);
+  });
+});

package/src/{share/tests/breadcrumbs.test.ts → semantic/tests/breadcrumbs-0229.test.ts}

@@ -14,7 +14,7 @@ import {
   surfaceAncestorPageIds,
   type BreadcrumbAncestorResolver,
   type BreadcrumbCrumb,
-} from "../semantic/breadcrumbs.ts";
+} from "../breadcrumbs.ts";
 
 const HOME = "https://example.com/";
 const SELF = "https://example.com/website/schreiner/muenchen/";