Prepare 1.0.0 release

NavinAgrawal · NavinAgrawal · commit 4aa5673bb827 · 2026-05-26T12:47:41.000-04:00
diff --git a/.well-known/mcp/server-card.json b/.well-known/mcp/server-card.json
@@ -8,7 +8,7 @@
     {
       "registryType": "pypi",
       "identifier": "mcp-broker",
-      "version": "0.1.2",
+      "version": "1.0.0",
       "transport": {
         "type": "stdio"
       }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,15 @@
 
 All notable public changes will be recorded here.
 
+## 1.0.0 - 2026-05-26
+
+- Promote the public release line from pre-1.0 packages to the first stable
+  release.
+- Align package, registry, MCPB, server-card, Homebrew, and public release
+  documentation on `1.0.0`.
+- Keep `0.1.x` entries as pre-1.0 public history instead of deleting published
+  artifacts.
+
 ## 0.1.2 - 2026-05-26
 
 - Harden mutation-gate coverage for configuration, profile validation, project
diff --git a/README.md b/README.md
@@ -133,9 +133,7 @@ Public release status:
 
 - The repo is designed to stay public-safe.
 - Private upstream inventory, account paths, OAuth state, secrets, sockets, logs, and generated client configs stay outside git.
-- Current GitHub, PyPI, and MCP Registry release is `0.1.2`.
-- Homebrew currently installs `0.1.1` from the public tap; the tap formula
-  needs a `0.1.2` refresh.
+- Stable release metadata is prepared for `1.0.0`; publication proof is tracked in `docs/distribution.md`.
 - Docker image support is available for container-friendly configs. Docker MCP Catalog submission still requires Docker review.
 - MCPB metadata is present at `mcpb/manifest.json` for local directory review.
 
diff --git a/SECURITY.md b/SECURITY.md
@@ -5,8 +5,8 @@ code you are choosing to run on your machine or call with your credentials.
 
 ## Supported Versions
 
-Security fixes target the current `main` branch until the first public release.
-After tagged releases begin, this file will list supported release lines.
+Security fixes target the current `main` branch and the current `1.x` stable
+release line.
 
 ## Reporting A Vulnerability
 
diff --git a/docs/distribution.md b/docs/distribution.md
@@ -4,17 +4,15 @@ This page tracks public distribution paths for `mcp-broker`.
 
 ## Python Package
 
-Package metadata is release-aligned at `0.1.2`. The version is sourced from
+Package metadata is release-aligned for `1.0.0`. The version is sourced from
 `src/mcp_broker/__init__.py`; `pyproject.toml` reads that value through
 Setuptools dynamic metadata.
 
-Current public package status:
+Current public package status before publication proof is recorded:
 
-- PyPI: `mcp-broker 0.1.2` is published.
-- MCP Registry: `io.github.NavinAgrawal/mcp-broker 0.1.2` is published and
-  marked latest.
-- Homebrew: the public tap still points at `0.1.1`; refresh the tap formula
-  before calling Homebrew current for `0.1.2`.
+- PyPI: `mcp-broker 1.0.0` metadata is prepared.
+- MCP Registry: `io.github.NavinAgrawal/mcp-broker 1.0.0` metadata is prepared.
+- Homebrew: the public tap must be refreshed to `1.0.0` after PyPI publishes.
 
 The package command surface is:
 
@@ -99,9 +97,9 @@ untouched during install, and preserves the runtime root contract:
 $HOME/mcp/mcp-broker/
 ```
 
-The public tap currently installs `0.1.1`. It must be updated and retested
-against the `0.1.2` PyPI source artifact before the Homebrew row is current for
-this release.
+Refresh the public tap to `1.0.0` after PyPI publishes. Retest the formula
+against the PyPI source artifact before marking Homebrew current for this
+release.
 
 ## MCP Registry
 
@@ -136,8 +134,8 @@ mcp-publisher publish
 PyPI package must exist first. The MCP Registry validates that the public
 package matches the server metadata before accepting the entry.
 
-The `0.1.2` registry workflow succeeded after PyPI publication and the registry
-marks `0.1.2` as the latest entry.
+Publish `1.0.0` after PyPI publication and verify the registry marks `1.0.0`
+as the latest entry.
 
 Reference docs:
 
@@ -163,7 +161,7 @@ Build a release image with OCI labels, SBOM, and provenance:
 
 ```bash
 make docker-buildx \
-  DOCKER_IMAGE=ghcr.io/<owner>/mcp-broker:0.1.2 \
+  DOCKER_IMAGE=ghcr.io/<owner>/mcp-broker:1.0.0 \
   DOCKER_PLATFORMS=linux/amd64,linux/arm64 \
   DOCKER_PUSH=1
 ```
diff --git a/docs/github-publication.md b/docs/github-publication.md
@@ -61,15 +61,15 @@ The demo should show:
 Release title:
 
 ```text
-mcp-broker 0.1.2
+mcp-broker 1.0.0
 ```
 
 Use these release notes as the starting body:
 
 release notes:
 
 ```text
-mcp-broker 0.1.2 refreshes the public package and registry metadata.
+mcp-broker 1.0.0 is the first stable public release.
 
 Highlights:
 - one compact MCP facade for many upstream MCP servers
diff --git a/mcpb/manifest.json b/mcpb/manifest.json
@@ -2,7 +2,7 @@
   "manifest_version": "0.4",
   "name": "mcp-broker",
   "display_name": "mcp-broker",
-  "version": "0.1.2",
+  "version": "1.0.0",
   "description": "Local MCP broker that exposes many configured upstream MCP servers through one client entry.",
   "long_description": "mcp-broker runs a local broker process and a compact stdio facade so MCP clients can connect to one local server instead of loading every upstream tool directly.",
   "author": {
diff --git a/registry/server.json b/registry/server.json
@@ -8,12 +8,12 @@
     "source": "github"
   },
   "websiteUrl": "https://github.com/NavinAgrawal/mcp-broker#readme",
-  "version": "0.1.2",
+  "version": "1.0.0",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "mcp-broker",
-      "version": "0.1.2",
+      "version": "1.0.0",
       "transport": {
         "type": "stdio"
       }
diff --git a/registry/server.template.json b/registry/server.template.json
@@ -6,12 +6,12 @@
     "url": "https://github.com/example/mcp-broker",
     "source": "github"
   },
