@mcpdesc/validator 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -6,6 +6,34 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 Dates for published releases are the UTC publication dates recorded by npm.
 
+## [Unreleased]
+
+## [0.11.0] - 2026-09-08
+
+### Added
+
+- Added the immutable `0.8.0-rc.4` selector, including protocol-independent
+	root info metadata behavior and its frozen conformance fixture corpus.
+
+### Changed
+
+- Narrowed active runtime support to RC.3 and RC.4, deprecated RC.3, and removed
+	RC.2 from current registries, declarations, generated bundles, and package
+	contents while retaining its immutable source and fixtures in Git.
+- Kept component reference resolution on RC.3 because RC.4's snapshot resolver
+	does not expose the terminal-target provenance required by the public result
+	contract.
+
+## [0.10.1] - 2026-09-07
+
+### Changed
+
+- Narrowed active runtime support to RC.2 and RC.3 and marked RC.2 deprecated.
+- Excluded retired runtime snapshots from generated bundles and package
+	contents while retaining their source and frozen fixtures in Git.
+- Removed the retained snapshot-intake manifest; intake bundles are disposable
+	inputs and imported bytes remain protected by the snapshot integrity manifest.
+
 ## [0.10.0] - 2026-09-07
 
 ### Added
@@ -127,7 +155,10 @@ Dates for published releases are the UTC publication dates recorded by npm.
 - Added synchronous structural and semantic validation for parsed JavaScript values with deterministic diagnostics and exact selector dispatch.
 - Added ESM browser support, TypeScript declarations, embedded schema provenance, frozen fixtures, and package-content checks.
 
-[Unreleased]: https://github.com/mcpdesc/core/compare/validator-v0.9.0...HEAD
+[Unreleased]: https://github.com/mcpdesc/core/compare/validator-v0.11.0...HEAD
+[0.11.0]: https://github.com/mcpdesc/core/compare/validator-v0.10.1...validator-v0.11.0
+[0.10.1]: https://github.com/mcpdesc/core/compare/validator-v0.10.0...validator-v0.10.1
+[0.10.0]: https://github.com/mcpdesc/core/compare/validator-v0.9.0...validator-v0.10.0
 [0.9.0]: https://github.com/mcpdesc/core/compare/validator-v0.8.0...validator-v0.9.0
 [0.8.0]: https://github.com/mcpdesc/core/compare/validator-v0.7.1...validator-v0.8.0
 [0.7.1]: https://github.com/mcpdesc/core/compare/validator-v0.7.0...validator-v0.7.1

package/README.md

