@warpgogol/werkstatt-shared 0.14.0 → 0.15.0

package/src/{share/agent → agent}/ard-catalog.ts

@@ -12,7 +12,12 @@ passes it here.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Initial ARD ai-catalog.json projection for isitagentready.com ARD check.</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/agent → agent}/dns-aid.test.ts

@@ -11,8 +11,8 @@ Verifies determinism, domain extraction, and content URL construction.
 */
 
 import { describe, it, expect } from "vitest";
-import { buildDnsAidRecord } from "@warpgogol/werkstatt-shared/share/agent";
-import type { AgentSurfaceManifest } from "@warpgogol/werkstatt-shared/share/agent";
+import { buildDnsAidRecord } from "@warpgogol/werkstatt-shared/agent";
+import type { AgentSurfaceManifest } from "@warpgogol/werkstatt-shared/agent";
 
 function makeManifest(baseUrl: string): AgentSurfaceManifest {
   return {

package/src/{share/agent → agent}/manifest.ts

@@ -15,6 +15,7 @@ two runs on unchanged input are byte-identical (AS-7).
 <CHANGE_SUMMARY>
   <item>RFC-0286: initial manifest contract and pure builder.</item>
   <item>RFC-0954: add search interface to AgentSurfaceManifest.interfaces.</item>
+  <item>RFC-1076: add claims field to AgentSurfaceManifest, AgentClaimRef type, bump AGENT_SURFACE_VERSION to 1.1.0.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -22,7 +23,7 @@ import { createHash } from "node:crypto";
 import type { AgentSurfaceProof } from "./proof.ts";
 
 /** Semver of THIS manifest schema. Bump only via an RFC amending RFC-0286 (AS-7). */
-export const AGENT_SURFACE_VERSION = "1.0.0";
+export const AGENT_SURFACE_VERSION = "1.1.0";
 
 export interface AgentKnowledgeRef {
   /** A BusinessDomain with visibility "public" (RFC-0287). */
@@ -41,6 +42,14 @@ export interface AgentActionRef {
   entitlement: "agent.actions";
 }
 
+export interface AgentClaimRef {
+  id: string;
+  claimClass: string;
+  statement: string;
+  verificationLevel?: string;
+  evidenceCount: number;
+}
+
 export interface AgentSurfaceManifest {
   surfaceVersion: string;
   site: string;
@@ -50,6 +59,8 @@ export interface AgentSurfaceManifest {
   contentHash: string;
   knowledge: AgentKnowledgeRef[];
   actions: AgentActionRef[];
+  /** RFC-1076: claim provenance chain — claims with their evidence references. */
+  claims: AgentClaimRef[];
   interfaces: {
     llms: string;
     twins: { pattern: string } | null;
@@ -67,6 +78,8 @@ export interface AgentSurfaceManifestInput {
   languages: { default: string; supported: string[] };
   knowledge?: AgentKnowledgeRef[];
   actions?: AgentActionRef[];
+  /** RFC-1076: claim provenance summaries for the manifest. */
+  claims?: AgentClaimRef[];
   hasTwins?: boolean;
   openapiUrl?: string | null;
   mcp?: { url: string; protocolVersion: string } | null;
@@ -135,6 +148,7 @@ export function buildAgentSurfaceManifest(input: AgentSurfaceManifestInput): Age
     },
     knowledge: [...(input.knowledge ?? [])].sort((a, b) => a.domain.localeCompare(b.domain)),
     actions: [...(input.actions ?? [])].sort((a, b) => a.id.localeCompare(b.id)),
+    claims: [...(input.claims ?? [])].sort((a, b) => a.id.localeCompare(b.id)),
     interfaces: {
       llms: "/llms.txt",
       twins: input.hasTwins ? { pattern: "/**.md" } : null,

package/src/{share/agent → agent}/search.ts

@@ -14,7 +14,12 @@ no timestamps in the hash payload.
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0954: initial search manifest contract, query/response types, and pure builder.</item>
-  <item>m000101: add NON_KNOWLEDGE_FILES and isNonKnowledgeFile for shared non-knowledge-file exclusion.</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 → agent}/tests/api-catalog.test.ts

@@ -12,8 +12,8 @@
 */
 
 import { test, expect } from "vitest";
-import { buildApiCatalog } from "../agent/api-catalog.ts";
-import { buildAgentSurfaceManifest } from "../agent/manifest.ts";
+import { buildApiCatalog } from "../api-catalog.ts";
+import { buildAgentSurfaceManifest } from "../manifest.ts";
 
 test("buildApiCatalog: empty manifest yields service-meta + service-doc links", () => {
   const manifest = buildAgentSurfaceManifest({

package/src/{share → agent}/tests/ard-catalog.test.ts

@@ -9,8 +9,8 @@
 */
 
 import { test, expect } from "vitest";
-import { buildArdCatalog } from "../agent/ard-catalog.ts";
-import { buildAgentSurfaceManifest } from "../agent/manifest.ts";
+import { buildArdCatalog } from "../ard-catalog.ts";
+import { buildAgentSurfaceManifest } from "../manifest.ts";
 
 test("buildArdCatalog: produces specVersion, host, and entries array", () => {
   const manifest = buildAgentSurfaceManifest({

package/src/{share → agent}/tests/capability.test.ts

@@ -16,7 +16,7 @@ import {
   resolveActiveCapabilities,
   capabilityToActionRef,
   type CapabilityRecord,
-} from "../agent/capability.ts";
+} from "../capability.ts";
 
 function makeCap(overrides: Partial<CapabilityRecord> = {}): CapabilityRecord {
   return {

package/src/{share → agent}/tests/fleet-catalog.test.ts

@@ -16,7 +16,7 @@ import {
   buildFleetAgentCatalog,
   computeFleetCatalogContentHash,
   FLEET_AGENT_CATALOG_SCHEMA,
-} from "../agent/fleet-catalog.ts";
+} from "../fleet-catalog.ts";
 
 const sampleDoc = {
   surfaceVersion: "1.0.0",

package/src/{share → agent}/tests/knowledge.test.ts

@@ -16,8 +16,8 @@ import {
   AGENT_KNOWLEDGE_DOMAINS,
   isAgentKnowledgeDomain,
   formatAgentKnowledge,
-} from "../agent/knowledge.ts";
-import { BUSINESS_DOMAIN_VISIBILITY } from "../semantic/business-projection.ts";
+} from "../knowledge.ts";
+import { BUSINESS_DOMAIN_VISIBILITY } from "../../semantic/business-projection.ts";
 
 test("AGENT_KNOWLEDGE_DOMAINS: matches exactly the `public` BUSINESS_DOMAIN_VISIBILITY keys", () => {
   const publicDomains = Object.entries(BUSINESS_DOMAIN_VISIBILITY)

package/src/{share → agent}/tests/manifest.test.ts

@@ -19,7 +19,7 @@ import {
   computeAgentManifestContentHash,
   computeSignedContentHash,
   canonicalJson,
-} from "../agent/manifest.ts";
+} from "../manifest.ts";
 
 const baseInput = {
   site: "warpgogol-com",

package/src/{share → agent}/tests/mcp-card.test.ts

@@ -12,8 +12,8 @@
 */
 
 import { test, expect } from "vitest";
-import { buildMcpServerCard } from "../agent/mcp-card.ts";
-import { buildAgentSurfaceManifest } from "../agent/manifest.ts";
+import { buildMcpServerCard } from "../mcp-card.ts";
+import { buildAgentSurfaceManifest } from "../manifest.ts";
 
 test("buildMcpServerCard: null mcp → returns null", () => {
   const manifest = buildAgentSurfaceManifest({

package/src/agent/tests/omit-empty.test.ts

@@ -0,0 +1,33 @@
+import { describe, it, expect } from "vitest";
+import { omitEmptyKnowledgeValues } from "../omit-empty.ts";
+
+describe("omitEmptyKnowledgeValues", () => {
+  it("is a function", () => {
+    expect(typeof omitEmptyKnowledgeValues).toBe("function");
+  });
+
+  it("removes empty strings, null, undefined, empty arrays, and empty objects", () => {
+    const input = { a: "value", b: "", c: null, d: undefined, e: [], f: {} };
+    const result = omitEmptyKnowledgeValues(input);
+    expect(result).not.toHaveProperty("b");
+    expect(result).not.toHaveProperty("c");
+    expect(result).not.toHaveProperty("d");
+    expect(result).not.toHaveProperty("e");
+    expect(result).not.toHaveProperty("f");
+    expect(result).toHaveProperty("a", "value");
+  });
+
+  it("preserves false and 0 (schema-allowed falsy values)", () => {
+    const input = { enabled: false, count: 0 };
+    const result = omitEmptyKnowledgeValues(input);
+    expect(result).toHaveProperty("enabled", false);
+    expect(result).toHaveProperty("count", 0);
+  });
+
+  it("preserves non-empty arrays and objects", () => {
+    const input = { items: [1, 2], nested: { x: 1 } };
+    const result = omitEmptyKnowledgeValues(input);
+    expect(result).toHaveProperty("items", [1, 2]);
+    expect(result).toHaveProperty("nested", { x: 1 });
+  });
+});

package/src/{share → agent}/tests/openapi.test.ts

@@ -13,8 +13,8 @@
 */
 
 import { test, expect } from "vitest";
-import { formatAgentOpenApi } from "../agent/openapi.ts";
-import { buildAgentSurfaceManifest } from "../agent/manifest.ts";
+import { formatAgentOpenApi } from "../openapi.ts";
+import { buildAgentSurfaceManifest } from "../manifest.ts";
 
 test("formatAgentOpenApi: empty manifest yields a valid document with no paths", () => {
   const manifest = buildAgentSurfaceManifest({

package/src/{share → agent}/tests/proof.test.ts

@@ -16,7 +16,7 @@ import {
   buildAgentSigningPayload,
   AGENT_PROOF_DOMAIN,
   type AgentProofArtifactKind,
-} from "../agent/proof.ts";
+} from "../proof.ts";
 
 function decodePayload(bytes: Uint8Array): string {
   return new TextDecoder().decode(bytes);

package/src/{share → attribution}/material-credits.ts

@@ -25,19 +25,19 @@ import {
   materialCreditSchema,
   materialTargetKey,
   formatMaterialCreditLine,
-} from "./schemas/material-credit.ts";
+} from "../schemas/material-credit.ts";
 
-// RFC-0488: re-export label mapping helpers for @warpgogol/werkstatt-shared/share/material-credits consumers.
+// RFC-0488: re-export label mapping helpers for @warpgogol/werkstatt-shared/attribution/material-credits consumers.
 export {
   labelForSourceType,
   labelForStatus,
   labelForUsageBasis,
-} from "./schemas/material-credit.ts";
+} from "../schemas/material-credit.ts";
 export type {
   MaterialSourceType,
   MaterialCreditStatus,
   UsageBasisType,
-} from "./schemas/material-credit.ts";
+} from "../schemas/material-credit.ts";
 
 export interface MaterialCreditRecord {
   file: string;

package/src/{share → checks}/check-hints.ts

@@ -6,7 +6,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Initial implementation for check-warpgogol hints support.</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/checks/index.ts

@@ -1,6 +1,6 @@
 /*
 <MODULE_CONTRACT>
-<purpose>Shared check infrastructure barrel for @warpgogol/werkstatt-shared — exports diagnosticsResult, suppressions, i18n, and astro-site-url helpers (RFC-0868).</purpose>
+<purpose>Shared checks index barrel for @warpgogol/werkstatt-shared — exports diagnosticsResult, suppressions, i18n, and astro-site-url helpers (RFC-0868).</purpose>
 <non-goals>
   <item>Do not export site-specific validators or pipeline definitions.</item>
   <item>Do not import from @warpgogol/werkstatt-site or any stack plugin.</item>
@@ -8,6 +8,9 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0868: extracted from werkstatt-site/src/checks as shared infrastructure.</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>
 </CHANGE_SUMMARY>
 */
 

package/src/checks/lib/astro-site-url.ts

@@ -6,7 +6,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Added Compass scaffolding.</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/checks/lib/i18n.ts

@@ -1,3 +1,17 @@
+/*
+<MODULE_CONTRACT>
+<purpose>i18n helpers for check validators — read the default language code from a site system.md frontmatter.</purpose>
+<non-goals>
+  <item>Do not load translation catalogs — this module only resolves the default language code.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <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>
+</CHANGE_SUMMARY>
+*/
+
 import { join } from "node:path";
 import { readFile } from "node:fs/promises";
 import { parse as parseYaml } from "yaml";

package/src/checks/result-helpers.ts

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

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

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

package/src/{share → client-scripts}/counter-utils.ts

@@ -7,8 +7,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Created shared counter utilities to eliminate duplication between hero and impact sections.</item>
-  <item>getStartValue now generates "1" in highest digit (e.g., "1,000" instead of "0,000") for better visual feedback during count-up.</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/scripts → client-scripts}/external-link-qr.ts

@@ -114,29 +114,27 @@ export function initExternalLinkQr(options?: ExternalLinkQrOptions): void {
     return !modal.hidden;
   }
 
-  function handleTriggerClick(e: Event): void {
-    const trigger = e.currentTarget as HTMLElement;
-    const anchor = trigger.closest("a");
+  function handleDelegatedClick(e: Event): void {
+    const anchor = (e.target as HTMLElement)?.closest?.("a[data-external-link]");
     if (!anchor) return;
 
     const href = anchor.getAttribute("href");
     if (!href) return;
 
     e.preventDefault();
-    e.stopPropagation();
-    openModal(href, trigger);
+    openModal(href, anchor as HTMLElement);
   }
 
-  function handleTriggerKeydown(e: KeyboardEvent): void {
+  function handleDelegatedKeydown(e: KeyboardEvent): void {
     if (e.key !== "Enter" && e.key !== " ") return;
-    e.preventDefault();
-    e.stopPropagation();
-    const trigger = e.currentTarget as HTMLElement;
-    const anchor = trigger.closest("a");
+    const anchor = (e.target as HTMLElement)?.closest?.("a[data-external-link]");
     if (!anchor) return;
+
     const href = anchor.getAttribute("href");
     if (!href) return;
-    openModal(href, trigger);
+
+    e.preventDefault();
+    openModal(href, anchor as HTMLElement);
   }
 
   function handleKeydown(e: KeyboardEvent): void {
@@ -173,11 +171,8 @@ export function initExternalLinkQr(options?: ExternalLinkQrOptions): void {
   }
 
   function attachTriggers(): void {
-    const triggers = document.querySelectorAll<HTMLElement>("[data-qr-trigger]");
-    for (const trigger of triggers) {
-      trigger.addEventListener("click", handleTriggerClick);
-      trigger.addEventListener("keydown", handleTriggerKeydown);
-    }
+    document.addEventListener("click", handleDelegatedClick);
+    document.addEventListener("keydown", handleDelegatedKeydown);
   }
 
   overlay.addEventListener("click", closeModal);

package/src/{share/scripts → client-scripts}/external-links.ts

@@ -10,8 +10,13 @@ external-link-qr entitlement is active, also injects a QR trigger span into each
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0011 Phase 2: Extracted from layout.astro inline script into src/scripts canonical pattern.</item>
-  <item>Migrated to @warpgogol/werkstatt-shared/share/scripts for platform-wide reuse.</item>
   <item>RFC-0932: accept ExternalLinkBehaviorOptions, inject QR trigger span when entitled.</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>
 */
 
@@ -52,6 +57,12 @@ export function applyExternalLinkBehavior(options?: ExternalLinkBehaviorOptions)
     anchor.setAttribute("rel", "noopener noreferrer");
 
     if (qrEntitled && anchor.getAttribute("data-external-link-qr") !== "off") {
+      // Skip QR trigger for anchors wrapping media elements — a text arrow
+      // appended after an image/SVG/canvas looks visually wrong.
+      const hasMediaChild = anchor.querySelector("img, svg, canvas, picture");
+      if (hasMediaChild) {
+        continue;
+      }
       if (!anchor.querySelector("[data-qr-trigger]")) {
         const trigger = document.createElement("span");
         trigger.className = "external-link-qr-trigger";

package/src/{share/scripts → client-scripts}/gsap-counter.ts

@@ -8,15 +8,20 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-0040: Created as shared GSAP counter initialization module in @warpgogol/werkstatt-shared/share/scripts.</item>
-  <item>Extended selector to support .hero__stat in addition to .impact-section__stat.</item>
+  <item>RFC-0040: Created as shared GSAP counter initialization module in @warpgogol/werkstatt-shared/client-scripts.</item>
   <item>RFC-0758: Extended selector to support .dynamic-status-block__stat.</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>
 */
 
 // @ai-invariant: RFC-0040. Do not import gsap at the top level. Always dynamic-import inside initGsapCounter.
 
-import { parseNumeric } from "../counter-utils.ts";
+import { parseNumeric } from "./counter-utils.ts";
 
 export interface GsapCounterOptions {
   prefersReducedMotion?: boolean;

package/src/client-scripts/index.ts

@@ -0,0 +1,35 @@
+/* 
+<MODULE_CONTRACT> 
+<purpose>scripts index — central export point for the script modules used in dynamic loading contexts.</purpose> 
+ 
+ 
+<non-goals> 
+<item>Do not define new modules or components.</item> 
+<item>Do not manage application state or business 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 — 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-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> 
+*/
+
+// scheduler.ts is loaded dynamically by orchestrator.ts and lordicon.ts
+export * from "./lordicon.ts";
+export * from "./external-links.ts";
+export * from "./external-link-qr.ts";
+export * from "./lenis.ts";
+export * from "./scroll-spy.ts";
+export * from "./orchestrator.ts";
+// gsap-counter.ts (RFC-0040) is loaded dynamically by orchestrator.ts
+// inline-number-animation.ts (RFC-0041) is loaded dynamically by orchestrator.ts
+// gsap-reveal.ts / gsap-parallax.ts / gsap-stagger.ts (RFC-0106) are loaded
+// dynamically by orchestrator.ts via the reveal / parallax / stagger opt-ins.

package/src/{share/scripts → client-scripts}/inline-number-animation.ts

@@ -8,7 +8,7 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-0041: Created as shared GSAP inline number animation module in @warpgogol/werkstatt-shared/share/scripts.</item>
+  <item>RFC-0041: Created as shared GSAP inline number animation module in @warpgogol/werkstatt-shared/client-scripts.</item>
 </CHANGE_SUMMARY>
 */