@warpgogol/werkstatt-shared 0.14.1 → 0.16.0

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

@@ -6,9 +6,13 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added Service JSON-LD generation.</item>
-  <item>Moved from app semantic/jsonld/service to packages/share.</item>
   <item>RFC-0498: extend buildServiceNodes to gate Service emission by per-depth policy for all surface depths (website-local depth-1, website-service depth-1, website-local depth-5).</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/shared.ts

@@ -0,0 +1,36 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Maintains packages/share/src/semantic/jsonld/shared.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
+<non-goals>
+  <item>Do not modify node structure.</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 { JsonLdNode } from "./types.ts";
+
+export function dedupeGraph(nodes: JsonLdNode[]): JsonLdNode[] {
+  const seenIds = new Set<string>();
+
+  return nodes.filter((node) => {
+    const nodeId = typeof node["@id"] === "string" ? node["@id"] : null;
+    if (!nodeId) {
+      return true;
+    }
+
+    if (seenIds.has(nodeId)) {
+      return false;
+    }
+
+    seenIds.add(nodeId);
+    return true;
+  });
+}

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 = (() => {
@@ -309,18 +346,26 @@ function formatMarkdownLinkRow(site: SemanticSiteModel, page: SemanticPageModel)
   return `- [${title}](${url}): ${summary}`;
 }
 
-export function buildLlmsIndex(site: SemanticSiteModel): string {
+export function buildLlmsIndex(site: SemanticSiteModel, opts?: { servesSsr?: boolean }): string {
   const indexPages = site.pages.filter(inIndex);
   const llmsFullUrl = canonicalStaticUrl("/llms-full.txt", { baseUrl: site.baseUrl });
   const siteDescription = site.organization.description ?? "";
 
   // RFC-0789: agent discovery links — omitted when agent.enabled is false.
+  // The MCP Server Card exists only when the deployment adapter serves SSR
+  // routes (interfaces.mcp is set) — callers pass servesSsr=false on static
+  // adapters so the card is not advertised (PUBTXT-07 honesty).
   const agentEnabled = site.agent?.enabled !== false;
+  const servesSsr = opts?.servesSsr !== false;
   const agentLinks = agentEnabled
     ? [
         `> Machine-readable Agent Surface (structured knowledge + capabilities): [agent.json](${canonicalStaticUrl("/.well-known/agent.json", { baseUrl: site.baseUrl })}).`,
         `> API discovery catalog (RFC 9727): [api-catalog](${canonicalStaticUrl("/.well-known/api-catalog", { baseUrl: site.baseUrl })}).`,
-        `> MCP Server Card (SEP-1649): [server-card.json](${canonicalStaticUrl("/.well-known/mcp/server-card.json", { baseUrl: site.baseUrl })}).`,
+        ...(servesSsr
+          ? [
+              `> MCP Server Card (SEP-1649): [server-card.json](${canonicalStaticUrl("/.well-known/mcp/server-card.json", { baseUrl: site.baseUrl })}).`,
+            ]
+          : []),
         `> OpenAPI 3.1 specification: [agent.openapi.json](${canonicalStaticUrl("/.well-known/agent.openapi.json", { baseUrl: site.baseUrl })}).`,
       ]
     : [];
@@ -380,6 +425,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

@@ -7,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;
@@ -236,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[];
@@ -269,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;
@@ -417,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/{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/";

package/src/{share → semantic}/tests/build-page-price-markers.test.ts

@@ -10,8 +10,8 @@ import {
   buildSemanticPageModelWith,
   type SemanticContentReader,
   type SemanticBuildProfile,
-} from "../semantic/build-page.ts";
-import { OFFERING_URI_PREFIX, type DerivedPriceEntry } from "../semantic/price-marker-resolver.ts";
+} from "../build-page.ts";
+import { OFFERING_URI_PREFIX, type DerivedPriceEntry } from "../price-marker-resolver.ts";
 
 const fixturePrices: Record<string, DerivedPriceEntry[]> = {
   [`${OFFERING_URI_PREFIX}referral-fee`]: [

package/src/{share/semantic → semantic}/tests/business-projection.test.ts

@@ -6,6 +6,7 @@ import {
   projectPeople,
   projectServices,
   projectWeb,
+  projectClaims,
 } from "../business-projection.ts";
 
 describe("BUSINESS_DOMAIN_VISIBILITY", () => {
@@ -186,3 +187,181 @@ describe("projectWeb", () => {
     expect(projectWeb({})).toBeUndefined();
   });
 });
+
+describe("projectClaims", () => {
+  it("returns empty array for undefined claims", () => {
+    expect(projectClaims(undefined, undefined)).toEqual([]);
+  });
+
+  it("returns empty array for empty claims", () => {
+    expect(projectClaims([], undefined)).toEqual([]);
+  });
+
+  it("filters out non-published claims", () => {
+    const claims = [
+      {
+        id: "c1",
+        status: "draft",
+        statement: "Draft claim",
+        claimClass: "factual",
+        claimKind: "fact",
+      },
+      {
+        id: "c2",
+        status: "published",
+        statement: "Published claim",
+        claimClass: "factual",
+        claimKind: "fact",
+      },
+    ];
+    const result = projectClaims(claims, undefined);
+    expect(result).toHaveLength(1);
+    expect(result[0].id).toBe("c2");
+  });
+
+  it("skips claims without an id", () => {
+    const claims = [
+      { status: "published", statement: "No ID", claimClass: "factual", claimKind: "fact" },
+    ];
+    expect(projectClaims(claims, undefined)).toEqual([]);
+  });
+
+  it("projects claim fields", () => {
+    const claims = [
+      {
+        id: "c1",
+        status: "published",
+        statement: "We are awesome",
+        claimClass: "benefit",
+        claimKind: "benefit",
+        statementLang: "en",
+        verificationLevel: "N2",
+        confidence: "high",
+      },
+    ];
+    const result = projectClaims(claims, undefined);
+    expect(result[0]).toEqual({
+      id: "c1",
+      claimClass: "benefit",
+      claimKind: "benefit",
+      statement: "We are awesome",
+      statementLang: "en",
+      verificationLevel: "N2",
+      confidence: "high",
+      evidence: [],
+    });
+  });
+
+  it("resolves evidence refs using the ref field", () => {
+    const claims = [
+      {
+        id: "c1",
+        status: "published",
+        statement: "Claim with evidence",
+        claimClass: "factual",
+        claimKind: "fact",
+        evidenceRefs: { ev1: { ref: "evidence-1" } },
+      },
+    ];
+    const evidenceSources = {
+      "evidence-1": {
+        id: "evidence-1",
+        kind: "verified-record",
+        name: "Audit Report",
+        items: { item1: { sha256: "abc123", canonical: true } },
+        canonicalUri: "https://example.com/evidence/1",
+      },
+    };
+    const result = projectClaims(claims, evidenceSources);
+    expect(result[0].evidence).toHaveLength(1);
+    expect(result[0].evidence[0]).toEqual({
+      id: "evidence-1",
+      kind: "verified-record",
+      label: "Audit Report",
+      sha256: "abc123",
+      canonicalUri: "https://example.com/evidence/1",
+    });
+  });
+
+  it("falls back to first item when no canonical item exists", () => {
+    const claims = [
+      {
+        id: "c1",
+        status: "published",
+        statement: "Claim",
+        claimClass: "factual",
+        claimKind: "fact",
+        evidenceRefs: { ev1: { ref: "evidence-1" } },
+      },
+    ];
+    const evidenceSources = {
+      "evidence-1": {
+        id: "evidence-1",
+        kind: "certificate",
+        name: "ISO Certificate",
+        items: {
+          item1: { sha256: "first-hash" },
+          item2: { sha256: "second-hash", canonical: true },
+        },
+      },
+    };
+    const result = projectClaims(claims, evidenceSources);
+    expect(result[0].evidence[0].sha256).toBe("second-hash");
+  });
+
+  it("uses first item when no canonical flag at all", () => {
+    const claims = [
+      {
+        id: "c1",
+        status: "published",
+        statement: "Claim",
+        claimClass: "factual",
+        claimKind: "fact",
+        evidenceRefs: { ev1: { ref: "evidence-1" } },
+      },
+    ];
+    const evidenceSources = {
+      "evidence-1": {
+        id: "evidence-1",
+        kind: "certificate",
+        name: "ISO Certificate",
+        items: { item1: { sha256: "only-hash" } },
+      },
+    };
+    const result = projectClaims(claims, evidenceSources);
+    expect(result[0].evidence[0].sha256).toBe("only-hash");
+  });
+
+  it("skips evidence refs that point to missing sources", () => {
+    const claims = [
+      {
+        id: "c1",
+        status: "published",
+        statement: "Claim",
+        claimClass: "factual",
+        claimKind: "fact",
+        evidenceRefs: { ev1: { ref: "missing" } },
+      },
+    ];
+    const result = projectClaims(claims, undefined);
+    expect(result[0].evidence).toEqual([]);
+  });
+
+  it("uses sourceId as label when name is missing", () => {
+    const claims = [
+      {
+        id: "c1",
+        status: "published",
+        statement: "Claim",
+        claimClass: "factual",
+        claimKind: "fact",
+        evidenceRefs: { ev1: { ref: "evidence-1" } },
+      },
+    ];
+    const evidenceSources = {
+      "evidence-1": { id: "evidence-1", kind: "registry" },
+    };
+    const result = projectClaims(claims, evidenceSources);
+    expect(result[0].evidence[0].label).toBe("evidence-1");
+  });
+});