@@ -25,7 +25,7 @@ npm install @mcpdesc/validator
 import { validateMcpDescription } from '@mcpdesc/validator';
 
 const result = validateMcpDescription(parsedDocument, {
-  specification: '0.8.0-rc.2',
+  specification: '0.8.0-rc.4',
 });
 
 for (const diagnostic of result.diagnostics) {
@@ -44,22 +44,23 @@ a later draft is published.
 
 ## Supported snapshots
 
-The current workspace supports these immutable selectors, newest first:
+The package supports these immutable selectors, newest first:
 
 | Selector | First validator release | Embedded schema SHA-256 |
 |---|---|---|
-| `0.8.0-rc.3` | `0.10.0` | `a9c3ff77ba37c72362909f538f6e957d055e6fdb372f8b3d529e3651af3fecf4` |
-| `0.8.0-rc.2` | `0.9.0` | `40f6775dde052224114e91d6aa484d826eecf56b77f7ac87b4cf707ffbcb6ce8` |
-| `0.8.0-rc.1` | `0.5.0` | `936a0f24ade501fcabf3d6498c0440c445daa672a575573a35954cee49430ac4` |
-| `0.8.0-draft.4` | `0.4.0` | `93ed03f74059b5b3ce7509a96b59161bdab2c3cf7734397a9bec5a7588d0b03b` |
-| `0.8.0-draft.3` | `0.3.0` | `8823c1f1946360b2a44d00920e2092e5e4acd139a1964befad4eb0bf3ce96002` |
-| `0.8.0-draft.2` | `0.2.0` | `ab692c1a5a0f7e5f29be1940aa8c64a56d4620be0a19d00cf0a64680b7e517fa` |
-| `0.8.0-draft.1` | `0.1.0` | `4ceb6042c3fd31703199cd3db869ec5c35c17d2fe9ab7b2f5b96a2a3af0cebe4` |
+| `0.8.0-rc.4` | `0.11.0` | `d38e54db859813b63be2a5c91dde91250035f18bcb5910208cf71fa6875d6eef` |
+| `0.8.0-rc.3` (deprecated) | `0.10.0` | `a9c3ff77ba37c72362909f538f6e957d055e6fdb372f8b3d529e3651af3fecf4` |
 
 The validator package embeds the schema and executable behavior for each
-selector. npm integrity and trusted-publishing provenance identify released
+selector. RC.3 remains available for migration compatibility; new integrations
+should select RC.4. Earlier selectors remain available by pinning an older
+immutable validator release. npm integrity and trusted-publishing provenance identify released
 package bytes; specification repository tags and commits are informational.
 
+Component reference resolution remains available for RC.3. RC.4 validation is
+supported, but its snapshot resolver does not expose the terminal-target
+provenance required by the package's public resolution result contract.
+
 ## Usage
 
 The `options` argument and exact `specification` selector are required. The unqualified selector `0.8.0` is intentionally unsupported because draft and release-candidate iterations are immutable compatibility contracts.
@@ -100,17 +101,10 @@ if (resolution.status === 'resolved') {
 
 Resolution is pure and performs no network retrieval. It does not validate the
 document and never infers a draft snapshot from `mcpdesc: "0.8.0"` alone.
-Draft 4's format-qualified schema URI resolves uniquely. Drafts 1 through 3
-share the legacy `https://mcpdesc.org/schema/0.8.0.json` URI, so that URI is
-ambiguous unless the caller supplies a consistent exact selector:
-
-```js
-const resolution = resolveMcpDescriptionSpecification(parsedDocument, {
-  specification: '0.8.0-draft.3'
-});
-```
+Retired schema identities are reported as unknown by current releases. Pin an
+older package release to resolve or validate a retired selector.
 
-Unresolved results distinguish missing, invalid, unknown, ambiguous, and
+Unresolved results distinguish missing, invalid, unknown, and
 contradictory identity, as well as unsupported caller selectors. A supplied
 selector can resolve a document with no `$schema`; when `$schema` is present it
 must match the selected snapshot's recorded schema URI.
@@ -137,20 +131,19 @@ Structural paths start with AJV's instance path. A `required` error appends its
 
 ## Support metadata
 
-The package exports frozen `supportedSpecifications`, `supportedProtocolVersions`, and `specificationProvenance` values. Provenance records include the snapshot tag, recorded schema URI, and embedded schema SHA-256 digest. Public validation dispatches through a registry keyed by exact specification selectors. The current repository selector set is `0.8.0-draft.1`, `0.8.0-draft.2`, `0.8.0-draft.3`, `0.8.0-draft.4`, `0.8.0-rc.1`, `0.8.0-rc.2`, and `0.8.0-rc.3`; the protocol-version export is the deduplicated union supported by those snapshots.
+The package exports frozen `supportedSpecifications`, `deprecatedSpecifications`, `supportedProtocolVersions`, and `specificationProvenance` values. Provenance records include the snapshot tag, recorded schema URI, and embedded schema SHA-256 digest. Public validation dispatches through a registry keyed by exact specification selectors. The active selector set is `0.8.0-rc.3` and `0.8.0-rc.4`; `deprecatedSpecifications` contains RC.3. The protocol-version export is the deduplicated union supported by active snapshots.
 
-RC.2 and RC.3 also export the frozen `mcpExtensionCatalogue` and
-`mcpExtensionMaturity` classifier. The catalogue pins its authoritative source,
-effective date, and official or experimental identifier assignments. Catalogue
-recognition establishes authority and maturity only; it does not validate
-extension-specific settings.
+The package also exports the frozen `mcpExtensionCatalogue` and
+`mcpExtensionMaturity` classifier pinned by the RC.3 snapshot. The catalogue
+records its authoritative source, effective date, and official or experimental
+identifier assignments. Catalogue recognition establishes authority and
+maturity only; it does not validate extension-specific settings.
 
 npm package SemVer tracks implementation releases independently from specification snapshot identity. Adding a later snapshot is additive: it must use a sibling implementation and selector rather than changing an existing snapshot's schema, semantics, metadata, fixtures, or results.
 
-The RC.1, RC.2, and RC.3 component resolvers report authored and terminal target
-paths for successful substitutions. The additive tooling corrections do not
-change snapshot schemas, validation results, diagnostics, or fixtures and are
-recorded in the integrity manifest.
+The RC.3 component resolver reports authored and terminal target paths for
+successful substitutions. RC.4 component resolution is unavailable because its
+snapshot resolver does not expose that provenance result.
 
 The runtime bundles its schema, performs no network fetches for external schema references, and imports no Node.js built-ins. Unresolved external Tool-schema references produce incomplete-validation warnings and are preserved. All three ESM entry points support Node.js 20 or later and browser bundlers.
 
@@ -164,7 +157,7 @@ exact specification repository tag or commit and then:
 3. Add the exact selector to the runtime registry and update support metadata, TypeScript declarations, tests, the package changelog, and expected package contents. Unqualified versions, aliases, ranges, and not-yet-published selectors remain unsupported.
 4. Run the package and repository validation suites. The schema digest, immutable metadata, fixture behavior, browser bundle, declarations, and tarball contents must all pass.
 
-The test snapshots are repository-only development assets and are excluded from the npm tarball. Runtime snapshot implementations and embedded schemas do ship so installed packages remain self-contained.
+The test snapshots are repository-only development assets and are excluded from the npm tarball. Historical runtime sources remain in Git for integrity history. Only active runtime snapshot implementations and embedded schemas ship, so installed packages remain self-contained without accumulating retired selectors.
 
 Specification approval and imported supporting code do not authorize package
 publication. During release review, a maintainer explicitly decides the
@@ -187,4 +180,4 @@ npm run test:browser --workspace @mcpdesc/validator
 npm run test:package --workspace @mcpdesc/validator
 ```
 
-The package test runs each immutable snapshot against its own frozen valid, invalid, and warning fixture corpus. YAML source fixtures are decoded by the test harness before validation; the public API continues to accept parsed JavaScript values only. The other checks compile the declarations, bundle the public browser entry with esbuild and Vite, reject runtime AJV compiler inputs and dynamic code generation in those bundles, and inspect `npm pack --dry-run --json` against the intended tarball contents and declared export targets.
+The package test runs each active snapshot against its own frozen valid, invalid, and warning fixture corpus and verifies historical artifact integrity separately. YAML source fixtures are decoded by the test harness before validation; the public API continues to accept parsed JavaScript values only. The other checks compile the declarations, bundle the public browser entry with esbuild and Vite, reject runtime AJV compiler inputs and dynamic code generation in those bundles, and inspect `npm pack --dry-run --json` against the intended tarball contents and declared export targets.

package/index.d.ts

@@ -1,4 +1,4 @@
-export type McpDescriptionSpecification = '0.8.0-draft.1' | '0.8.0-draft.2' | '0.8.0-draft.3' | '0.8.0-draft.4' | '0.8.0-rc.1' | '0.8.0-rc.2' | '0.8.0-rc.3';
+export type McpDescriptionSpecification = '0.8.0-rc.3' | '0.8.0-rc.4';
 
 export type SupportedProtocolVersion =
   | '2024-11-05'
@@ -38,7 +38,7 @@ export interface McpDescriptionComponentResolutionResult {
 }
 
 export interface ResolveMcpDescriptionComponentReferencesOptions {
-  readonly specification: '0.8.0-rc.1' | '0.8.0-rc.2' | '0.8.0-rc.3';
+  readonly specification: '0.8.0-rc.3';
 }
 
 export type McpExtensionMaturity = 'official' | 'experimental' | 'uncatalogued';
@@ -56,41 +56,16 @@ export interface McpExtensionCatalogue {
 }
 
 export interface SpecificationProvenance {
-  readonly '0.8.0-draft.1': {
-    readonly snapshotTag: 'v0.8.0-draft.1';
-    readonly schemaUri: 'https://mcpdesc.org/schema/0.8.0.json';
-    readonly schemaSha256: '4ceb6042c3fd31703199cd3db869ec5c35c17d2fe9ab7b2f5b96a2a3af0cebe4';
-  };
-  readonly '0.8.0-draft.2': {
-    readonly snapshotTag: 'v0.8.0-draft.2';
-    readonly schemaUri: 'https://mcpdesc.org/schema/0.8.0.json';
-    readonly schemaSha256: 'ab692c1a5a0f7e5f29be1940aa8c64a56d4620be0a19d00cf0a64680b7e517fa';
-  };
-  readonly '0.8.0-draft.3': {
-    readonly snapshotTag: 'v0.8.0-draft.3';
-    readonly schemaUri: 'https://mcpdesc.org/schema/0.8.0.json';
-    readonly schemaSha256: '8823c1f1946360b2a44d00920e2092e5e4acd139a1964befad4eb0bf3ce96002';
-  };
-  readonly '0.8.0-draft.4': {
-    readonly snapshotTag: 'v0.8.0-draft.4';
-    readonly schemaUri: 'https://mcpdesc.org/schema/mcp-description/0.8.0-draft.4.json';
-    readonly schemaSha256: '93ed03f74059b5b3ce7509a96b59161bdab2c3cf7734397a9bec5a7588d0b03b';
-  };
-  readonly '0.8.0-rc.1': {
-    readonly snapshotTag: 'v0.8.0-rc.1';
-    readonly schemaUri: 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.1.json';
-    readonly schemaSha256: '936a0f24ade501fcabf3d6498c0440c445daa672a575573a35954cee49430ac4';
-  };
-  readonly '0.8.0-rc.2': {
-    readonly snapshotTag: 'v0.8.0-rc.2';
-    readonly schemaUri: 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.2.json';
-    readonly schemaSha256: '40f6775dde052224114e91d6aa484d826eecf56b77f7ac87b4cf707ffbcb6ce8';
-  };
   readonly '0.8.0-rc.3': {
     readonly snapshotTag: 'v0.8.0-rc.3';
     readonly schemaUri: 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.3.json';
     readonly schemaSha256: 'a9c3ff77ba37c72362909f538f6e957d055e6fdb372f8b3d529e3651af3fecf4';
   };
+  readonly '0.8.0-rc.4': {
+    readonly snapshotTag: 'v0.8.0-rc.4';
+    readonly schemaUri: 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.4.json';
+    readonly schemaSha256: 'd38e54db859813b63be2a5c91dde91250035f18bcb5910208cf71fa6875d6eef';
+  };
 }
 
 export interface ResolveMcpDescriptionSpecificationOptions {
@@ -114,7 +89,8 @@ export type McpDescriptionSpecificationResolution =
   | ResolvedMcpDescriptionSpecification
   | UnresolvedMcpDescriptionSpecification;
 
-export declare const supportedSpecifications: readonly ['0.8.0-draft.1', '0.8.0-draft.2', '0.8.0-draft.3', '0.8.0-draft.4', '0.8.0-rc.1', '0.8.0-rc.2', '0.8.0-rc.3'];
+export declare const supportedSpecifications: readonly ['0.8.0-rc.3', '0.8.0-rc.4'];
+export declare const deprecatedSpecifications: readonly ['0.8.0-rc.3'];
 
 export declare const supportedProtocolVersions: readonly [
   '2024-11-05',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpdesc/validator",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Structural and semantic validation for MCP Description snapshots",
   "type": "module",
   "types": "./index.d.ts",
@@ -31,7 +31,8 @@
   },
   "files": [
     "src/index.js",
-    "src/snapshots",
+    "src/snapshots/0.8.0-rc.3",
+    "src/snapshots/0.8.0-rc.4",
     "standalone.js",
     "index.d.ts",
     "CHANGELOG.md",

package/src/index.js

@@ -1,47 +1,29 @@
-import * as draft1 from './snapshots/0.8.0-draft.1/index.js';
-import * as draft2 from './snapshots/0.8.0-draft.2/index.js';
-import * as draft3 from './snapshots/0.8.0-draft.3/index.js';
-import * as draft4 from './snapshots/0.8.0-draft.4/index.js';
-import * as rc1 from './snapshots/0.8.0-rc.1/index.js';
-import * as rc2 from './snapshots/0.8.0-rc.2/index.js';
 import * as rc3 from './snapshots/0.8.0-rc.3/index.js';
-import { resolveComponentReferences as resolveRc1ComponentReferences } from './snapshots/0.8.0-rc.1/semantic.js';
-import { resolveComponentReferences as resolveRc2ComponentReferences } from './snapshots/0.8.0-rc.2/semantic.js';
+import * as rc4 from './snapshots/0.8.0-rc.4/index.js';
 import { resolveComponentReferences as resolveRc3ComponentReferences } from './snapshots/0.8.0-rc.3/semantic.js';
 import {
   mcpExtensionCatalogue,
   mcpExtensionMaturity
-} from './snapshots/0.8.0-rc.2/semantic.js';
+} from './snapshots/0.8.0-rc.3/semantic.js';
 
 export { mcpExtensionCatalogue, mcpExtensionMaturity };
 
 const snapshots = Object.freeze({
-  [draft1.specification]: draft1,
-  [draft2.specification]: draft2,
-  [draft3.specification]: draft3,
-  [draft4.specification]: draft4,
-  [rc1.specification]: rc1,
-  [rc2.specification]: rc2,
-  [rc3.specification]: rc3
+  [rc3.specification]: rc3,
+  [rc4.specification]: rc4
 });
 
 const componentResolvers = Object.freeze({
-  '0.8.0-rc.1': resolveRc1ComponentReferences,
-  '0.8.0-rc.2': resolveRc2ComponentReferences,
   '0.8.0-rc.3': resolveRc3ComponentReferences
 });
 
 const schemaUris = Object.freeze({
-  '0.8.0-draft.1': 'https://mcpdesc.org/schema/0.8.0.json',
-  '0.8.0-draft.2': 'https://mcpdesc.org/schema/0.8.0.json',
-  '0.8.0-draft.3': 'https://mcpdesc.org/schema/0.8.0.json',
-  '0.8.0-draft.4': 'https://mcpdesc.org/schema/mcp-description/0.8.0-draft.4.json',
-  '0.8.0-rc.1': 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.1.json',
-  '0.8.0-rc.2': 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.2.json',
-  '0.8.0-rc.3': 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.3.json'
+  '0.8.0-rc.3': 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.3.json',
+  '0.8.0-rc.4': 'https://mcpdesc.org/schema/mcp-description/0.8.0-rc.4.json'
 });
 
 export const supportedSpecifications = Object.freeze(Object.keys(snapshots));
+export const deprecatedSpecifications = Object.freeze(['0.8.0-rc.3']);
 export const supportedProtocolVersions = Object.freeze([
   ...new Set(Object.values(snapshots).flatMap((snapshot) => snapshot.supportedProtocolVersions))
 ]);

package/src/snapshots/{0.8.0-rc.2 → 0.8.0-rc.4}/base.js

@@ -691,11 +691,6 @@ function validateVersionSpecificSemantics(document, rel, diagnostics) {
     }
   }
 
-  checkMinimumVersion('info', ['info'], document.info ?? {}, 'title', '2025-06-18', rootScope);
-  checkMinimumVersion('info', ['info'], document.info ?? {}, 'description', '2025-11-25', rootScope);
-  checkMinimumVersion('info', ['info'], document.info ?? {}, 'icons', '2025-11-25', rootScope);
-  checkMinimumVersion('info', ['info'], document.info ?? {}, 'websiteUrl', '2025-11-25', rootScope);
-
   (document.transports ?? []).forEach((transport, index) => {
     const scope = effectiveScope(document, transport, rootScope);
     if (transport.type === 'streamable-http') {

package/src/snapshots/{0.8.0-rc.1 → 0.8.0-rc.4}/index.js

@@ -3,9 +3,9 @@ import {
   validateMcpdesc08Document
 } from './semantic.js';
 
-export const specification = '0.8.0-rc.1';
-export const snapshotTag = 'v0.8.0-rc.1';
-export const schemaSha256 = '936a0f24ade501fcabf3d6498c0440c445daa672a575573a35954cee49430ac4';
+export const specification = '0.8.0-rc.4';
+export const snapshotTag = 'v0.8.0-rc.4';
+export const schemaSha256 = 'd38e54db859813b63be2a5c91dde91250035f18bcb5910208cf71fa6875d6eef';
 export { supportedProtocolVersions };
 
 export function validate(document) {

package/src/snapshots/{0.8.0-rc.2 → 0.8.0-rc.4}/schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://mcpdesc.org/schema/mcp-description/0.8.0-rc.2.json",
-  "title": "MCP Description",
-  "description": "MCP Description 0.8.0 Release Candidate 2 (v0.8.0-rc.2; prerelease).",
+  "$id": "https://mcpdesc.org/schema/mcp-description/0.8.0-rc.4.json",
+  "title": "MCP Server Description (mcpdesc format)",
+  "description": "A static, curated description of what an MCP server offers. Uses MCP-native terminology, an OpenAPI-aligned info and security structure, and support for multiple transports, protocol revisions, and specification extensions. Supports MCP protocol revisions 2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, and 2026-07-28.",
   "type": "object",
   "required": [
     "mcpdesc",

package/src/snapshots/{0.8.0-draft.4 → 0.8.0-rc.4}/semantic.js

@@ -1,4 +1,4 @@
-// Validate the immutable 0.8.0-draft.4 snapshot using only snapshot-local artifacts.
+// Validate the immutable 0.8.0-rc.4 snapshot using only snapshot-local artifacts.
 
 import Ajv from 'ajv';
 import Ajv2020 from 'ajv/dist/2020.js';
@@ -6,11 +6,13 @@ import addFormats from 'ajv-formats';
 import { UriTemplateMatcher } from 'uri-template-matcher';
 import schema from './schema.json' with { type: 'json' };
 import {
+  mcpExtensionCatalogue,
+  mcpExtensionMaturity,
   semanticValidateDocument as validateBaseSemantics,
   supportedProtocolVersions
 } from './base.js';
 
-export { supportedProtocolVersions };
+export { mcpExtensionCatalogue, mcpExtensionMaturity, supportedProtocolVersions };
 
 const TOOL_INTERACTION_SENTINEL = '__interaction_example__';
 const ajv = new Ajv2020({ allErrors: true, strict: false });
@@ -21,7 +23,6 @@ const validateStructure = ajv.compile(schema);
 const primitiveCollections = ['tools', 'resources', 'resourceTemplates', 'prompts'];
 const componentNamespaces = ['schemas', 'toolExamples', 'resourceExamples', 'resourceTemplateExamples', 'promptExamples'];
 const knownClientCapabilities = new Set(['roots', 'sampling', 'elicitation', 'tasks', 'extensions', 'experimental']);
-const knownReservedCapabilityExtensions = new Set(['io.modelcontextprotocol/tasks']);
 const protocolOrder = new Map(supportedProtocolVersions.map((version, index) => [version, index]));
 
 const clientCapabilitiesByVersion = {
@@ -569,7 +570,17 @@ function validateClientRequirements(document) {
             validateTasks(value, location, path, version);
           } else if (capability === 'extensions') {
             for (const extension of Object.keys(value)) {
-              if (usesMcpReservedPrefix(extension) && !knownReservedCapabilityExtensions.has(extension)) {
+              if (!usesMcpReservedPrefix(extension)) continue;
+              const maturity = mcpExtensionMaturity(extension);
+              if (maturity === 'official') continue;
+              if (maturity === 'experimental') {
+                diagnostics.push(semanticDiagnostic(
+                  'experimental-reserved-extension-identifier',
+                  'warning',
+                  `${location} contains experimental MCP extension ${JSON.stringify(extension)}; preserve it and review its maturity before relying on it`,
+                  [...path, extension]
+                ));
+              } else {
                 diagnostics.push(semanticDiagnostic(
                   'unknown-reserved-extension-identifier',
                   'warning',