feat(phase8): validate local runtime schema fragments

Author: flyingrobots

docs/plans/phase-8-schema-freeze-inventory.md

@@ -175,6 +175,13 @@ The repo advertises `cargo xtask wesley sync`, but `xtask/src/main.rs` does not
 implement it yet. Phase 8 needs a real, deterministic regeneration path before
 generated artifacts can be trusted.
 
+For now, this branch keeps the runtime freeze loop Echo-local:
+
+- the source of truth lives under `schemas/runtime/*.graphql`,
+- local validation happens via `pnpm schema:runtime:check`,
+- and Wesley sync stays deliberately deferred until the upstream Echo-facing
+  schema/compiler contract stops moving.
+
 ### 3. Stale plan naming around scheduler results
 
 The inventory resolves this now: Phase 8 should freeze `SchedulerStatus`,
@@ -233,3 +240,7 @@ This prep slice is complete when:
 - the first runtime schema artifact set is sketched concretely,
 - and the next implementation slice can start from a concrete schema authoring
   target instead of inference from Rust code.
+
+That bar is now met. The next honest Phase 8 slice is Echo-local schema
+hardening and deferred-generation contract work, not premature Wesley
+integration.

package.json

@@ -9,7 +9,8 @@
   "scripts": {
     "docs:dev": "vitepress dev docs",
     "docs:build": "vitepress build docs",
-    "test:e2e": "playwright test"
+    "test:e2e": "playwright test",
+    "schema:runtime:check": "node scripts/validate-runtime-schema-fragments.mjs"
   },
   "devDependencies": {
     "@playwright/test": "^1.48.0",

schemas/runtime/README.md

@@ -33,10 +33,46 @@ That means these files are allowed to exist before:
 - Wesley IR is vendored for the runtime freeze set,
 - or generated Rust replaces hand-written runtime mirrors.
 
+## Validation
+
+Run the local fragment validator before touching any generation plumbing:
+
+```sh
+pnpm schema:runtime:check
+```
+
+The validator does two narrow jobs:
+
+- parse-check the SDL fragments via the repo's existing `prettier --check`
+  toolchain path,
+- and verify that every referenced runtime type is defined somewhere inside the
+  local `schemas/runtime/` fragment set.
+
+This keeps Phase 8 moving without pretending Wesley is already stable enough to
+own the runtime freeze loop.
+
+## Planned Output Contract
+
+Generation is explicitly deferred, but the intended artifact boundary is:
+
+- `schemas/runtime/*.graphql`
+  Human-authored source fragments for Artifacts A-D.
+- `schemas/runtime/generated/runtime-schema.graphql`
+  Planned normalized single-file runtime schema bundle.
+- `schemas/runtime/generated/runtime-ir.json`
+  Planned vendored Wesley IR snapshot for the frozen runtime schema.
+- `schemas/runtime/generated/runtime-manifest.json`
+  Planned vendored schema manifest/metadata for deterministic regeneration.
+
+No generated Rust output path is frozen yet. That stays deferred until Wesley's
+Echo-facing contract stabilizes enough that wiring `cargo xtask wesley sync`
+will not thrash the Phase 8 freeze target.
+
 ## Notes
 
 - These files are SDL **fragments**, not a standalone executable GraphQL API.
 - Comments here carry semantic constraints that current GraphQL type syntax
   cannot express directly, such as opaque-hash ids and logical-counter rules.
 - Generation plumbing (`cargo xtask wesley sync`) still does not exist for this
-  runtime schema tree; Phase 8 is pinning source files before generation.
+  runtime schema tree; Phase 8 is pinning and validating source files before
+  generation.