@warpgogol/werkstatt-shared 0.14.0 → 0.15.0

package/src/{share → sections}/rfc0042-utils.ts

@@ -59,7 +59,7 @@ export function need<T>(fieldName: string, value: T | undefined | null): T | str
  * const props = cast<TeamSectionContent>(pageOverride);
  * ```
  */
-export function cast<T extends Record<string, unknown>>(pageOverride: Record<string, unknown>): T {
+export function cast<T extends object>(pageOverride: Record<string, unknown>): T {
   return pageOverride as unknown as T;
 }
 

package/src/{share/semantic → semantic}/block-extractors/index.ts

@@ -501,10 +501,27 @@ for (const blockType of PASSPORT_NOOP_TYPES) {
   });
 }
 
+// ---------------------------------------------------------------------------
+// entity-grid (RFC-1062) — extracts heading and body items with descriptions.
 // ---------------------------------------------------------------------------
 // Site-specific block types that have no semantic text to extract but must be
 // registered so page.blocks.extract.validate does not fail.
-// ---------------------------------------------------------------------------
+BLOCK_EXTRACTORS.register<Record<string, unknown>>({
+  blockType: "entity-grid",
+  extract(props) {
+    const heading = safeString(safeGet(props, "header.heading"));
+    const lead = safeString(safeGet(props, "header.subheading"));
+    const items = safeArray(safeGet(props, "body.items"), (item) => {
+      const number = safeString(safeGet(item, "number"));
+      const title = safeString(safeGet(item, "title"));
+      const description = safeString(safeGet(item, "description"));
+      if (!title) return undefined;
+      return { title: number ? `${number}. ${title}` : title, description };
+    });
+    return { heading, lead, items };
+  },
+});
+
 const SITE_NOOP_TYPES = [
   "nachweis-list",
   "nachweis-detail",
@@ -514,6 +531,8 @@ const SITE_NOOP_TYPES = [
   "mountain-journey",
   "dynamic-status-block",
   "service-metadata-block",
+  "toc",
+  "exit-diagram",
 ] as const;
 
 for (const blockType of SITE_NOOP_TYPES) {

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

@@ -1,6 +1,6 @@
 /*
 <MODULE_CONTRACT>
-<purpose>RFC-0148: pure projectors that map canonical business-schema data into the semantic model, plus the projection visibility boundary. Framework-agnostic and side-effect-free, so the disk llms path and the Astro JSON-LD path project every business file identically. Lives in @warpgogol/werkstatt-shared/share (not @warpgogol/werkstatt-site/pbp) because @warpgogol/werkstatt-site/pbp depends on @warpgogol/site-kernel-content — placing the projectors here keeps the node disk loader cycle-free.</purpose>
+<purpose>RFC-0148: pure projectors that map canonical business-schema data into the semantic model, plus the projection visibility boundary. Framework-agnostic and side-effect-free, so the disk llms path and the Astro JSON-LD path project every business file identically. Lives in @warpgogol/werkstatt-shared/semantic (not @warpgogol/werkstatt-site/pbp) because @warpgogol/werkstatt-site/pbp depends on @warpgogol/site-kernel-content — placing the projectors here keeps the node disk loader cycle-free.</purpose>
 <non-goals>
   <item>Do not read files — pure mapping over already-loaded data.</item>
   <item>Do not project privacy-sensitive domains (external-services, compliance).</item>
@@ -10,6 +10,7 @@
   <item>RFC-0148: initial projection registry — offer + location projectors and the visibility boundary.</item>
   <item>RFC-0287: added projectWeb for the Agent Surface knowledge tier.</item>
   <item>RFC-0373: added projectServices for business service catalog projection.</item>
+  <item>RFC-1076: add projectClaims projector and SemanticClaimProvenance / SemanticEvidenceRef types.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -21,6 +22,38 @@ import type {
   SemanticWeb,
 } from "./models.ts";
 
+export interface SemanticClaimProvenance {
+  /** Stable claim ID from PbpClaim.id. */
+  id: string;
+  /** Claim class: factual, risk, benefit, etc. */
+  claimClass: string;
+  /** Claim kind: risk, benefit, comparison, fact, limitation, recommendation. */
+  claimKind: string;
+  /** The claim statement text. */
+  statement: string;
+  /** ISO 639-1 language tag of the statement (RFC-0706). */
+  statementLang?: string;
+  /** Verification level N0–N3 (ADR-0028). */
+  verificationLevel?: string;
+  /** Confidence: high, medium, low. */
+  confidence?: string;
+  /** Evidence references — resolved from PbpClaim.evidenceRefs. */
+  evidence: SemanticEvidenceRef[];
+}
+
+export interface SemanticEvidenceRef {
+  /** EvidenceSource entity ID. */
+  id: string;
+  /** Evidence kind: verified-record, third-party-registry, certificate, etc. */
+  kind: string;
+  /** Human-readable label for the evidence source. */
+  label: string;
+  /** SHA-256 integrity hash of the canonical evidence artifact, if available. */
+  sha256?: string;
+  /** Canonical URI of the evidence source (RFC-1075), if available. */
+  canonicalUri?: string;
+}
+
 /**
  * RFC-0148 privacy boundary. `public` projects to AI (llms) + JSON-LD; `pageMeta`
  * is build-time only (e.g. legal-page dates → sitemap lastmod); `none` is never
@@ -253,6 +286,67 @@ export function projectServices(
   return services;
 }
 
+/**
+ * RFC-1076: project PBP claims with their evidence references into the semantic model.
+ * Only claims with status "published" are projected. The sha256 is read from the
+ * canonical item (items[key] where canonical === true), falling back to the first
+ * item. Localization is handled by the semantic loader (per-language loading with
+ * default-language fallback), not by this projector.
+ */
+export function projectClaims(
+  claims: ReadonlyArray<Record<string, unknown>> | undefined,
+  evidenceSources: Record<string, Record<string, unknown>> | undefined,
+): SemanticClaimProvenance[] {
+  if (!claims?.length) return [];
+  const result: SemanticClaimProvenance[] = [];
+  for (const claim of claims) {
+    const id = typeof claim["id"] === "string" ? claim["id"] : "";
+    if (!id) continue;
+    const status = typeof claim["status"] === "string" ? claim["status"] : "";
+    if (status !== "published") continue;
+    const evidenceRefs = (claim["evidenceRefs"] ?? {}) as Record<string, { ref?: string }>;
+    const evidence: SemanticEvidenceRef[] = [];
+    for (const ref of Object.values(evidenceRefs)) {
+      const sourceId = ref?.ref;
+      if (!sourceId) continue;
+      const source = evidenceSources?.[sourceId];
+      if (!source) continue;
+      const items = (source["items"] ?? {}) as Record<
+        string,
+        { sha256?: string; canonical?: boolean }
+      >;
+      const itemValues = Object.values(items);
+      const canonicalItem = itemValues.find((it) => it?.canonical === true) ?? itemValues[0];
+      evidence.push({
+        id: sourceId,
+        kind: typeof source["kind"] === "string" ? source["kind"] : "",
+        label: typeof source["name"] === "string" ? source["name"] : sourceId,
+        ...(typeof canonicalItem?.["sha256"] === "string"
+          ? { sha256: canonicalItem["sha256"] }
+          : {}),
+        ...(typeof source["canonicalUri"] === "string"
+          ? { canonicalUri: source["canonicalUri"] }
+          : {}),
+      });
+    }
+    result.push({
+      id,
+      claimClass: typeof claim["claimClass"] === "string" ? claim["claimClass"] : "",
+      claimKind: typeof claim["claimKind"] === "string" ? claim["claimKind"] : "",
+      statement: typeof claim["statement"] === "string" ? claim["statement"] : "",
+      ...(typeof claim["statementLang"] === "string"
+        ? { statementLang: claim["statementLang"] }
+        : {}),
+      ...(typeof claim["verificationLevel"] === "string"
+        ? { verificationLevel: claim["verificationLevel"] }
+        : {}),
+      ...(typeof claim["confidence"] === "string" ? { confidence: claim["confidence"] } : {}),
+      evidence,
+    });
+  }
+  return result;
+}
+
 /**
  * RFC-0287: project the business web/domain identity record (business/{lang}/web.md
  * — primaryUrl, statusUrl, domains.{primary,german}). A thin, faithful passthrough of

package/src/semantic/canonical-uri.ts

@@ -0,0 +1,54 @@
+/*
+<MODULE_CONTRACT>
+  <purpose>RFC-1075: derive persistent canonical URIs for PBP entity envelopes from site origin and entity identity. Used for Linked Data @id fields in JSON-LD and llms-full.txt projections.</purpose>
+  <non-goals>
+    <item>Does not validate that the entity ID is well-formed — callers are responsible for providing valid IDs.</item>
+    <item>Does not perform URL normalization beyond trailing-slash removal on the site origin.</item>
+  </non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1075: initial — deriveCanonicalUri pure function for persistent entity @id URIs.</item>
+</CHANGE_SUMMARY>
+*/
+
+/**
+ * Entity types supported by the PBP canonical URI scheme.
+ *
+ * The URI path pattern is `/.well-known/entity/{type}/{id}` for typed entities
+ * (e.g. offerings) and `/.well-known/entity/business` for the single business entity.
+ */
+export type CanonicalEntityType = "business" | "offering";
+
+/**
+ * RFC-1075: derive a persistent canonical URI for a PBP entity.
+ *
+ * The URI follows the pattern:
+ * - Business: `{siteOrigin}/.well-known/entity/business`
+ * - Offering: `{siteOrigin}/.well-known/entity/offering/{entityId}`
+ *
+ * The `siteOrigin` is stripped of trailing slashes to produce a clean base.
+ * When `siteOrigin` is absent or empty, the function returns `undefined` —
+ * callers should skip emitting `@id` in that case.
+ *
+ * @param siteOrigin - The site origin URL (e.g. `https://example.com`)
+ * @param type - The entity type (`"business"` or `"offering"`)
+ * @param entityId - The entity ID (required for `"offering"`, ignored for `"business"`)
+ * @returns The canonical URI string, or `undefined` when `siteOrigin` is absent
+ */
+export function deriveCanonicalUri(
+  siteOrigin: string | undefined,
+  type: CanonicalEntityType,
+  entityId?: string,
+): string | undefined {
+  if (!siteOrigin) return undefined;
+
+  const base = siteOrigin.replace(/\/+$/, "");
+
+  if (type === "business") {
+    return `${base}/.well-known/entity/business`;
+  }
+
+  if (!entityId) return undefined;
+
+  return `${base}/.well-known/entity/offering/${entityId}`;
+}

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

