@warpgogol/werkstatt-shared 0.14.1 → 0.16.0

package/src/ontology/operations/werkstatt.ts

@@ -0,0 +1,48 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-0362: Zod schemas for Werkstatt consistency primitives — lock files and
+operation records. These schemas are the machine-checkable contract for all
+Werkstatt lock and idempotency operations.
+</purpose>
+<non-goals>
+  <item>Do not perform file IO — pure shape only.</item>
+  <item>Do not define hash-chain Bordbuch format — that is RFC-0276/RFC-0355.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0362: initial Werkstatt schemas (WerkstattLock, WerkstattOperationRecord).</item>
+</CHANGE_SUMMARY>
+*/
+
+import { z } from "zod";
+
+export const werkstattLockSchema = z.object({
+  schemaVersion: z.literal("1.0.0"),
+  scope: z.string().min(1),
+  operationId: z.string().min(1),
+  command: z.string().min(1),
+  owner: z.string().min(1),
+  pid: z.number().int(),
+  startedAt: z.string().datetime(),
+  heartbeatAt: z.string().datetime(),
+  timeoutSeconds: z.number().positive(),
+  depth: z.number().int().positive().optional(),
+});
+
+export const werkstattOperationRecordSchema = z.object({
+  schemaVersion: z.literal("1.0.0"),
+  operationId: z.string().min(1),
+  command: z.string().min(1),
+  scopes: z.array(z.string().min(1)),
+  state: z.enum(["started", "completed", "failed"]),
+  startedAt: z.string().datetime(),
+  completedAt: z.string().datetime().nullable(),
+  inputHash: z.string().min(1),
+  resultHash: z.string().nullable(),
+  artifacts: z.array(z.string()),
+  error: z.string().nullable(),
+});
+
+export type WerkstattLock = z.infer<typeof werkstattLockSchema>;
+export type WerkstattOperationRecord = z.infer<typeof werkstattOperationRecordSchema>;

package/src/ontology/schemas/biome.ts

@@ -14,9 +14,14 @@ Applied via html[data-biome="<id>"] in the cascade layer stack.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation.</item>
   <item>RFC-0071: Replace narrow token overrides with the extended biome visual-DNA contract.</item>
   <item>RFC-0371: Add optional <code>fonts</code> field for biome-driven Fontsource CSS imports.</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>
 */
 
@@ -186,7 +191,7 @@ export const biomeConstraintsSchema = z
   .strict();
 
 // RFC-0114: site-background layer schema mirrored from
-// @warpgogol/werkstatt-shared/share/schemas/site-background. Defined locally to avoid a
+// @warpgogol/werkstatt-shared/schemas/site-background. Defined locally to avoid a
 // cross-package import dependency (ontology must not depend on share).
 const biomeSiteBackgroundLayerSchema = z.discriminatedUnion("kind", [
   z

package/src/ontology/schemas/capability.ts

@@ -8,13 +8,15 @@ lossless projection to both OpenAPI (RFC-0289) and MCP tool schemas (RFC-0290).
 </purpose>
 <non-goals>
   <item>Do not resolve entitlements or active-capability logic here — that is
-        @warpgogol/werkstatt-shared/share/agent/capability.ts (resolveActiveCapabilities).</item>
+        @warpgogol/werkstatt-shared/agent/capability.ts (resolveActiveCapabilities).</item>
   <item>Do not widen the JSON-Schema subset beyond what OpenAPI + MCP both
         accept verbatim — widening requires an RFC amending RFC-0288.</item>
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0288: initial capability record schema.</item>
+  <item>RFC-1112: add sideEffect ("write"|"none"); integration + humanEquivalent become optional and are required unless sideEffect is "none".</item>
+  <item>RFC-1115: add optional agentGuidance block (sideEffect, whenToUse, whenNotToUse, retrySemantics) rendered into MCP tool descriptions and OpenAPI operation docs.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -80,6 +82,22 @@ const capabilityLimitsSchema = z
   })
   .strict();
 
