@mcpdesc/validator 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +10 -2
- package/MODIFICATIONS.md +9 -0
- package/ORIGIN.md +28 -6
- package/README.md +14 -3
- package/package.json +5 -3
package/CHANGELOG.md
CHANGED
|
@@ -6,7 +6,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
|
|
6
6
|
and this package follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
Dates for published releases are the UTC publication dates recorded by npm.
|
|
8
8
|
|
|
9
|
-
## [
|
|
9
|
+
## [0.7.0] - 2026-09-02
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
|
|
13
|
+
- Moved package maintenance and publication from the MCP Description
|
|
14
|
+
specification repository to the MCP Description tooling repository without
|
|
15
|
+
changing public APIs, immutable snapshots, diagnostics, or validation
|
|
16
|
+
behavior.
|
|
10
17
|
|
|
11
18
|
## [0.6.0] - 2026-09-02
|
|
12
19
|
|
|
@@ -62,7 +69,8 @@ Dates for published releases are the UTC publication dates recorded by npm.
|
|
|
62
69
|
- Added synchronous structural and semantic validation for parsed JavaScript values with deterministic diagnostics and exact selector dispatch.
|
|
63
70
|
- Added ESM browser support, TypeScript declarations, embedded schema provenance, frozen fixtures, and package-content checks.
|
|
64
71
|
|
|
65
|
-
[Unreleased]: https://github.com/mcpdesc/
|
|
72
|
+
[Unreleased]: https://github.com/mcpdesc/core/compare/validator-v0.7.0...HEAD
|
|
73
|
+
[0.7.0]: https://github.com/mcpdesc/core/releases/tag/validator-v0.7.0
|
|
66
74
|
[0.6.0]: https://github.com/mcpdesc/mcpdesc-specification/compare/validator-v0.5.0...validator-v0.6.0
|
|
67
75
|
[0.5.0]: https://github.com/mcpdesc/mcpdesc-specification/compare/17cc533e79b19ea2dbc1edcf06e30ba68a7d9b79...validator-v0.5.0
|
|
68
76
|
[0.4.0]: https://www.npmjs.com/package/@mcpdesc/validator/v/0.4.0
|
package/MODIFICATIONS.md
CHANGED
|
@@ -4,6 +4,15 @@ This file records material imported from `cisco-open/mcptoolkit-contract` and su
|
|
|
4
4
|
|
|
5
5
|
The exact source repository and commit are recorded in [`ORIGIN.md`](ORIGIN.md).
|
|
6
6
|
|
|
7
|
+
## Validator repository migration — 2026-09-02
|
|
8
|
+
|
|
9
|
+
The complete `@mcpdesc/validator@0.6.0` package source and package-local tests
|
|
10
|
+
were moved from `mcpdesc/mcpdesc-specification` commit
|
|
11
|
+
`6eb1b54330f8b7dc11468c7e31614214c7521cd0` into `mcpdesc/core`. Package metadata,
|
|
12
|
+
release documentation, and repository guidance were updated for the new
|
|
13
|
+
maintenance location. Existing immutable snapshot implementations, embedded
|
|
14
|
+
schemas, frozen fixtures, diagnostics, and runtime behavior were not changed.
|
|
15
|
+
|
|
7
16
|
## Repository bootstrap — 2026-07-28
|
|
8
17
|
|
|
9
18
|
| File or path | Change | Reason |
|
package/ORIGIN.md
CHANGED
|
@@ -1,11 +1,30 @@
|
|
|
1
1
|
# Origin and provenance
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
## Validator repository migration
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
5
|
+
`@mcpdesc/validator` versions through `0.6.0` were maintained in the MCP
|
|
6
|
+
Description specification repository. Version `0.7.0` moves the package to the
|
|
7
|
+
MCP Description tooling repository without changing its public API or the
|
|
8
|
+
behavior and bytes of its published immutable snapshot implementations.
|
|
9
|
+
|
|
10
|
+
| Field | Value |
|
|
11
|
+
|---|---|
|
|
12
|
+
| Source repository | `https://github.com/mcpdesc/mcpdesc-specification` |
|
|
13
|
+
| Source commit | `6eb1b54330f8b7dc11468c7e31614214c7521cd0` |
|
|
14
|
+
| Source package | `packages/validator` (`@mcpdesc/validator@0.6.0`) |
|
|
15
|
+
| Destination repository | `https://github.com/mcpdesc/core` |
|
|
16
|
+
| Destination package | `packages/validator` |
|
|
17
|
+
| Migration date | `2026-09-02` |
|
|
18
|
+
|
|
19
|
+
The specification repository continues to own normative text, canonical
|
|
20
|
+
schemas, and mutable draft fixtures. This package owns executable validation,
|
|
21
|
+
immutable runtime snapshots, frozen package-test fixtures, and its public API.
|
|
22
|
+
|
|
23
|
+
MCP Description v0.7.0 originated in the Cisco Open `mcptoolkit-contract`
|
|
24
|
+
repository and remains the current stable release as of 2026-07-28. The
|
|
25
|
+
specification repository imported that material as the basis for v0.8.0
|
|
26
|
+
community work and created the validator package from it. Neither repository
|
|
27
|
+
migration is a copyright assignment or donation.
|
|
9
28
|
|
|
10
29
|
## Source import
|
|
11
30
|
|
|
@@ -17,4 +36,7 @@ existing contributions.
|
|
|
17
36
|
| Method | History-preserving filtered import (`git-filter-repo`); commit hashes rewritten by path filtering |
|
|
18
37
|
| Imported paths | `spec/**`, `schemas/mcp-description/**`, `schemas/latest.json`, `LICENSE`, `NOTICE` |
|
|
19
38
|
|
|
20
|
-
The imported v0.7.0 JSON Schemas are preserved byte-for-byte
|
|
39
|
+
The imported v0.7.0 JSON Schemas are preserved byte-for-byte in their immutable
|
|
40
|
+
validator snapshots. The v0.7.0 specification text is not stored here; its
|
|
41
|
+
canonical source remains the upstream repository above. Changes to imported
|
|
42
|
+
material are recorded in [`MODIFICATIONS.md`](MODIFICATIONS.md) and Git history.
|
package/README.md
CHANGED
|
@@ -2,7 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
Isomorphic structural and semantic validation for immutable MCP Description specification snapshots.
|
|
4
4
|
|
|
5
|
-
Version `0.
|
|
5
|
+
Version `0.7.0` cumulatively supports these immutable snapshots. This release
|
|
6
|
+
moves package maintenance from the MCP Description specification repository to
|
|
7
|
+
the MCP Description tooling repository without changing conformance behavior.
|
|
6
8
|
|
|
7
9
|
| Selector | Tag | Embedded schema SHA-256 |
|
|
8
10
|
|---|---|---|
|
|
@@ -113,7 +115,8 @@ The runtime bundles its schema, performs no network fetches for external schema
|
|
|
113
115
|
|
|
114
116
|
## Snapshot lifecycle
|
|
115
117
|
|
|
116
|
-
For each approved specification snapshot, maintainers
|
|
118
|
+
For each approved specification snapshot, maintainers import artifacts from an
|
|
119
|
+
exact specification repository tag or commit and then:
|
|
117
120
|
|
|
118
121
|
1. Add a versioned implementation under `src/snapshots/<selector>/` with its exact selector, snapshot tag, embedded schema, schema SHA-256 digest, and semantic rules. Existing snapshot directories remain unchanged.
|
|
119
122
|
2. Freeze the matching fixture corpus under `test/snapshots/<selector>/fixtures/`. Package tests must not read mutable `spec/draft/fixtures/` for an already published selector.
|
|
@@ -122,7 +125,15 @@ For each approved specification snapshot, maintainers:
|
|
|
122
125
|
|
|
123
126
|
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.
|
|
124
127
|
|
|
125
|
-
|
|
128
|
+
Specification approval and imported supporting code do not authorize package
|
|
129
|
+
publication. During release review, a maintainer explicitly decides the
|
|
130
|
+
validator package version and npm dist-tag, reviews the exact imported source
|
|
131
|
+
and frozen fixture provenance, runs the full checks, and inspects the tarball.
|
|
132
|
+
The trusted-publishing workflow requires an annotated
|
|
133
|
+
`validator-v<semver>` tag whose version matches this package and whose commit is
|
|
134
|
+
the current `origin/main` tip. It publishes SemVer prereleases with npm `next`
|
|
135
|
+
and stable versions with `latest`. Scripts and other CI workflows do not choose
|
|
136
|
+
versions, create tags, or publish packages.
|
|
126
137
|
|
|
127
138
|
## Development checks
|
|
128
139
|
|
package/package.json
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mcpdesc/validator",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.7.0",
|
|
4
4
|
"description": "Structural and semantic validation for MCP Description snapshots",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"types": "./index.d.ts",
|
|
7
7
|
"license": "Apache-2.0",
|
|
8
8
|
"repository": {
|
|
9
9
|
"type": "git",
|
|
10
|
-
"url": "git+https://github.com/mcpdesc/
|
|
10
|
+
"url": "git+https://github.com/mcpdesc/core.git",
|
|
11
11
|
"directory": "packages/validator"
|
|
12
12
|
},
|
|
13
13
|
"engines": {
|
|
@@ -41,7 +41,9 @@
|
|
|
41
41
|
],
|
|
42
42
|
"scripts": {
|
|
43
43
|
"build:standalone": "node scripts/build-standalone.mjs",
|
|
44
|
-
"
|
|
44
|
+
"check:snapshots": "node scripts/check-snapshot-integrity.mjs",
|
|
45
|
+
"import:snapshot": "node scripts/import-snapshot.mjs",
|
|
46
|
+
"test": "npm run check:snapshots && npm run build:standalone && node --test test/*.test.js && npm run test:types && npm run test:browser && npm run test:package",
|
|
45
47
|
"test:browser": "node scripts/check-browser-bundle.mjs",
|
|
46
48
|
"test:package": "node scripts/check-package.mjs",
|
|
47
49
|
"test:types": "tsc --project test/types/tsconfig.json && node scripts/check-declarations.mjs"
|