Skip to content

Commit 2532244

Browse files
authored
docs(release): add mcp-publisher validate pre-tag check + backfill phase issue links (#35)
Housekeeping after v0.1.5 -> v0.1.6 release arc. Adds mcp-publisher validate to the pre-tag checklist and backfills phase 9/10/11 issue numbers in ROADMAP.md.
2 parents f948f09 + c26d1fd commit 2532244

2 files changed

Lines changed: 9 additions & 3 deletions

File tree

.github/RELEASE.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,12 @@ Complete these steps in order. Each step has a checkbox -- do not skip ahead.
8585
```bash
8686
grep '^version' pyproject.toml
8787
```
88+
- [ ] `server.json` validates against the live MCP Registry schema. MCP Registry enforces stricter limits than PyPI (e.g. `description ≤ 100 chars`); validating before the tag prevents a half-published release (PyPI succeeds while MCP Registry rejects, as happened on v0.1.5 → recovered in v0.1.6):
89+
```bash
90+
curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher
91+
./mcp-publisher validate server.json
92+
```
93+
Must report `✅ server.json is valid`. If validation fails, shorten the `server.json` `description` on `main` before tagging (the `pyproject.toml` description is unbounded by this constraint and can stay longer).
8894
- [ ] Integration tests from `.github/INTEGRATION-TEST.md` are complete and signed off
8995
- [ ] Doctor subcommand passes:
9096
```bash

.planning/ROADMAP.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,9 @@
99

1010
| Phase | Title | Tool surface | Issue |
1111
|-------|-------|--------------|-------|
12-
| 09 | `compare_versions(symbol, v1, v2)` | New MCP tool | #TBD-link-after-PR-merges |
13-
| 10 | `whatsnew_for_version(version)` | New MCP tool | #TBD-link-after-PR-merges |
14-
| 11 | `detect_python_version` v2 (venv-aware) | Existing tool enhancement | #TBD-link-after-PR-merges |
12+
| 09 | `compare_versions(symbol, v1, v2)` | New MCP tool | [#32](https://github.com/ayhammouda/python-docs-mcp-server/issues/32) |
13+
| 10 | `whatsnew_for_version(version)` | New MCP tool | [#33](https://github.com/ayhammouda/python-docs-mcp-server/issues/33) |
14+
| 11 | `detect_python_version` v2 (venv-aware) | Existing tool enhancement | [#34](https://github.com/ayhammouda/python-docs-mcp-server/issues/34) |
1515

1616
These are planned, not committed. Phase CONTEXTs at [`phases/09-compare-versions/`](phases/09-compare-versions/09-CONTEXT.md), [`phases/10-whatsnew/`](phases/10-whatsnew/10-CONTEXT.md), [`phases/11-detect-venv/`](phases/11-detect-venv/11-CONTEXT.md). Implementation kickoff requires `/gsd-plan-phase 0X`.
1717

0 commit comments

Comments
 (0)