+/**
+ * RFC-1115: model-oriented guidance rendered into MCP tool descriptions and
+ * OpenAPI operation docs. `sideEffect` restates the record-level sideEffect so
+ * the guidance block is self-contained — a superRefine keeps them consistent.
+ * `retrySemantics` describes the RFC-1112 Idempotency-Key contract
+ * descriptively; the mechanism stays owned by RFC-1112.
+ */
+const capabilityAgentGuidanceSchema = z
+  .object({
+    sideEffect: z.enum(["write", "none"]),
+    whenToUse: z.string().min(1),
+    whenNotToUse: z.string().min(1).optional(),
+    retrySemantics: z.string().min(1).optional(),
+  })
+  .strict();
+
 /** RFC-0288: one capability catalog record (packages/werkstatt-site/src/domain/ontology/capabilities/<id>.yaml). */
 export const capabilityRecordSchema = z
   .object({
@@ -90,15 +108,49 @@ export const capabilityRecordSchema = z
     /** Integer; bump on breaking input/output change (by RFC). */
     version: z.number().int().positive(),
     kind: z.literal("action"),
+    /**
+     * RFC-1112: "write" (default when absent) dispatches an IntegrationEvent;
+     * "none" marks a side-effect-free preview that validates input and returns
+     * a draftId without dispatching.
+     */
+    sideEffect: z.enum(["write", "none"]).optional(),
     title: localizedStringSchema,
     description: localizedStringSchema,
     input: capabilityInputOutputSchema,
     output: capabilityInputOutputSchema,
-    integration: capabilityIntegrationSchema,
+    integration: capabilityIntegrationSchema.optional(),
     requires: capabilityRequiresSchema,
-    humanEquivalent: capabilityHumanEquivalentSchema,
+    humanEquivalent: capabilityHumanEquivalentSchema.optional(),
     limits: capabilityLimitsSchema,
+    agentGuidance: capabilityAgentGuidanceSchema.optional(),
   })
-  .strict();
+  .strict()
+  .superRefine((record, ctx) => {
+    // RFC-1115: agentGuidance.sideEffect must restate the effective record-level
+    // sideEffect (absent means "write") — contradictory declarations are drift.
+    const effectiveSideEffect = record.sideEffect ?? "write";
+    if (record.agentGuidance && record.agentGuidance.sideEffect !== effectiveSideEffect) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["agentGuidance", "sideEffect"],
+        message: `must match the record-level sideEffect ("${effectiveSideEffect}")`,
+      });
+    }
+    if (record.sideEffect === "none") return;
+    if (!record.integration) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["integration"],
+        message: 'required unless sideEffect is "none"',
+      });
+    }
+    if (!record.humanEquivalent) {
+      ctx.addIssue({
+        code: "custom",
+        path: ["humanEquivalent"],
+        message: 'required unless sideEffect is "none"',
+      });
+    }
+  });
 
 export type CapabilityRecord = z.infer<typeof capabilityRecordSchema>;

package/src/ontology/schemas/constellation.ts

@@ -12,7 +12,12 @@ section archetypes that forms a proven page structure for a given intent
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation.</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/schemas/index.ts

@@ -9,10 +9,14 @@ Re-exports the Constellation, Biome, SiteFamily, and SystemManifest schemas and
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation.</item>
   <item>RFC-0071: Re-export site-family contract and expanded biome surface.</item>
   <item>RFC-0371: Re-export biome font entry schema and types.</item>
-  <item>Architecture review 2026-07-10: extracted platform operations schemas to @warpgogol/werkstatt-shared/ontology/operations; re-export getSectionPropsSchema from manifest-resolver.ts.</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/schemas/manifest-resolver.ts

@@ -11,8 +11,13 @@ filesystem I/O, YAML parsing, and fragment composition behind one interface.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Architecture review 2026-07-10: extracted from page-entry.ts to separate declarative schemas from runtime I/O.</item>
   <item>RFC-0484: suppress console.debug for directories without manifests — group directories are expected to have none.</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/schemas/page-entry.ts

@@ -6,14 +6,18 @@ Every page .md file under apps/<app>/src/content/pages/ must conform to PageEntr
 Exports BlockEntrySchema and PageEntrySchema — pure declarative schemas, no I/O.
 </purpose>
 <non-goals>
-  <item>Do not implement the buildPage pipeline here — that lives in @warpgogol/werkstatt-shared/share/page.</item>
+  <item>Do not implement the buildPage pipeline here — that lives in @warpgogol/werkstatt-shared/page.</item>
   <item>Do not parse YAML here; callers provide parsed objects to schema.parse().</item>
   <item>Do not validate cross-system.yaml references — that is page.block.validate's job.</item>
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0026): Initial creation.</item>
-  <item>Architecture review 2026-07-10: extracted getSectionPropsSchema into manifest-resolver.ts — page-entry.ts is now pure declarative schemas with no I/O.</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>
 */
 
