@warpgogol/werkstatt-shared 0.14.1 → 0.16.0

package/src/observability/pipeline-log.ts

@@ -0,0 +1,81 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Provides lightweight structured pipeline log events for build-time content helpers.</purpose>
+<non-goals>
+  <item>Do not persist logs outside the current Node.js process.</item>
+  <item>Do not silence actionable warnings or errors.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0254: add structured expected-fallback log transport for build/check paths.</item>
+</CHANGE_SUMMARY>
+*/
+
+export type PipelineLogSeverity = "debug" | "info" | "notice" | "warning" | "error";
+
+export type PipelineLogKind =
+  "progress" | "expected-fallback" | "advisory" | "external-tool" | "diagnostic" | "error";
+
+export interface PipelineLogEvent {
+  severity: PipelineLogSeverity;
+  kind: PipelineLogKind;
+  message: string;
+  command?: string;
+  pipeline?: string;
+  app?: string;
+  packageName?: string;
+  module?: string;
+  file?: string;
+  line?: number;
+  ruleId?: string;
+  dedupeKey?: string;
+  count?: number;
+  data?: Record<string, unknown>;
+}
+
+interface PipelineLogState {
+  events: PipelineLogEvent[];
+  counts: Map<string, number>;
+}
+
+const STATE_KEY = "__gogolPipelineLogState";
+
+function getState(): PipelineLogState {
+  const root = globalThis as typeof globalThis & { __gogolPipelineLogState?: PipelineLogState };
+  if (!root[STATE_KEY]) {
+    root[STATE_KEY] = { events: [], counts: new Map() };
+  }
+  return root[STATE_KEY];
+}
+
+function renderEvent(event: PipelineLogEvent, count: number): string {
+  const prefix = event.kind === "expected-fallback" ? "fallback" : event.kind;
+  const suffix = count > 1 ? ` (${count} occurrence(s))` : "";
+  return `[${event.severity}:${prefix}] ${event.message}${suffix}`;
+}
+
+export function emitPipelineLogEvent(event: PipelineLogEvent): void {
+  const state = getState();
+  const key = event.dedupeKey ?? `${event.kind}:${event.severity}:${event.message}`;
+  const count = (state.counts.get(key) ?? 0) + 1;
+  state.counts.set(key, count);
+  state.events.push({ ...event, count });
+
+  if (event.severity === "debug") return;
+  if (event.kind === "expected-fallback" && count > 1) return;
+
+  const rendered = renderEvent(event, count);
+  if (event.severity === "error") {
+    console.error(rendered);
+    return;
+  }
+  if (event.severity === "warning") {
+    console.warn(rendered);
+    return;
+  }
+  console.log(rendered);
+}
+
+export function getPipelineLogEvents(): PipelineLogEvent[] {
+  return getState().events.map((event) => ({ ...event }));
+}

package/src/observability/pusher.ts

@@ -9,7 +9,12 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0337: initial implementation.</item>
-  <item>Deepening: extract OTLP conversion to otlp-converter.ts pure function.</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/observability/redact.ts

@@ -8,7 +8,12 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0337: initial implementation.</item>
-  <item>Fix 2026-07-11: only trim the URL root slash so redaction is idempotent for multi-slash paths.</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/observability/typed-refs.ts

@@ -8,9 +8,13 @@
 @ai-invariant: METRIC_REFS keys must match WARPGOGOL_METRIC_REGISTRY names exactly — enforced by compile-time type assertion below.
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Add typed metric references for compile-time label-key enforcement across all consumers.</item>
-  <item>wg-review: correct non-goals, add compile-time registry-coverage assertion.</item>
   <item>RFC-0807: add back prefix metric refs for service health monitoring.</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/observability/vitest.config.ts

@@ -3,6 +3,7 @@ import { defineConfig } from "vitest/config";
 export default defineConfig({
   test: {
     environment: "node",
+    testTimeout: 30_000,
     include: ["src/**/*.test.ts"],
   },
 });

package/src/{share → offers}/formula-eval.ts

