Skip to content

Commit 95c4d39

Browse files
authored
docs: record 0.1.4 release evidence (#41)
1 parent 2a8c857 commit 95c4d39

2 files changed

Lines changed: 139 additions & 1 deletion

File tree

RELEASING.md

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -692,3 +692,70 @@ authorized.
692692
workflow dispatch, or release-workflow rerun was used for `0.1.3`.
693693

694694
<!-- cometapi-release-evidence:end version=0.1.3 date=2026-07-30 -->
695+
696+
### Completed release-document normalization maintenance evidence
697+
698+
- Release-gate [PR #37](https://github.com/cometapi-dev/cometapi-python/pull/37)
699+
replaced stale natural-language heuristics with deterministic document and
700+
workflow contracts, moved all active examples and live checks to
701+
`gpt-5.6-sol`, passed
702+
[CI run 30614739509](https://github.com/cometapi-dev/cometapi-python/actions/runs/30614739509),
703+
and squash-merged as `c5eb2f96bd8a5c33c84d6ac00303e376cfac2221`.
704+
Release-boundary [PR #39](https://github.com/cometapi-dev/cometapi-python/pull/39)
705+
made Release Please's linked dated heading canonical, passed
706+
[CI run 30623035616](https://github.com/cometapi-dev/cometapi-python/actions/runs/30623035616),
707+
and squash-merged as `f28a84911015097872680ec09860ff71015bd7b4`.
708+
Normalization [PR #40](https://github.com/cometapi-dev/cometapi-python/pull/40)
709+
composed raw, normalized, decoded, and rendered evidence-URL validation,
710+
required source-distribution byte parity, and fixed immutable-build
711+
standalone verification before digest retention. Its exact head
712+
`2ee1f65c5ae40dc2d76564d6d4dac3247b09346b` passed
713+
[all required CI in run 30635373505](https://github.com/cometapi-dev/cometapi-python/actions/runs/30635373505)
714+
and independent adversarial review before squash-merging as
715+
`cd4e15157e2704c514483c44497837beab872f32`.
716+
- The resulting first-attempt Release Please maintenance run created
717+
[release PR #38](https://github.com/cometapi-dev/cometapi-python/pull/38).
718+
Its exact patch-release head `c4ed250f511a010c8fd2e8af132e12b652522ab4`
719+
changed only the manifest, project version, lock, and canonical dated
720+
changelog, passed
721+
[all required CI in run 30636496696](https://github.com/cometapi-dev/cometapi-python/actions/runs/30636496696),
722+
received exact-head human owner approval, and squash-merged as release commit
723+
`2a8c857292595471265d99891f5cc0c0ed743fc9`. The release commit passed
724+
[default-branch CI run 30637109945](https://github.com/cometapi-dev/cometapi-python/actions/runs/30637109945).
725+
726+
<!-- cometapi-release-evidence:start version=0.1.4 date=2026-07-31 -->
727+
<!-- cometapi-release-identity tag=v0.1.4 commit=2a8c857292595471265d99891f5cc0c0ed743fc9 workflow-run=30637109712 wheel-sha256=fc5992fed080b19e0d656b2f4a4bf5eef7f82b3726ba415f84853b228d4c484c sdist-sha256=b2b4adbc5da852fe9fdedbe17fa3f29aa536ebb31aefe9d2a7047e783d528df2 -->
728+
729+
- First-attempt
730+
[release run 30637109712](https://github.com/cometapi-dev/cometapi-python/actions/runs/30637109712)
731+
created and independently verified immutable non-draft release
732+
[v0.1.4](https://github.com/cometapi-dev/cometapi-python/releases/tag/v0.1.4)
733+
and its lightweight tag at release commit
734+
`2a8c857292595471265d99891f5cc0c0ed743fc9`, rebuilt and
735+
clean-installed both artifacts, verified the copied standalone checkout,
736+
passed the bounded four-request exact-release live suite with
737+
`gpt-5.6-sol`, received protected `pypi` approval, published directly from
738+
top-level `publish.yml` by OIDC with attestations, and passed public registry
739+
verification.
740+
- The exact [PyPI release](https://pypi.org/project/cometapi/0.1.4/) has wheel
741+
SHA256 `fc5992fed080b19e0d656b2f4a4bf5eef7f82b3726ba415f84853b228d4c484c`
742+
and source-distribution SHA256
743+
`b2b4adbc5da852fe9fdedbe17fa3f29aa536ebb31aefe9d2a7047e783d528df2`.
744+
Both files match the retained pre-publication digest record. PyPI Integrity
745+
API provenance identifies repository `cometapi-dev/cometapi-python`, workflow
746+
`publish.yml`, environment `pypi`, release commit `2a8c8572`, and release run
747+
attempt 1.
748+
- Independent post-workflow verification downloaded both public files,
749+
verified both provenance records with `pypi-attestations==0.0.29`, and
750+
installed `cometapi==0.1.4` from `https://pypi.org/simple/` with the
751+
then-current OpenAI 2.x dependency. It verified the public version, exact
752+
exports, and isolated installed
753+
module; passed the canonical supported-operation mocked-call smoke and all
754+
four README examples; and passed the release source distribution's full
755+
ten-case sync/async, stream/non-stream supported-operation contract suite
756+
against that public installation.
757+
- `RELEASE_PLEASE_ENABLED=false` and `LIVE_SMOKE_ENABLED=false`.
758+
`RELEASE_RECOVERY_TAG` and `RELEASE_RECOVERY_SHA` are absent; no recovery tag,
759+
workflow dispatch, or release-workflow rerun was used for `0.1.4`.
760+
761+
<!-- cometapi-release-evidence:end version=0.1.4 date=2026-07-31 -->

ROADMAP.md

Lines changed: 72 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# CometAPI Python SDK Roadmap
22

33
Status: Stable `0.1.x` maintenance active
4-
Last updated: 2026-07-30
4+
Last updated: 2026-07-31
55
Repository contract: this roadmap is self-contained.
66
Current gate: maintain the verified stable 0.1 surface. Begin 0.2 only after a
77
separate maintainer request authorizes its provider schemas and live contracts.
@@ -34,6 +34,7 @@ roadmap and `COMPATIBILITY.md`.
3434
| Configuration maintenance | Complete | Configuration validation and every stable release, live, provenance, and registry gate passed. |
3535
| Release metadata maintenance | Complete | Publication-neutral metadata and release-transport boundaries passed every normal release, live, provenance, and registry gate. |
3636
| 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. |
3738
| Provider-native text | Planned | Optional official Anthropic and Gemini adapters after separately authorized 0.2 activation. |
3839
| CometAPI resources | Planned | First schema-backed typed CometAPI-specific resource after separately authorized 0.2 activation. |
3940
| 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`.
732733

733734
<!-- cometapi-release-evidence:end version=0.1.3 date=2026-07-30 -->
734735

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+
735806
## Provider-native text adapters (future milestone)
736807

737808
Planned scope:

0 commit comments

Comments
 (0)