@@ -35,8 +39,8 @@ const PRINT_REGIONS = [
 ] as const;
 
 // ---------------------------------------------------------------------------
-// VisibilityExprSchema (re-declared here to avoid cross-package dep on @warpgogol/werkstatt-shared/share)
-// page.block.validate uses the canonical one from @warpgogol/werkstatt-shared/share;
+// VisibilityExprSchema (re-declared here to avoid cross-package dep on @warpgogol/werkstatt-shared/page)
+// page.block.validate uses the canonical one from @warpgogol/werkstatt-shared/page;
 // the schema here is for Astro content-collection integration.
 // ---------------------------------------------------------------------------
 

package/src/ontology/schemas/system/growth.ts

@@ -8,7 +8,12 @@ Exports growthVendorSchema as the canonical vendor config shape, reused by @warp
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0303 Phase 3: extracted from schemas/system.ts as part of the domain split.</item>
-  <item>Architecture review 2026-07-10: Extracted growthVendorSchema so @warpgogol/werkstatt-site/growth/config.ts can import it instead of duplicating the shape.</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/schemas/system/manifest.ts

@@ -9,6 +9,9 @@
   <item>RFC-0303 Phase 3: extracted from schemas/system.ts as part of the domain split.</item>
   <item>RFC-0377: added optional `audience` field to the per-page pin schema.</item>
   <item>ADR-0062: added `ctaTarget` to identity, `sectionNav` + `ctaTarget` to page pins, created `systemCollectionSchema` for content collection typing.</item>
+  <item>RFC-1106: step 2 — extend systemManifestSchema
+
+Add identity.legal (RFC-0096) and seo.anchorText.extraStopPhrases (RFC-0911) to systemManifestSchema — the two interface-only fields with living consumers. No dead fields found: all other interface fields already exist in the schema.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -16,7 +19,7 @@ import { z } from "zod";
 
 import { systemSharedContextSchema, systemGrowthSchema } from "./growth.ts";
 import { systemReleaseSchema } from "./release.ts";
-import { systemTextSchema } from "./text.ts";
+import { systemTextSchema, systemTypographySchema } from "./text.ts";
 import { systemIntegrationsSchema } from "./integrations.ts";
 import { systemVerificationSchema } from "./verification.ts";
 import { semanticPageTypeSchema, articleMetadataSchema, pageOutputSchema } from "./page-output.ts";
@@ -87,6 +90,18 @@ export const systemManifestSchema = z.object({
      * Used by resolve-route.ts to populate `ctaTarget` in PageRouteData.
      */
     ctaTarget: z.string().min(1).optional(),
+
+    /**
+     * RFC-0096: Operator details consumed by legal.scaffold to fill
+     * Impressum / Datenschutz stubs.
+     */
+    legal: z
+      .object({
+        responsibleName: z.string().min(1).optional(),
+        address: z.string().min(1).optional(),
+        email: z.string().min(1).optional(),
+      })
+      .optional(),
   }),
 
   /**
@@ -294,6 +309,12 @@ export const systemManifestSchema = z.object({
    */
   text: systemTextSchema.optional(),
 
+  /**
+   * RFC-1070: typography validator configuration. Allowed tokens and
+   * per-locale abbreviation overrides. Client-writable.
+   */
+  typography: systemTypographySchema.optional(),
+
   /**
    * RFC-0169: subscription billing binding. `billing.stripeCustomerId` is the
    * Stripe customer whose active Entitlements gate this site's paid modules.
@@ -494,6 +515,8 @@ export const systemManifestSchema = z.object({
    * `responsibilityBlock.swapOrder` is true, the page handler swaps
    * primaryItems/secondaryItems and labels.primary/labels.secondary at
    * render time. Default false = render as authored in content.
+   * RFC-1087: `codeHighlightTheme` selects the Shiki theme for build-time
+   * syntax highlighting. Default "github-light" when absent.
    */
   ui: z
     .object({
@@ -502,6 +525,7 @@ export const systemManifestSchema = z.object({
           swapOrder: z.boolean().optional().default(false),
         })
         .optional(),
+      codeHighlightTheme: z.string().min(1).optional(),
     })
     .optional(),
 
