chore: finalize 0.1.0 release

0.1.0 is approved for PyPI publication.

Author: CometAPI

CHANGELOG.md

@@ -4,21 +4,17 @@ All notable changes to this project are documented in this file. The project
 follows Semantic Versioning and uses Conventional Commits for release-PR
 automation.
 
-## [0.1.0](https://github.com/cometapi-dev/cometapi-python/compare/v0.1.0-alpha.1...v0.1.0) (2026-07-28)
+## [Unreleased]
 
+## [0.1.0] - 2026-07-28
 
 ### Features
 
-* prepare the stable release ([#19](https://github.com/cometapi-dev/cometapi-python/issues/19)) ([2e5407c](https://github.com/cometapi-dev/cometapi-python/commit/2e5407c106b6bc557c51e629b4713012dbce3744))
-
+- Prepare the stable release ([#19](https://github.com/cometapi-dev/cometapi-python/issues/19)) ([2e5407c](https://github.com/cometapi-dev/cometapi-python/commit/2e5407c106b6bc557c51e629b4713012dbce3744)).
 
 ### Documentation
 
-* record Registry Alpha release ([#18](https://github.com/cometapi-dev/cometapi-python/issues/18)) ([f39b4dc](https://github.com/cometapi-dev/cometapi-python/commit/f39b4dc9f2e18e91ab3cbac202246f85658f71fd))
-
-## [Unreleased]
-
-### Changed
+- Record Registry Alpha release evidence ([#18](https://github.com/cometapi-dev/cometapi-python/issues/18)) ([f39b4dc](https://github.com/cometapi-dev/cometapi-python/commit/f39b4dc9f2e18e91ab3cbac202246f85658f71fd)).
 
 - Release documentation now records completed Registry Alpha publication,
   provenance, digest, clean-install, import, and mocked-call verification.
@@ -65,3 +61,5 @@ automation.
 - Unsupported aliases `CometClient` and `AsyncCometClient`.
 - Account, balance, token, log, task, and platform helpers from the 0.1 scope.
 - The provisional single-maintainer `CODEOWNERS` requirement.
+
+[0.1.0]: https://github.com/cometapi-dev/cometapi-python/compare/v0.1.0-alpha.1%2Brecovery.1...v0.1.0

CONTRIBUTING.md

@@ -1,9 +1,8 @@
 # Contributing to the CometAPI Python SDK
 
-Thank you for helping improve the SDK. The repository has released the
-`0.1.0a1` Registry Alpha. Contributions must stay within the supported 0.1
-scope described in `README.md`, `ROADMAP.md`, and `COMPATIBILITY.md`. The
-canonical repository is
+Thank you for helping improve the SDK. The repository targets the stable 0.1
+contract. Contributions must stay within the supported 0.1 scope described in
+`README.md`, `ROADMAP.md`, and `COMPATIBILITY.md`. The canonical repository is
 <https://github.com/cometapi-dev/cometapi-python>.
 
 ## Development setup
@@ -79,7 +78,7 @@ Use Conventional Commit subjects where practical, for example:
 ```text
 feat: add a supported client option
 fix: preserve an upstream error type
-docs: clarify alpha installation
+docs: clarify installation
 test: cover async response streaming
 ```
 

README.md

@@ -1,7 +1,6 @@
 # CometAPI Python SDK
 
-> **Pre-release:** `0.1.0a1` is available from PyPI. Its API may change before
-> `0.1.0`.
+> **Stable release:** `0.1.0` is approved for PyPI publication.
 
 `cometapi` is a thin Python adapter over the official OpenAI SDK for the
 OpenAI-compatible CometAPI endpoint. It changes the default API key and base
@@ -30,15 +29,15 @@ Project links: [CometAPI](https://www.cometapi.com),
 
 ## Installation
 
-Install the exact alpha from PyPI with:
+Install the stable release from PyPI with:
 
 ```bash
-python -m pip install --pre 'cometapi==0.1.0a1'
+python -m pip install 'cometapi==0.1.0'
 ```
 
 See the immutable
-[GitHub prerelease](https://github.com/cometapi-dev/cometapi-python/releases/tag/v0.1.0-alpha.1%2Brecovery.1)
-and exact [PyPI release](https://pypi.org/project/cometapi/0.1.0a1/) for the
+[GitHub release](https://github.com/cometapi-dev/cometapi-python/releases/tag/v0.1.0)
+and exact [PyPI release](https://pypi.org/project/cometapi/0.1.0/) for the
 published artifact.
 
 ## Authentication and configuration
@@ -160,7 +159,7 @@ This is an interoperability option, not the primary `cometapi` experience.
 
 ## Explicit non-goals for 0.1
 
-The alpha does not add Anthropic or Gemini adapters, CometAPI account or
+The 0.1 release does not add Anthropic or Gemini adapters, CometAPI account or
 platform resources, media APIs, provider-neutral message translation, CLI
 behavior, or custom HTTP/SSE/retry implementations. There are no compatibility
 aliases named `CometClient` or `AsyncCometClient`.

SECURITY.md

@@ -2,13 +2,13 @@
 
 ## Supported versions
 
-The SDK is in pre-release development. Published support claims begin only
-after a package is independently verified from PyPI.
+The SDK's supported 0.1 API surface is stable. Security support applies to
+packages that have been independently verified from PyPI.
 
 | Version | Status |
 | --- | --- |
-| `0.1.x` prereleases | Best-effort security fixes after verified publication |
-| `0.1.x` stable | Planned support after verified publication |
+| `0.1.x` stable | Supported |
+| `0.1.x` prereleases | Best-effort security fixes |
 | Older versions | Unsupported |
 
 ## Reporting a vulnerability
@@ -17,14 +17,13 @@ Do not disclose a suspected vulnerability, credential, customer data, or
 exploit details in a public issue.
 
 Use the repository's
-[private security advisory form](https://github.com/cometapi-dev/cometapi-python/security/advisories/new)
-when it is available. During private validation, before GitHub Private
-Vulnerability Reporting is enabled, email `support@cometapi.com` with the
-subject "Security report" and only the minimum details needed to establish a
+[private security advisory form](https://github.com/cometapi-dev/cometapi-python/security/advisories/new).
+If that form is unavailable, email `support@cometapi.com` with the subject
+"Security report" and only the minimum details needed to establish a
 confidential follow-up channel. Do not disclose sensitive details publicly.
 
 The maintainers will acknowledge and triage reports as soon as practical, but
-no response-time service-level agreement is promised for prereleases.
+no response-time service-level agreement is promised.
 Coordinated disclosure timing will be agreed with the reporter.
 
 ## Credential safety

SUPPORT.md

@@ -2,8 +2,8 @@
 
 ## Project status
 
-The SDK is in pre-release development. Support is best-effort, and no response
-or resolution time is guaranteed.
+The SDK's supported 0.1 API surface is stable. Support is best-effort, and no
+response or resolution time is guaranteed.
 
 ## Supported SDK surface
 

pyproject.toml

@@ -9,7 +9,7 @@ license = "MIT"
 license-files = ["LICENSE"]
 keywords = ["ai", "cometapi", "openai", "sdk"]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 5 - Production/Stable",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",

release-please-config.json

@@ -3,9 +3,6 @@
   "release-type": "python",
   "include-component-in-tag": false,
   "include-v-in-tag": true,
-  "last-release-sha": "31b68904141489ca04932edbf305ccf88af09372",
-  "prerelease": false,
-  "versioning": "prerelease",
   "packages": {
     ".": {
       "package-name": "cometapi",

scripts/check_version.py

@@ -67,7 +67,7 @@ def _artifact_version(path: Path) -> str:
 }
 
 
-def _require_canonical_tag(tag: str, project_version: str) -> str:
+def require_canonical_tag(tag: str, project_version: str) -> str:
     normalized = normalize_version(project_version)
     alpha = re.fullmatch(r"(?P<base>\d+\.\d+\.\d+)a(?P<number>\d+)", normalized)
     expected = (
@@ -310,7 +310,7 @@ def main() -> int:
     if args.expected:
         versions.append(("expected", args.expected))
     if args.tag:
-        versions.append(("tag", _require_canonical_tag(args.tag, project)))
+        versions.append(("tag", require_canonical_tag(args.tag, project)))
     for value in args.artifacts:
         path = Path(value)
         if not path.is_file():

tests/test_release_documents.py

@@ -15,7 +15,11 @@
     CANONICAL_SUPPORT,
     CheckError,
 )
-from scripts.check_version import require_public_preview_docs, require_releasable_docs
+from scripts.check_version import (
+    require_canonical_tag,
+    require_public_preview_docs,
+    require_releasable_docs,
+)
 
 PROJECT_ROOT = Path(__file__).resolve().parents[1]
 VERSION_SCRIPT = PROJECT_ROOT / "scripts" / "check_version.py"
@@ -233,64 +237,30 @@ def test_public_preview_cli_reports_aggregated_violations_and_fails(
     assert "SECURITY.md: missing canonical public value" in result.stderr
 
 
-def test_release_version_cli_accepts_approved_initial_alpha_recovery_tag(
-    releasable_documents: Path,
-) -> None:
+def test_release_version_cli_accepts_current_stable_tag() -> None:
     result = subprocess.run(
         [
             sys.executable,
             str(VERSION_SCRIPT),
             "--tag",
-            "v0.1.0-alpha.1+recovery.1",
+            "v0.1.0",
             "--require-changelog",
         ],
-        cwd=releasable_documents,
+        cwd=PROJECT_ROOT,
         text=True,
         check=False,
         capture_output=True,
     )
 
     assert result.returncode == 0, result.stderr
-    assert "version agreement passed: 0.1.0a1" in result.stdout
-
-
-def test_release_version_cli_rejects_tombstoned_initial_alpha_tag(
-    releasable_documents: Path,
-) -> None:
-    result = subprocess.run(
-        [
-            sys.executable,
-            str(VERSION_SCRIPT),
-            "--tag",
-            "v0.1.0-alpha.1",
-            "--require-changelog",
-        ],
-        cwd=releasable_documents,
-        text=True,
-        check=False,
-        capture_output=True,
-    )
+    assert "version agreement passed: 0.1.0" in result.stdout
 
-    assert result.returncode != 0
-    assert "release tag must use an approved spelling" in result.stderr
 
+def test_release_version_accepts_approved_initial_alpha_recovery_tag() -> None:
+    assert require_canonical_tag("v0.1.0-alpha.1+recovery.1", "0.1.0a1") == "0.1.0a1"
 
-def test_release_version_cli_rejects_unapproved_recovery_tag(
-    releasable_documents: Path,
-) -> None:
-    result = subprocess.run(
-        [
-            sys.executable,
-            str(VERSION_SCRIPT),
-            "--tag",
-            "v0.1.0-alpha.1+recovery.2",
-            "--require-changelog",
-        ],
-        cwd=releasable_documents,
-        text=True,
-        check=False,
-        capture_output=True,
-    )
 
-    assert result.returncode != 0
-    assert "release tag must use an approved spelling" in result.stderr
+@pytest.mark.parametrize("tag", ["v0.1.0-alpha.1", "v0.1.0-alpha.1+recovery.2"])
+def test_release_version_rejects_unapproved_initial_alpha_tag(tag: str) -> None:
+    with pytest.raises(CheckError, match="release tag must use an approved spelling"):
+        require_canonical_tag(tag, "0.1.0a1")

tests/test_release_workflow.py

@@ -30,6 +30,19 @@
 TRUST_SCRIPT = PROJECT_ROOT / "scripts" / "verify_release_trust.sh"
 
 
+def _reviewed_release_please_bridge_config() -> str:
+    stable = RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8")
+    marker = '  "include-v-in-tag": true,\n'
+    if marker not in stable:
+        raise AssertionError("stable Release Please config lost its tag contract")
+    bridge = (
+        '  "last-release-sha": "31b68904141489ca04932edbf305ccf88af09372",\n'
+        '  "prerelease": false,\n'
+        '  "versioning": "prerelease",\n'
+    )
+    return stable.replace(marker, marker + bridge, 1)
+
+
 def _git(root: Path, *arguments: str, input_text: str | None = None) -> str:
     result = subprocess.run(
         ["git", *arguments],
@@ -746,13 +759,20 @@ def test_current_release_please_workflow_is_disabled_by_default() -> None:
     check_release_please_workflow(RELEASE_PLEASE_WORKFLOW.read_text(encoding="utf-8"))
 
 
-def test_current_release_please_config_has_reviewed_stable_bridge() -> None:
+def test_current_release_please_config_has_reviewed_stable_cleanup() -> None:
     check_release_please_config(
         RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8"),
         RELEASE_PLEASE_MANIFEST.read_text(encoding="utf-8"),
     )
 
 
+def test_release_please_config_accepts_reviewed_stable_bridge() -> None:
+    check_release_please_config(
+        _reviewed_release_please_bridge_config(),
+        '{".": "0.1.0-alpha.1"}\n',
+    )
+
+
 @pytest.mark.parametrize(
     ("needle", "replacement", "message"),
     [
@@ -775,12 +795,12 @@ def test_current_release_please_config_has_reviewed_stable_bridge() -> None:
 def test_release_please_config_rejects_bridge_drift(
     needle: str, replacement: str, message: str
 ) -> None:
-    text = RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8")
+    text = _reviewed_release_please_bridge_config()
     assert needle in text
     with pytest.raises(RuntimeError, match=message):
         check_release_please_config(
             text.replace(needle, replacement, 1),
-            RELEASE_PLEASE_MANIFEST.read_text(encoding="utf-8"),
+            '{".": "0.1.0-alpha.1"}\n',
         )
 
 
@@ -806,34 +826,26 @@ def test_release_please_config_rejects_manifest_drift() -> None:
 
 
 def test_release_please_config_accepts_exact_stable_cleanup() -> None:
-    config = RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8")
-    for line in (
-        '  "last-release-sha": "31b68904141489ca04932edbf305ccf88af09372",\n',
-        '  "prerelease": false,\n',
-        '  "versioning": "prerelease",\n',
-    ):
-        config = config.replace(line, "", 1)
-    check_release_please_config(config, '{".": "0.1.0"}\n')
+    check_release_please_config(
+        RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8"),
+        '{".": "0.1.0"}\n',
+    )
 
 
 def test_release_please_config_rejects_stable_manifest_with_bridge() -> None:
     with pytest.raises(RuntimeError, match="remove the one-time bridge"):
         check_release_please_config(
-            RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8"),
+            _reviewed_release_please_bridge_config(),
             '{".": "0.1.0"}\n',
         )
 
 
 def test_release_please_config_rejects_bridge_cleanup_before_stable() -> None:
-    config = RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8")
-    for line in (
-        '  "last-release-sha": "31b68904141489ca04932edbf305ccf88af09372",\n',
-        '  "prerelease": false,\n',
-        '  "versioning": "prerelease",\n',
-    ):
-        config = config.replace(line, "", 1)
     with pytest.raises(RuntimeError, match="only after stable"):
-        check_release_please_config(config, '{".": "0.1.0-alpha.1"}\n')
+        check_release_please_config(
+            RELEASE_PLEASE_CONFIG.read_text(encoding="utf-8"),
+            '{".": "0.1.0-alpha.1"}\n',
+        )
 
 
 @pytest.mark.parametrize(