@@ -7,7 +7,7 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0133: backfilled MODULE_MAP and CHANGE_SUMMARY markers for compass.validate compliance.</item>
-  <item>RFC-0915: removed custom slugify() — replaced by slugId from @warpgogol/werkstatt-shared/share/slug.</item>
+  <item>RFC-0915: removed custom slugify() — replaced by slugId from @warpgogol/werkstatt-shared/slug.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -160,6 +160,105 @@ export function splitSentences(text: string, locale: string = "en"): string[] {
   return sentences.filter(Boolean);
 }
 
+export type MarkdownList = {
+  marker: "-" | "*" | "+" | "digit";
+  items: string[];
+};
+
+const LIST_MARKER_PATTERNS: Array<{ marker: MarkdownList["marker"]; regex: RegExp }> = [
+  { marker: "-", regex: /^-\s+/ },
+  { marker: "*", regex: /^\*\s+/ },
+  { marker: "+", regex: /^\+\s+/ },
+  { marker: "digit", regex: /^\d+\.\s+/ },
+];
+
+function matchListMarker(
+  line: string,
+): { marker: MarkdownList["marker"]; text: string } | undefined {
+  for (const { marker, regex } of LIST_MARKER_PATTERNS) {
+    const match = line.match(regex);
+    if (match) {
+      return { marker, text: line.slice(match[0].length).trim() };
+    }
+  }
+  return undefined;
+}
+
+function isTopLevelListLine(
+  line: string,
+): { marker: MarkdownList["marker"]; text: string } | undefined {
+  // Top-level: no leading whitespace before the marker
+  if (/^\s/.test(line)) return undefined;
+  return matchListMarker(line);
+}
+
+function isIndentedListLine(line: string): boolean {
+  // Indented list line: starts with whitespace + list marker
+  if (!/^\s/.test(line)) return false;
+  const trimmed = line.trimStart();
+  return LIST_MARKER_PATTERNS.some(({ regex }) => regex.test(trimmed));
+}
+
+export function extractLists(markdown: string): MarkdownList[] {
+  const normalized = markdown.trim();
+  if (!normalized) return [];
+
+  const lines = normalized.split("\n");
+  const lists: MarkdownList[] = [];
+  let currentList: MarkdownList | null = null;
+  let inCodeFence = false;
+
+  for (const line of lines) {
+    // Track fenced code blocks
+    if (line.trimStart().startsWith("```")) {
+      inCodeFence = !inCodeFence;
+      if (currentList) {
+        lists.push(currentList);
+        currentList = null;
+      }
+      continue;
+    }
+
+    if (inCodeFence) {
+      continue;
+    }
+
+    const topMatch = isTopLevelListLine(line);
+
+    if (topMatch) {
+      // Continue current list if same marker type
+      if (currentList && currentList.marker === topMatch.marker) {
+        currentList.items.push(topMatch.text);
+      } else {
+        // Different marker or first list — flush previous, start new
+        if (currentList) {
+          lists.push(currentList);
+        }
+        currentList = { marker: topMatch.marker, items: [topMatch.text] };
+      }
+      continue;
+    }
+
+    // Indented list line — part of parent item, not a new item
+    if (isIndentedListLine(line)) {
+      continue;
+    }
+
+    // Non-list line (blank, prose, heading, etc.) — terminate current list
+    if (currentList) {
+      lists.push(currentList);
+      currentList = null;
+    }
+  }
+
+  // Flush trailing list
+  if (currentList) {
+    lists.push(currentList);
+  }
+
+  return lists;
+}
+
 export function extractListFacts(markdown: string): string[] {
   return markdown
     .split("\n")

package/src/semantic/fact-extraction.test.ts

@@ -0,0 +1,47 @@
+import { describe, test, expect } from "vitest";
+import { normalizeFactValue, type CanonicalFact } from "./fact-extraction.ts";
+
+describe("fact-extraction: normalizeFactValue", () => {
+  test("normalizes email to lowercase", () => {
+    expect(normalizeFactValue("email", "Info@Test.COM")).toBe("info@test.com");
+  });
+
+  test("normalizes phone by stripping tel: prefix and separators", () => {
+    expect(normalizeFactValue("phone", "tel:+49 30 123-4567")).toBe("+49301234567");
+  });
+
+  test("normalizes phone by stripping spaces, hyphens, and parentheses", () => {
+    expect(normalizeFactValue("phone", "+49 (30) 123-4567")).toBe("+49301234567");
+  });
+
+  test("trims whitespace for other types", () => {
+    expect(normalizeFactValue("price", "  2900  ")).toBe("2900");
+  });
+
+  test("trims whitespace for name", () => {
+    expect(normalizeFactValue("name", "  Test Business  ")).toBe("Test Business");
+  });
+
+  test("handles empty string", () => {
+    expect(normalizeFactValue("email", "")).toBe("");
+    expect(normalizeFactValue("phone", "")).toBe("");
+    expect(normalizeFactValue("price", "")).toBe("");
+  });
+});
+
+describe("fact-extraction: CanonicalFact interface", () => {
+  test("CanonicalFact can be constructed with all fields", () => {
+    const fact: CanonicalFact = {
+      type: "price",
+      entityId: "offering-1",
+      entityType: "offering",
+      value: "2900",
+      surface: "canonical",
+      source: "pbp",
+    };
+    expect(fact.type).toBe("price");
+    expect(fact.entityId).toBe("offering-1");
+    expect(fact.value).toBe("2900");
+    expect(fact.surface).toBe("canonical");
+  });
+});

package/src/semantic/fact-extraction.ts

@@ -0,0 +1,46 @@
+/*
+<MODULE_CONTRACT>
+<purpose>RFC-1077: Canonical fact interface and normalization utility for cross-surface fact parity validation. Shared between werkstatt-shared (contract) and werkstatt-site (extraction logic).</purpose>
+<non-goals>
+  <item>Do not import from werkstatt-site — this package must not depend on the site plugin.</item>
+  <item>Do not implement fact extraction — that lives in werkstatt-site where PbpResolvedGraph is available.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1077: initial implementation — CanonicalFact interface and normalizeFactValue.</item>
+</CHANGE_SUMMARY>
+*/
+
+/** RFC-1077: A canonical fact extracted from the PBP resolved graph or a rendered surface. */
+export interface CanonicalFact {
+  /** Fact type: price, address, email, foundingYear, representative, phone, name. */
+  type: string;
+  /** Entity ID the fact belongs to (e.g. offering ID, business ID, place ID). */
+  entityId: string;
+  /** Entity type: business, offering, place, contactPoint. */
+  entityType: string;
+  /** The canonical value as a string (normalized for comparison). */
+  value: string;
+  /** The surface where this fact was found: html, llms-full, jsonld, canonical. */
+  surface: string;
+  /** Source file path or URL where the fact was found. */
+  source: string;
+}
+
+/** RFC-1077: Normalize a fact value for comparison across surfaces. */
+export function normalizeFactValue(type: string, value: string): string {
+  const trimmed = value.trim();
+  if (type === "email") return trimmed.toLowerCase();
+  if (type === "phone") return trimmed.replace(/^tel:/, "").replace(/[\s\-()]/g, "");
+  if (type === "price") {
+    let stripped = trimmed.replace(/\s*(EUR|USD|GBP|CHF|UAH|€|\$|£|₴)\s*$/i, "");
+    // Handle German thousands separator: "2.000" → "2000", "1.040" → "1040"
+    stripped = stripped.replace(/(\d)\.(\d{3})(?!\d)/g, "$1$2");
+    // Handle space thousands separator: "2 000" → "2000"
+    stripped = stripped.replace(/(\d)\s(\d{3})(?!\d)/g, "$1$2");
+    const num = parseFloat(stripped);
+    if (!isNaN(num)) return String(num);
+    return stripped;
+  }
+  return trimmed;
+}

package/src/semantic/freshness.ts

@@ -0,0 +1,67 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-1078: Pure freshness calculation functions for semantic.freshness.validate.
+Provides calculateAgeDays, isAssessmentStale, isItemStale, and the FreshnessViolation
+interface. All functions are pure and deterministic for a fixed reference date.
+</purpose>
+<non-goals>
+  <item>Does not compile PBP profiles — that is the validator's job in werkstatt-site.</item>
+  <item>Does not emit diagnostics — the validator collects violations and emits them.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1078: initial — calculateAgeDays, isAssessmentStale, isItemStale, FreshnessViolation, DEFAULT_FRESHNESS_WINDOW_DAYS.</item>
+</CHANGE_SUMMARY>
+*/
+
+/** RFC-1078: Default freshness window for evidence items without a declared maxAgeDays. */
+export const DEFAULT_FRESHNESS_WINDOW_DAYS = 180;
+
+/** RFC-1078: A freshness violation detected by semantic.freshness.validate. */
+export interface FreshnessViolation {
+  rule: string;
+  entityType: string;
+  entityId: string;
+  /** The field that is stale: assessment.observedAt, items[].retrievedAt, etc. */
+  field: string;
+  /** The observed timestamp. */
+  observedAt: string;
+  /** The maximum age in days. */
+  maxAgeDays: number;
+  /** The actual age in days at validation time. */
+  actualAgeDays: number;
+  message: string;
+}
+
+/**
+ * RFC-1078: Calculate age in days from an ISO timestamp to a reference date.
+ * Pure and deterministic for a fixed reference date.
+ * Returns Number.MAX_SAFE_INTEGER for invalid date strings.
+ */
+export function calculateAgeDays(observedAt: string, referenceDate: Date = new Date()): number {
+  const observed = new Date(observedAt);
+  if (isNaN(observed.getTime())) return Number.MAX_SAFE_INTEGER;
+  const diffMs = referenceDate.getTime() - observed.getTime();
+  return Math.floor(diffMs / (1000 * 60 * 60 * 24));
+}
+
+/** RFC-1078: Check if a technical assessment is stale. Pure. */
+export function isAssessmentStale(
+  assessment: { observedAt: string; freshness: { maxAgeDays: number } },
+  referenceDate: Date = new Date(),
+): boolean {
+  const ageDays = calculateAgeDays(assessment.observedAt, referenceDate);
+  return ageDays > assessment.freshness.maxAgeDays;
+}
+
+/** RFC-1078: Check if an evidence item is stale. Pure. Returns false if retrievedAt is missing. */
+export function isItemStale(
+  item: { retrievedAt?: string },
+  maxAgeDays: number,
+  referenceDate: Date = new Date(),
+): boolean {
+  if (!item.retrievedAt) return false;
+  const ageDays = calculateAgeDays(item.retrievedAt, referenceDate);
+  return ageDays > maxAgeDays;
+}

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

@@ -7,8 +7,13 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Moved from app semantic/ids to packages/share/src/semantic/ids.ts — framework-agnostic, reusable across all apps.</item>
   <item>RFC-0910: add canonicalRootUrl — unprefixed root URL for entity identity (Organization.url, WebSite.url).</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}/index.ts