@@ -511,6 +535,21 @@ export const systemManifestSchema = z.object({
    * When absent, search.verification.validate emits SEARCH-VERIFY-01.
    */
   verification: systemVerificationSchema.optional(),
+
+  /**
+   * RFC-0911: SEO validator configuration extension point.
+   * Sites extend the built-in de/uk anchor-text stop-list via
+   * `seo.anchorText.extraStopPhrases` (lang → phrases).
+   */
+  seo: z
+    .object({
+      anchorText: z
+        .object({
+          extraStopPhrases: z.record(z.string(), z.array(z.string())).optional(),
+        })
+        .optional(),
+    })
+    .optional(),
 });
 
 export type SystemManifest = z.infer<typeof systemManifestSchema>;

package/src/ontology/schemas/system/page-output.ts

@@ -7,6 +7,9 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0303 Phase 3: extracted from schemas/system.ts as part of the domain split.</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>
 </CHANGE_SUMMARY>
 */
 
@@ -15,13 +18,11 @@ import { z } from "zod";
 /**
  * RFC-0042/RFC-0050: the semantic role of a page. Drives semantic model
  * construction and the default llms inclusion depth. Mirrors
- * SemanticPageType in @warpgogol/werkstatt-shared/share/semantic.
+ * SemanticPageType in @warpgogol/werkstatt-shared/semantic.
  */
-// NOTE: This enum is mirrored by the `SemanticPageType` union in
-// `@warpgogol/werkstatt-shared/share/src/semantic/models.ts`. The Zod schema here is the runtime
-// validator for `system.md`; the TypeScript union in `share` is the
-// compile-time contract. They are kept in sync manually to avoid a circular
-// dependency between `ontology` and `share`.
+// RFC-1106: this schema is the sole declaration of the SemanticPageType closed
+// vocabulary (DNA-19). `semantic/models.ts` derives the type and the runtime
+// array from it — do not declare a parallel union elsewhere.
 export const semanticPageTypeSchema = z.enum([
   "home",
   "about",

package/src/ontology/schemas/system/text.ts

@@ -7,6 +7,7 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0303 Phase 3: extracted from schemas/system.ts as part of the domain split.</item>
+  <item>RFC-1070: added systemTypographySchema for typography validator configuration.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -49,6 +50,20 @@ export const systemTextNormalizeSchema = z
   })
   .strict();
 
+/**
+ * The `typography` block in system.yaml (RFC-1070). Controls typography validator
+ * configuration: allowed tokens and per-locale abbreviation overrides.
+ * CLIENT-WRITABLE.
+ */
+export const systemTypographySchema = z
+  .object({
+    /** Additional allowed tokens exempt from TYPO-CASE-01 and TYPO-APOS rules. */
+    allowedTokens: z.array(z.string()).optional(),
+    /** Per-locale abbreviation overrides. Merged into built-in locale defaults. */
+    abbreviations: z.record(z.string(), z.array(z.string())).optional(),
+  })
+  .strict();
+
 export const systemTextSchema = z
   .object({
     normalize: systemTextNormalizeSchema.optional(),

package/src/ontology/schemas/system.ts

@@ -13,10 +13,14 @@ Stored at apps/<app-slug>/system.yaml.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0025): Initial creation.</item>
-  <item>Wave 1 (RFC-0027): Added growth block — vendor adapter binding, active funnels, active experiments.</item>
   <item>RFC-0328: Added "legal" to semanticPageTypeSchema.</item>
   <item>RFC-0303 Phase 3: split the flat 822-line file into sub-modules under system/; this file is now the re-export shim.</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/shared-section-props/body-fragments.ts

@@ -33,6 +33,8 @@ export const BODY_LIST_FRAGMENT: JsonSchemaFragment = {
         note: { type: "string" },
         iconColor: ICON_COLOR_ENUM,
         align: ALIGN_ENUM,
+        itemAlign: ALIGN_ENUM,
+        hideMarkers: { type: "boolean" },
         effects: EFFECTS_ARRAY_SCHEMA,
       },
     },

package/src/ontology/tests/sternsystem-owner.test.ts

@@ -1,5 +1,5 @@
 import { test, expect, describe } from "vitest";
-import { systemConfigSchema } from "@warpgogol/werkstatt-engine/schemas";
+import { systemConfigSchema } from "@warpgogol/werkstatt-shared/ontology/operations";
 
 const validBaseEntry = {
   schemaVersion: "system-config/v1",

package/src/ontology/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 → page}/page.ts

