docs: version-lock Omnigraph walkthroughs and schema reference to active version

The schema reference rendered the live `main` SDL while examples were locked to the
production-deployed version; the walkthroughs hardcoded 1.14.x schema/code against
production endpoints running 1.13.1 — so both were broken against production.

- Schema reference (OmnigraphSchemaDocExplorer) now loads the active version's frozen
  schema.graphql instead of `enssdk/omnigraph/schema.graphql?raw`.
- Walkthroughs (omnigraph-graphql-api, enssdk, enskit) are split into per-version MDX
  partials under @components/walkthroughs/<guide>/, with the route page rendering the
  partial matching ACTIVE_OMNIGRAPH_VERSION. Authored v1.13.1 (production) and v1.14.1
  (blue) variants; promote by bumping the constant.
- HostedInstanceSdkVersionWarning derives the pinned SDK version from the active version.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: shrugs

docs/ensnode.io/src/components/molecules/HostedInstanceSdkVersionWarning.astro

@@ -1,6 +1,8 @@
 ---
 import { Aside } from "@astrojs/starlight/components";
 
+import { ACTIVE_OMNIGRAPH_VERSION } from "@data/omnigraph-examples/active";
+
 interface Props {
   /**
    * Which SDK(s) the warning is for.
@@ -16,25 +18,28 @@ const { for: target = "enssdk" } = Astro.props;
 const isEnskit = target === "enskit";
 const isBoth = target === "both";
 
+// The SDK version is locked to the production-deployed Omnigraph version (see
+// `@data/omnigraph-examples/active`). The SDK bundles the Omnigraph schema, so pinning the matching
+// version keeps gql.tada's generated types aligned with the deployed API. Updates on promotion.
+const sdkVersion = ACTIVE_OMNIGRAPH_VERSION.replace(/^v/, "");
+
 const sdkList = isEnskit
-  ? "<code>enskit@1.13.1</code> and <code>enssdk@1.13.1</code>"
+  ? `<code>enskit@${sdkVersion}</code> and <code>enssdk@${sdkVersion}</code>`
   : isBoth
-    ? "<code>enssdk@1.13.1</code> (and <code>enskit@1.13.1</code> when using React)"
-    : "<code>enssdk@1.13.1</code>";
+    ? `<code>enssdk@${sdkVersion}</code> (and <code>enskit@${sdkVersion}</code> when using React)`
+    : `<code>enssdk@${sdkVersion}</code>`;
 ---
 
 <Aside type="caution" title="Version compatibility with hosted instances">
-  Our hosted ENSNode instances currently run ENSNode v1.13. If you are querying them from your own app, you <strong>must</strong> use <span set:html={sdkList} />. The latest published versions (<code>1.14.0+</code>) contain breaking changes in the Omnigraph API data model not yet deployed to our hosted infrastructure. Use these exact install commands:
+  Our hosted ENSNode instances run ENSNode <code>{sdkVersion}</code>. The Omnigraph GraphQL schema is bundled inside the SDK and consumed by the <code>gql.tada</code> TypeScript plugin to type your queries, so pin an <strong>exact</strong> version (no <code>^</code> or <code>~</code>) of <span set:html={sdkList} /> to keep your generated types matched to the deployed schema. Use these exact install commands:
 
   {isBoth ? (
-    <pre>npm install enssdk@1.13.1
+    <pre>{`npm install enssdk@${sdkVersion}
 # or, for React apps:
-npm install enskit@1.13.1 enssdk@1.13.1</pre>
+npm install enskit@${sdkVersion} enssdk@${sdkVersion}`}</pre>
   ) : isEnskit ? (
-    <pre>npm install enskit@1.13.1 enssdk@1.13.1</pre>
+    <pre>{`npm install enskit@${sdkVersion} enssdk@${sdkVersion}`}</pre>
   ) : (
-    <pre>npm install enssdk@1.13.1</pre>
+    <pre>{`npm install enssdk@${sdkVersion}`}</pre>
   )}
-
-  This notice will be removed once the hosted instances are upgraded.
 </Aside>

docs/ensnode.io/src/components/organisms/OmnigraphSchemaDocExplorer.tsx

@@ -3,8 +3,24 @@ import "@graphiql/plugin-doc-explorer/style.css";
 
 import { DocExplorer, DocExplorerStore } from "@graphiql/plugin-doc-explorer";
 import { GraphiQLProvider } from "@graphiql/react";
-import omnigraphSchemaSdl from "enssdk/omnigraph/schema.graphql?raw";
 import { buildSchema } from "graphql";
+import { ACTIVE_OMNIGRAPH_VERSION } from "@data/omnigraph-examples/active";
+
+// Render the schema for the production-locked Omnigraph version (the same version the examples and
+// walkthroughs target), NOT the live `main` SDL — `main` runs ahead of production. Schemas are frozen
+// per-version under `src/data/omnigraph-examples/versions/<version>/schema.graphql`; glob all (Vite
+// can't import a runtime-variable path) and select the active one.
+const schemasByVersion = import.meta.glob<string>(
+  "../../data/omnigraph-examples/versions/*/schema.graphql",
+  { query: "?raw", import: "default", eager: true },
+);
+const omnigraphSchemaSdl =
+  schemasByVersion[
+    `../../data/omnigraph-examples/versions/${ACTIVE_OMNIGRAPH_VERSION}/schema.graphql`
+  ];
+if (!omnigraphSchemaSdl) {
+  throw new Error(`No Omnigraph schema snapshot for version "${ACTIVE_OMNIGRAPH_VERSION}".`);
+}
 
 const omnigraphSchema = buildSchema(omnigraphSchemaSdl);