@@ -6,7 +6,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Expanded barrel to cover the full semantic layer: ids, jsonld, llms, page-utils, page-builders.</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>
 */
 
@@ -32,5 +37,7 @@ export * from "./build-page.ts";
 export * from "./block-extraction.ts";
 export * from "./block-extractors/index.ts";
 export * from "./update-stamp.ts";
-export * from "./markdown-twin-provenance.ts";
 export * from "./price-marker-resolver.ts";
+export * from "./canonical-uri.ts";
+export * from "./fact-extraction.ts";
+export * from "./freshness.ts";

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

@@ -6,8 +6,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added breadcrumb support for JSON-LD generation.</item>
-  <item>Moved from app semantic/jsonld/breadcrumb to packages/share.</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}/jsonld/context.ts

@@ -7,8 +7,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added servicesListId and initiativesListId derived IDs.</item>
-  <item>Moved from app semantic/jsonld/context to packages/share.</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}/jsonld/faq.ts

@@ -6,8 +6,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added FAQPage JSON-LD support.</item>
-  <item>Moved from app semantic/jsonld/faq to packages/share.</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}/jsonld/initiative.ts

@@ -6,7 +6,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added initiatives list node plus initiative item-position wiring.</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}/jsonld/organization.ts

@@ -7,7 +7,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added Organization JSON-LD generation.</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}/jsonld/person.ts

@@ -6,9 +6,13 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added Person JSON-LD generation for organization members.</item>
-  <item>Moved from app semantic/jsonld/person to packages/share.</item>
   <item>RFC-0512: emit address, knowsAbout, affiliation when present on SemanticPerson.</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}/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>
 */