@@ -11,17 +11,21 @@ pipeline for each block defined in a page's content.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Wave 1 (RFC-0026): Initial creation — ResolvedPage/ResolvedBlock types and buildPage pipeline.</item>
-  <item>Moved SectionProps into shared package for cross-app consumption.</item>
-  <item>RFC-0091: PLANET_IMPORT_PATHS and BLOCK_TYPE_TO_COSMIC_NAME now derived from registry; import from @warpgogol/werkstatt-shared/ontology/archetypes instead of literal constants.</item>
   <item>RFC-0262: add the optional BuildPageOptions.validateProps dev-time fail-fast hook, called once per resolved shell and content block.</item>
   <item>RFC-0263: hideSectionNumber injection now keyed off registry-derived roleByCosmicName[planetName] === "hero" instead of the hardcoded UNNUMBERED_HERO_PLANETS literal set (deleted).</item>
-  <item>RFC-0264: relocated SectionProps/SectionPageOverride here from the @warpgogol/werkstatt-shared/share root barrel (its natural domain owner); consumers now import from @warpgogol/werkstatt-shared/share/page.</item>
+  <item>RFC-0264: relocated SectionProps/SectionPageOverride here from the @warpgogol/werkstatt-shared root barrel (its natural domain owner); consumers now import from @warpgogol/werkstatt-shared/page.</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-0091</history>
 </CHANGE_SUMMARY>
 */
 
-import type { RuntimeContext } from "./runtime-context.ts";
-import { evalVisibility, type ResolvedFeatureGraph, EMPTY_FEATURE_GRAPH } from "./visibility.ts";
+import type { RuntimeContext } from "../runtime/runtime-context.ts";
+import { evalVisibility, type ResolvedFeatureGraph, EMPTY_FEATURE_GRAPH } from "../policy/visibility.ts";
 import {
   planetImportPaths as registryPlanetImportPaths,
   blockTypeToCosmicName as registryBlockTypeToCosmicName,
@@ -48,7 +52,7 @@ export interface BlockEntry {
   type?: string; // CMS-facing archetype slug — validated by page.block.validate
   use?: string; // PlanetName or MoonName — normalized from type for internal resolution
   props: Record<string, unknown>;
-  visibility?: import("./visibility.ts").VisibilityExpr;
+  visibility?: import("../policy/visibility.ts").VisibilityExpr;
   /** Block layer — shell blocks render before content blocks (RFC-0036). */
   layer?: "shell" | "section";
 }
@@ -89,7 +93,7 @@ export interface ResolvedBlock {
   /** Props already evaluated and ready to spread into the component. */
   readonly props: Record<string, unknown>;
   /** The raw visibility expression (retained for attribution / debugging). null if absent. */
-  readonly visibility: import("./visibility.ts").VisibilityExpr | null;
+  readonly visibility: import("../policy/visibility.ts").VisibilityExpr | null;
   /** Block layer — shell blocks are prepended and render before content blocks (RFC-0036). */
   readonly layer?: "shell" | "section";
 }
@@ -111,7 +115,7 @@ export interface ResolvedPage {
 }
 
 // RFC-0035: Universal Section Props Contract — every resolved content block's
-// props extend this shape. RFC-0264: relocated from the @warpgogol/werkstatt-shared/share root
+// props extend this shape. RFC-0264: relocated from the @warpgogol/werkstatt-shared root
 // barrel to page.ts (its natural domain owner); re-exported from the `./page`
 // subpath.
 export interface SectionProps {

package/src/{share → page}/tests/dev-props-validator.test.ts

@@ -1,6 +1,6 @@
 import { test, expect } from "vitest";
 import { buildPage, type PageEntry } from "../page.ts";
-import { EMPTY_RUNTIME_CONTEXT } from "../runtime-context.ts";
+import { EMPTY_RUNTIME_CONTEXT } from "../../runtime/runtime-context.ts";
 
 /*
 <MODULE_CONTRACT>

package/src/{share → page}/tests/hero-section-numbering-parity.test.ts

@@ -1,6 +1,6 @@
 import { test, expect } from "vitest";
 import { buildPage, type PageEntry } from "../page.ts";
-import { EMPTY_RUNTIME_CONTEXT } from "../runtime-context.ts";
+import { EMPTY_RUNTIME_CONTEXT } from "../../runtime/runtime-context.ts";
 
 /*
 <MODULE_CONTRACT>