-  "version": "0.1.2",
+  "version": "1.0.0",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "mcp-broker",
-      "version": "0.1.2",
+      "version": "1.0.0",
       "transport": {
         "type": "stdio"
       }
diff --git a/src/mcp_broker/__init__.py b/src/mcp_broker/__init__.py
@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.1.2"
+__version__ = "1.0.0"
diff --git a/src/mcp_broker/upstream_stdio.py b/src/mcp_broker/upstream_stdio.py
@@ -494,7 +494,9 @@ def drain() -> None:
     return thread
 
 
-def _read_stderr_chunk(stream: BinaryIO) -> bytes:
+def _read_stderr_chunk(stream: BinaryIO | None) -> bytes:
+    if stream is None:
+        return b""
     try:
         return stream.read(4096)
     except ValueError:
diff --git a/tests/journey/test_distribution_contract.py b/tests/journey/test_distribution_contract.py
@@ -11,6 +11,7 @@
 pytestmark = pytest.mark.journey
 
 ROOT = Path(__file__).resolve().parents[2]
+STABLE_RELEASE_VERSION = "1.0.0"
 
 
 def test_distribution_docs_and_package_metadata_are_public_ready() -> None:
@@ -78,6 +79,7 @@ def test_release_version_is_single_sourced_and_public_metadata_matches() -> None
     assert pyproject["project"]["dynamic"] == ["version"]
     assert "version" not in pyproject["project"]
     assert pyproject["tool"]["setuptools"]["dynamic"]["version"]["attr"] == "mcp_broker.__version__"
+    assert package_version == STABLE_RELEASE_VERSION
     assert package_version == latest_changelog_match.group(1)
     repository_match = re.fullmatch(
         r"https://github\.com/([^/]+)/([^/]+)", server["repository"]["url"]
@@ -99,6 +101,23 @@ def test_release_version_is_single_sourced_and_public_metadata_matches() -> None
     assert '"version": "0.0.1"' not in upstream_http
 
 
+def test_stable_release_public_status_is_aligned_to_1_0_0() -> None:
+    readme = (ROOT / "README.md").read_text(encoding="utf-8")
+    distribution = (ROOT / "docs" / "distribution.md").read_text(encoding="utf-8")
+    github_publication = (ROOT / "docs" / "github-publication.md").read_text(encoding="utf-8")
+    normalized_distribution = " ".join(distribution.split())
+
+    assert f"Stable release metadata is prepared for `{STABLE_RELEASE_VERSION}`" in readme
+    assert f"Package metadata is release-aligned for `{STABLE_RELEASE_VERSION}`." in distribution
+    assert f"PyPI: `mcp-broker {STABLE_RELEASE_VERSION}` metadata is prepared." in distribution
+    assert (
+        f"MCP Registry: `io.github.NavinAgrawal/mcp-broker {STABLE_RELEASE_VERSION}` "
+        "metadata is prepared."
+    ) in normalized_distribution
+    assert f"Homebrew: the public tap must be refreshed to `{STABLE_RELEASE_VERSION}`" in distribution
+    assert f"mcp-broker {STABLE_RELEASE_VERSION}" in github_publication
+
+
 def test_public_release_workflows_cover_ci_package_and_registry_publish() -> None:
     workflows = {
         path.name: path.read_text(encoding="utf-8")
diff --git a/tests/unit/test_upstream_stdio_contract.py b/tests/unit/test_upstream_stdio_contract.py
@@ -273,6 +273,10 @@ def test_stdio_stderr_chunk_reader_returns_empty_for_closed_stream() -> None:
     assert _read_stderr_chunk(stream) == b""
 
 
+def test_stdio_stderr_chunk_reader_returns_empty_for_missing_stream() -> None:
+    assert _read_stderr_chunk(None) == b""
+
+
 def test_close_process_pipes_closes_stderr_by_default() -> None:
     process = cast(
         subprocess.Popen[bytes],

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`{`
`9`	`9`	`"registryType": "pypi",`
`10`	`10`	`"identifier": "mcp-broker",`
`11`		`- "version": "0.1.2",`
	`11`	`+ "version": "1.0.0",`
`12`	`12`	`"transport": {`
`13`	`13`	`"type": "stdio"`
`14`	`14`	`}`
Original file line number	Diff line number	Diff line change
`@@ -2,4 +2,4 @@`
`2`	`2`
`3`	`3`	`__all__ = ["__version__"]`
`4`	`4`
`5`		`-__version__ = "0.1.2"`
	`5`	`+__version__ = "1.0.0"`