@@ -5,7 +5,7 @@ scans text for =(...) formula expressions, and evaluates arithmetic over content
 using a sandboxed math parser (expr-eval). RFC-0729: pipe syntax for post-evaluation formatting,
 plugin-registration formatter registry, and money formatter built on Intl.NumberFormat.</purpose>
 <non-goals>
-  <item>Do not resolve content references directly — use resolveReference from @warpgogol/werkstatt-shared/share/content-reference.</item>
+  <item>Do not resolve content references directly — use resolveReference from @warpgogol/werkstatt-shared/content/content-reference.</item>
   <item>Do not support non-arithmetic expressions (string concatenation, conditionals, date math).</item>
   <item>Do not add formatters other than money — date, percent, unit formatters are follow-up RFCs.</item>
 </non-goals>
@@ -19,8 +19,8 @@ plugin-registration formatter registry, and money formatter built on Intl.Number
 */
 
 import { Parser } from "expr-eval";
-import type { ContentRefIndex, SourceRef } from "./content-reference.ts";
-import { resolveReference } from "./content-reference.ts";
+import type { ContentRefIndex, SourceRef } from "../content/content-reference.ts";
+import { resolveReference } from "../content/content-reference.ts";
 
 export interface FormulaResolution {
   value: string;

package/src/{share → offers}/tests/formula-eval.test.ts

@@ -13,8 +13,8 @@ import {
   registerPipeFormatter,
   getPipeFormatter,
 } from "../formula-eval.ts";
-import type { ContentRefIndex, SourceRef } from "../content-reference.ts";
-import { EMPTY_CONTENT_REF_INDEX } from "../content-reference.ts";
+import type { ContentRefIndex, SourceRef } from "../../content/content-reference.ts";
+import { EMPTY_CONTENT_REF_INDEX } from "../../content/content-reference.ts";
 
 describe("extractNumeric", () => {
   it("extracts number from string with currency suffix", () => {

package/src/onboarding/index.ts

@@ -18,3 +18,4 @@ export {
   parseMarkdownAsYaml,
 } from "./brief.ts";
 export type { Brief } from "./brief.ts";
+export * from "./yaml.ts";

package/src/{share → onboarding}/tests/onboarding-yaml.test.ts

@@ -23,7 +23,7 @@ import {
   parseOnboardingArtifactHeader,
   parseOnboardingArtifactPayload,
   RFC_METADATA_KEYS,
-} from "../onboarding-yaml/index.ts";
+} from "../yaml.ts";
 
 const HEADER_FIXTURE = `phase: 04-author
 derivedFromInputHash: sha256:deadbeef

package/src/ontology/archetype-registry.ts

@@ -14,7 +14,12 @@ fast instead of producing silently empty maps.
 <CHANGE_SUMMARY>
   <item>RFC-0091: Initial creation — typed re-export of derived archetype registry maps.</item>
   <item>RFC-0263: also re-export roleByCosmicName (manifest-authored role, derived) — replaces name-keyed dispatch literals in packages/share.</item>
-  <item>Architecture review 2026-07-10: validate index.json with Zod instead of unchecked cast — fail-fast on registry shape drift.</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/ontology/archetypes/index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": "1.0.0",
-  "totalCount": 59,
+  "totalCount": 61,
   "entries": [
     {
       "id": "approach",
@@ -182,6 +182,30 @@
       "sourceFile": "packages/werkstatt-site/src/domain/ontology/archetypes/sections/dynamic-status-block.yaml",
       "layer": "section"
     },
+    {
+      "id": "entity-grid",
+      "displayName": "Engineering entity grid",
+      "semanticRole": "entity-composition-grid",
+      "version": "1.0.0",
+      "layoutHint": "card-grid",
+      "acceptedCosmicNames": [
+        "Ixion"
+      ],
+      "sourceFile": "packages/werkstatt-site/src/domain/ontology/archetypes/sections/entity-grid.yaml",
+      "layer": "section"
+    },
+    {
+      "id": "exit-diagram",
+      "displayName": "Exit-process diagram",
+      "semanticRole": "exit-flow-visualization",
+      "version": "1.0.0",
+      "layoutHint": "single-column",
+      "acceptedCosmicNames": [
+        "Haumea"
+      ],
+      "sourceFile": "packages/werkstatt-site/src/domain/ontology/archetypes/sections/exit-diagram.yaml",
+      "layer": "section"
+    },
     {
       "id": "faq-list",
       "displayName": "Faq List",
@@ -723,7 +747,9 @@
     "data-driven-status-indicator",
     "donation-card",
     "donation-use",
+    "entity-composition-grid",
     "exit-clause-disclosure",
+    "exit-flow-visualization",
     "faq-list",
     "final-cta",
     "hero",
@@ -788,6 +814,8 @@
     "Pandora": "@warpgogol/werkstatt-site/ui/sections/donation-card",
     "Rhea": "@warpgogol/werkstatt-site/ui/sections/donation-use",
     "Elara": "@warpgogol/werkstatt-site/ui/sections/dynamic-status-block",
+    "Ixion": "@warpgogol/werkstatt-site/ui/sections/entity-grid",
+    "Haumea": "@warpgogol/werkstatt-site/ui/sections/exit-diagram",
     "Atlas": "@warpgogol/werkstatt-site/ui/sections/faq-list",
     "Dione": "@warpgogol/werkstatt-site/ui/sections/final-cta",
     "Gonggong": "@warpgogol/werkstatt-site/ui/sections/gratitude",
@@ -867,6 +895,8 @@
     "donation-card": "Pandora",
     "donation-use": "Rhea",
     "dynamic-status-block": "Elara",
+    "entity-grid": "Ixion",
+    "exit-diagram": "Haumea",
     "faq-list": "Atlas",
     "final-cta": "Dione",
     "gratitude": "Gonggong",
@@ -950,6 +980,8 @@
     "Pandora": "donation-use",
     "Rhea": "donation-use",
     "Elara": "data-driven-status-indicator",
+    "Ixion": "entity-composition-grid",
+    "Haumea": "exit-flow-visualization",
     "Atlas": "approach",
     "Dione": "final-cta",
     "Gonggong": "client-gratitude",

package/src/ontology/archetypes/index.yaml

@@ -1,5 +1,5 @@
 schemaVersion: 1.0.0
-totalCount: 59
+totalCount: 61
 entries:
   - id: approach
     displayName: Approach
@@ -136,6 +136,24 @@ entries:
       - Elara
     sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/sections/dynamic-status-block.yaml
     layer: section
+  - id: entity-grid
+    displayName: Engineering entity grid
+    semanticRole: entity-composition-grid
+    version: 1.0.0
+    layoutHint: card-grid
+    acceptedCosmicNames:
+      - Ixion
+    sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/sections/entity-grid.yaml
+    layer: section
+  - id: exit-diagram
+    displayName: Exit-process diagram
+    semanticRole: exit-flow-visualization
+    version: 1.0.0
+    layoutHint: single-column
+    acceptedCosmicNames:
+      - Haumea
+    sourceFile: packages/werkstatt-site/src/domain/ontology/archetypes/sections/exit-diagram.yaml
+    layer: section
   - id: faq-list
     displayName: Faq List
     semanticRole: faq-list
@@ -544,7 +562,9 @@ sectionRoles:
   - data-driven-status-indicator
   - donation-card
   - donation-use
+  - entity-composition-grid
   - exit-clause-disclosure
+  - exit-flow-visualization
   - faq-list
   - final-cta
   - hero
@@ -607,6 +627,8 @@ planetImportPaths:
   Pandora: "@warpgogol/werkstatt-site/ui/sections/donation-card"
   Rhea: "@warpgogol/werkstatt-site/ui/sections/donation-use"
   Elara: "@warpgogol/werkstatt-site/ui/sections/dynamic-status-block"
+  Ixion: "@warpgogol/werkstatt-site/ui/sections/entity-grid"
+  Haumea: "@warpgogol/werkstatt-site/ui/sections/exit-diagram"
   Atlas: "@warpgogol/werkstatt-site/ui/sections/faq-list"
   Dione: "@warpgogol/werkstatt-site/ui/sections/final-cta"
   Gonggong: "@warpgogol/werkstatt-site/ui/sections/gratitude"
@@ -685,6 +707,8 @@ blockTypeToCosmicName:
   donation-card: Pandora
   donation-use: Rhea
   dynamic-status-block: Elara
+  entity-grid: Ixion
+  exit-diagram: Haumea
   faq-list: Atlas
   final-cta: Dione
   gratitude: Gonggong
@@ -766,6 +790,8 @@ roleByCosmicName:
   Pandora: donation-use
   Rhea: donation-use
   Elara: data-driven-status-indicator
+  Ixion: entity-composition-grid
+  Haumea: exit-flow-visualization
   Atlas: approach
   Dione: final-cta
   Gonggong: client-gratitude

package/src/ontology/archetypes/sections/entity-grid.yaml

@@ -0,0 +1,46 @@
+id: entity-grid
+displayName: Engineering entity grid
+version: 1.0.0
+semanticRole: entity-composition-grid
+description: |
+  Engineering-style entity composition grid with numbered markers and
+  boundaries. No glass effects. RFC-1062.
+expectedIntents:
+  - trust
+  - legal-clarity
+  - de-risk
+expectedIndustryFit:
+  - trades-and-construction
+  - consulting-and-coaching
+  - legal-services
+layoutHint: card-grid
+bodyKind: composite
+recommendedItemCount:
+  min: 2
+  max: 8
+propsSchema:
+  $shape: zod
+  compose:
+    - section-header
+  shape: |
+    z.object({
+      background: z.object({
+        kind: z.enum(["transparent", "solid"]),
+      }).optional(),
+      density: z.enum(["compact", "normal"]).optional(),
+      body: z.object({
+        kind: z.literal("grid"),
+        columns: z.union([z.literal(2), z.literal(3), z.literal(4)]),
+        items: z.array(z.object({
+          number: z.string().min(1),
+          title: z.string().min(1),
+          description: z.string().min(1),
+        })).min(2).max(8),
+      }),
+    }).strict()
+acceptedCosmicNames:
+  - Ixion
+constraints:
+  forbidPhrases:
+    - alle Branchen
+    - jeder Kunde

package/src/ontology/archetypes/sections/exit-diagram.yaml

@@ -0,0 +1,43 @@
+id: exit-diagram
+displayName: Exit-process diagram
+version: 1.0.0
+semanticRole: exit-flow-visualization
+description: |
+  Static SVG exit-process flow diagram. Renders stages as a visual flow
+  (linear or loop) with numbered markers. RFC-1062.
+expectedIntents:
+  - trust
+  - legal-clarity
+  - de-risk
+expectedIndustryFit:
+  - trades-and-construction
+  - consulting-and-coaching
+  - legal-services
+layoutHint: single-column
+bodyKind: composite
+recommendedItemCount:
+  min: 2
+  max: 6
+propsSchema:
+  $shape: zod
+  compose:
+    - section-visual
+    - section-header
+  shape: |
+    z.object({
+      ariaLabel: z.string().min(1).optional(),
+      stages: z.array(z.object({
+        number: z.string().min(1),
+        title: z.string().min(1),
+        description: z.string().min(1),
+      })).min(2).max(6),
+      variant: z.enum(["linear", "loop"]),
+    }).strict()
+acceptedCosmicNames:
+  - Haumea
+constraints:
+  forbidPhrases:
+    - Evakuierung
+    - Notfall
+  mandatoryConcepts:
+    - Notausgang

package/src/ontology/biome-token-projection.ts

@@ -12,7 +12,12 @@ divergent copies of the same mapping.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Initial: consolidated BIOME_TO_TOKEN_MAP, BIOME_TO_CSS_VAR, and buildExpectedBiomeCss into one projection.</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/ontology/capabilities/lead.prepare.yaml

@@ -0,0 +1,44 @@
+id: lead.prepare
+version: 1
+kind: action
+sideEffect: none
+title:
+  de: Anfrage prüfen
+  en: Preview a lead
+description:
+  de: "Prüft eine Kontaktanfrage (Name, E-Mail, Nachricht) ohne sie abzusenden — liefert eine draftId, die als Idempotency-Key eines späteren lead.submit dient. Nebenwirkungsfrei: es wird nichts zugestellt."
+  en: "Validates a contact request (name, email, message) without submitting it — returns a draftId usable as the Idempotency-Key of a later lead.submit. Side-effect-free: nothing is dispatched."
+input:
+  type: object
+  required: [name, email, message]
+  additionalProperties: false
+  properties:
+    name:
+      type: string
+      minLength: 1
+      maxLength: 200
+    email:
+      type: string
+      format: email
+      maxLength: 254
+    message:
+      type: string
+      minLength: 1
+      maxLength: 5000
+output:
+  type: object
+  required: [valid, draftId]
+  additionalProperties: false
+  properties:
+    valid:
+      type: boolean
+    draftId:
+      type: string
+      minLength: 71
+      maxLength: 71
+requires:
+  entitlements: [agent.actions]
+  sections: [send-message]
+limits:
+  perMinutePerIp: 10
+  maxPayloadBytes: 10240

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

@@ -1,6 +1,7 @@
 id: lead.submit
-version: 1
+version: 2
 kind: action
+sideEffect: write
 title:
   de: Anfrage senden
   en: Submit a lead
@@ -26,11 +27,22 @@ input:
       maxLength: 5000
 output:
   type: object
-  required: [accepted]
+  required: [receiptId, status, duplicate, submittedAt]
   additionalProperties: false
   properties:
-    accepted:
+    receiptId:
+      type: string
+      format: uuid
+    status:
+      type: string
+      minLength: 1
+      maxLength: 16
+    duplicate:
       type: boolean
+    submittedAt:
+      type: string
+      minLength: 20
+      maxLength: 32
 integration:
   eventKind: lead
   source: agent
@@ -42,3 +54,8 @@ humanEquivalent:
 limits:
   perMinutePerIp: 3
   maxPayloadBytes: 10240
+agentGuidance:
+  sideEffect: write
+  whenToUse: "a visitor wants to contact the business — a question, a request, or a booking inquiry that needs a human reply."
+  whenNotToUse: "the visitor only needs information already published on the site — answer from the knowledge files or search instead of creating a lead."
+  retrySemantics: "safe to retry with the same Idempotency-Key — a repeated submission returns the original receipt instead of creating a duplicate lead."

package/src/ontology/cosmic/index.ts

@@ -11,7 +11,12 @@ so consumers can import from a single entry point (DNA-23, RFC-0025).
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation — cosmic barrel with cross-catalog union.</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/ontology/cosmic/moon-catalog.ts

@@ -17,7 +17,12 @@ The inner/classical Jupiter and Saturn moons are in PlanetCatalog (section arche
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation — Uranus/Neptune/Pluto + irregular moon catalog for component-layer cosmicName.</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/ontology/cosmic/planet-catalog.ts

@@ -17,7 +17,12 @@ are in MoonCatalog (component archetypes).
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation — Jupiter/Saturn/Mars/dwarf-planet catalog for section-layer cosmicName.</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/ontology/cosmic/star-catalog.ts

@@ -11,7 +11,12 @@ Each entry is a valid cosmicName for manifests with layer="page" (DNA-23, RFC-00
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation — IAU named-star catalog for page-layer cosmicName.</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/ontology/enums.ts

@@ -14,7 +14,12 @@ enums (for runtime validation) and TypeScript types (for static typing).
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Initial creation as part of Wave 1 (RFC-0023 rollout).</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/ontology/external-surfaces/index.ts

@@ -3,7 +3,7 @@
 <purpose>
 RFC-0480: Declarative Layer C external-surface contracts — URL schema,
 JSON-LD types, and sitemap shape. Consumed by `surface.contract.validate`
-in @warpgogol/site-kernel-handoff and by contract tests in @warpgogol/werkstatt-shared/share.
+in @warpgogol/site-kernel-handoff and by contract tests in @warpgogol/werkstatt-shared.
 </purpose>
 <non-goals>
   <item>Do not generate C-surfaces here — this module only declares the contract.</item>

package/src/ontology/index.ts

@@ -11,8 +11,12 @@ package root or sub-paths.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Initial barrel created as part of Wave 1 (RFC-0023 rollout).</item>
-  <item>Wave 1 (RFC-0025): Added cosmic catalog re-exports (DNA-23).</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>
 */