|
1 | 1 | # CometAPI Python SDK Roadmap |
2 | 2 |
|
3 | 3 | Status: Stable `0.1.x` maintenance active |
4 | | -Last updated: 2026-07-30 |
| 4 | +Last updated: 2026-07-31 |
5 | 5 | Repository contract: this roadmap is self-contained. |
6 | 6 | Current gate: maintain the verified stable 0.1 surface. Begin 0.2 only after a |
7 | 7 | separate maintainer request authorizes its provider schemas and live contracts. |
@@ -34,6 +34,7 @@ roadmap and `COMPATIBILITY.md`. |
34 | 34 | | Configuration maintenance | Complete | Configuration validation and every stable release, live, provenance, and registry gate passed. | |
35 | 35 | | Release metadata maintenance | Complete | Publication-neutral metadata and release-transport boundaries passed every normal release, live, provenance, and registry gate. | |
36 | 36 | | Release-claim maintenance | Complete | Durable release-claim detection passed every normal release, live, provenance, and registry gate. | |
| 37 | +| Release-document normalization maintenance | Complete | Composed changelog, evidence-URL, archive-parity, and standalone-release gates passed every normal release, live, provenance, and registry gate. | |
37 | 38 | | Provider-native text | Planned | Optional official Anthropic and Gemini adapters after separately authorized 0.2 activation. | |
38 | 39 | | CometAPI resources | Planned | First schema-backed typed CometAPI-specific resource after separately authorized 0.2 activation. | |
39 | 40 | | Media and task APIs | Planned | Coherent task lifecycle precedes individual media helpers. | |
@@ -732,6 +733,76 @@ workflow dispatch, or release-workflow rerun was used for `0.1.3`. |
732 | 733 |
|
733 | 734 | <!-- cometapi-release-evidence:end version=0.1.3 date=2026-07-30 --> |
734 | 735 |
|
| 736 | +## Release-document normalization maintenance |
| 737 | + |
| 738 | +[Release-gate PR #37](https://github.com/cometapi-dev/cometapi-python/pull/37) |
| 739 | +replaced stale natural-language heuristics with deterministic document and |
| 740 | +workflow contracts, moved all active examples and live checks to |
| 741 | +`gpt-5.6-sol`, passed |
| 742 | +[CI run 30614739509](https://github.com/cometapi-dev/cometapi-python/actions/runs/30614739509), |
| 743 | +and squash-merged as `c5eb2f96bd8a5c33c84d6ac00303e376cfac2221`. |
| 744 | +[Release-boundary PR #39](https://github.com/cometapi-dev/cometapi-python/pull/39) |
| 745 | +made Release Please's linked dated heading canonical and tightened release |
| 746 | +document ownership, passed |
| 747 | +[CI run 30623035616](https://github.com/cometapi-dev/cometapi-python/actions/runs/30623035616), |
| 748 | +and squash-merged as `f28a84911015097872680ec09860ff71015bd7b4`. |
| 749 | +[Normalization PR #40](https://github.com/cometapi-dev/cometapi-python/pull/40) |
| 750 | +then composed raw, normalized, decoded, and rendered evidence-URL validation, |
| 751 | +required source-distribution byte parity, and fixed immutable-build standalone |
| 752 | +verification before digest retention. Its exact head |
| 753 | +`2ee1f65c5ae40dc2d76564d6d4dac3247b09346b` passed |
| 754 | +[all required CI in run 30635373505](https://github.com/cometapi-dev/cometapi-python/actions/runs/30635373505) |
| 755 | +and independently reviewed adversarial probes before squash-merging as |
| 756 | +`cd4e15157e2704c514483c44497837beab872f32`. |
| 757 | + |
| 758 | +The resulting first-attempt Release Please maintenance run created |
| 759 | +[release PR #38](https://github.com/cometapi-dev/cometapi-python/pull/38). |
| 760 | +Its exact patch-release head `c4ed250f511a010c8fd2e8af132e12b652522ab4` |
| 761 | +changed only the manifest, project version, lock, and canonical dated changelog, |
| 762 | +passed [all required CI in run 30636496696](https://github.com/cometapi-dev/cometapi-python/actions/runs/30636496696), |
| 763 | +received exact-head human owner approval, and squash-merged as release commit |
| 764 | +`2a8c857292595471265d99891f5cc0c0ed743fc9`. The release commit passed |
| 765 | +[default-branch CI run 30637109945](https://github.com/cometapi-dev/cometapi-python/actions/runs/30637109945). |
| 766 | + |
| 767 | +<!-- cometapi-release-evidence:start version=0.1.4 date=2026-07-31 --> |
| 768 | +<!-- cometapi-release-identity tag=v0.1.4 commit=2a8c857292595471265d99891f5cc0c0ed743fc9 workflow-run=30637109712 wheel-sha256=fc5992fed080b19e0d656b2f4a4bf5eef7f82b3726ba415f84853b228d4c484c sdist-sha256=b2b4adbc5da852fe9fdedbe17fa3f29aa536ebb31aefe9d2a7047e783d528df2 --> |
| 769 | + |
| 770 | +First-attempt |
| 771 | +[release run 30637109712](https://github.com/cometapi-dev/cometapi-python/actions/runs/30637109712) |
| 772 | +created and independently verified the immutable non-draft |
| 773 | +[GitHub release](https://github.com/cometapi-dev/cometapi-python/releases/tag/v0.1.4) |
| 774 | +and lightweight tag `v0.1.4` at release commit |
| 775 | +`2a8c857292595471265d99891f5cc0c0ed743fc9`. It rebuilt and |
| 776 | +clean-installed the exact artifacts, verified the copied standalone checkout, |
| 777 | +passed the bounded four-request exact-release live suite with `gpt-5.6-sol`, |
| 778 | +received protected `pypi` approval, published directly from top-level |
| 779 | +`publish.yml` by OIDC with attestations, and passed public registry |
| 780 | +verification. The release workflow used neither a rerun nor a recovery path. |
| 781 | + |
| 782 | +The exact [PyPI release](https://pypi.org/project/cometapi/0.1.4/) has wheel |
| 783 | +SHA256 `fc5992fed080b19e0d656b2f4a4bf5eef7f82b3726ba415f84853b228d4c484c` |
| 784 | +and source-distribution SHA256 |
| 785 | +`b2b4adbc5da852fe9fdedbe17fa3f29aa536ebb31aefe9d2a7047e783d528df2`. |
| 786 | +Both public files match the retained pre-publication digest record. PyPI |
| 787 | +Integrity API provenance identifies repository |
| 788 | +`cometapi-dev/cometapi-python`, workflow `publish.yml`, environment `pypi`, |
| 789 | +release commit `2a8c8572`, and release run attempt 1. |
| 790 | +Independent post-workflow verification downloaded both files, verified both |
| 791 | +provenance records with `pypi-attestations==0.0.29`, and installed |
| 792 | +`cometapi==0.1.4` from `https://pypi.org/simple/` with the then-current OpenAI |
| 793 | +2.x dependency. It |
| 794 | +verified the public version, exact exports, and isolated installed module; |
| 795 | +passed the canonical supported-operation mocked-call smoke and all four README |
| 796 | +examples; and passed the release source distribution's full ten-case |
| 797 | +sync/async, stream/non-stream supported-operation contract suite against that |
| 798 | +public installation. |
| 799 | + |
| 800 | +`RELEASE_PLEASE_ENABLED=false` and `LIVE_SMOKE_ENABLED=false`. |
| 801 | +`RELEASE_RECOVERY_TAG` and `RELEASE_RECOVERY_SHA` are absent; no recovery tag, |
| 802 | +workflow dispatch, or release-workflow rerun was used for `0.1.4`. |
| 803 | + |
| 804 | +<!-- cometapi-release-evidence:end version=0.1.4 date=2026-07-31 --> |
| 805 | + |
735 | 806 | ## Provider-native text adapters (future milestone) |
736 | 807 |
|
737 | 808 | Planned scope: |
|
0 commit comments