Skip to content

Commit 0f71cca

Browse files
authored
docs: record 0.1.2 release evidence (#33)
Records the verified remote, live, registry, digest, provenance, and closeout evidence for cometapi 0.1.2.
1 parent 710c564 commit 0f71cca

2 files changed

Lines changed: 107 additions & 8 deletions

File tree

RELEASING.md

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -525,3 +525,53 @@ authorized.
525525
- `RELEASE_PLEASE_ENABLED=false` and `LIVE_SMOKE_ENABLED=false`.
526526
`RELEASE_RECOVERY_TAG` and `RELEASE_RECOVERY_SHA` are absent; no recovery tag
527527
or recovery workflow was used for `0.1.1`.
528+
529+
### Completed `0.1.2` maintenance release evidence
530+
531+
- Metadata and runtime [PR #29](https://github.com/cometapi-dev/cometapi-python/pull/29)
532+
made packaged long descriptions release-neutral, added artifact assertions,
533+
pinned Release Please v5 to its Node 24 action commit, passed
534+
[CI run 30509063138](https://github.com/cometapi-dev/cometapi-python/actions/runs/30509063138),
535+
and squash-merged as `67bd1893983c724d1cc81b824106b7c3d9418e97`.
536+
- [Release Please run 30509764960](https://github.com/cometapi-dev/cometapi-python/actions/runs/30509764960)
537+
encountered an Undici/global `fetch` closed-connection race and created or
538+
updated no Git tree, commit, ref, pull request, tag, release, live request, or
539+
registry state.
540+
Transport-boundary [PR #31](https://github.com/cometapi-dev/cometapi-python/pull/31)
541+
separated non-retryable immutable release creation from one bounded retry of
542+
mutable PR maintenance, passed
543+
[CI run 30510887049](https://github.com/cometapi-dev/cometapi-python/actions/runs/30510887049),
544+
and squash-merged as `a411bf5c4aeba341a2d4520a023ad0fe2c5ccee3`.
545+
- Fresh first-attempt
546+
[Release Please run 30511071674](https://github.com/cometapi-dev/cometapi-python/actions/runs/30511071674)
547+
created and maintained
548+
[release PR #32](https://github.com/cometapi-dev/cometapi-python/pull/32).
549+
Its final head `322fdf40585f46aef64bc8b881ee2ce36c09c951` passed
550+
[all required CI in run 30511373822](https://github.com/cometapi-dev/cometapi-python/actions/runs/30511373822),
551+
received human owner approval at that exact head, and squash-merged as release
552+
commit `710c56491d9ef5f47cccff3ce837ab7e799455b0`. The release commit passed
553+
[default-branch CI run 30515861285](https://github.com/cometapi-dev/cometapi-python/actions/runs/30515861285).
554+
- First-attempt
555+
[release run 30515861246](https://github.com/cometapi-dev/cometapi-python/actions/runs/30515861246)
556+
created and independently verified immutable non-draft release
557+
[v0.1.2](https://github.com/cometapi-dev/cometapi-python/releases/tag/v0.1.2)
558+
at the exact release commit, rebuilt and clean-installed both artifacts,
559+
passed the bounded four-request exact-release live suite, received protected
560+
`pypi` approval, published directly from top-level `publish.yml` by OIDC with
561+
attestations, and passed public registry verification.
562+
- The exact [PyPI release](https://pypi.org/project/cometapi/0.1.2/) has wheel
563+
SHA256 `3f12c26ae1ae7a1de5ac19d8ef27a784b2bf592143c716493f1b0f35ec19daca`
564+
and source-distribution SHA256
565+
`21c8edc0586610de1a9a8cd39b54ed23d2b1e20552100f69f53938cb7678da3d`.
566+
Both files match the retained pre-publication digest record. PyPI Integrity
567+
API provenance identifies repository `cometapi-dev/cometapi-python`, workflow
568+
`publish.yml`, environment `pypi`, release commit `710c5649`, and release
569+
[run attempt 1](https://github.com/cometapi-dev/cometapi-python/actions/runs/30515861246/attempts/1).
570+
- An independent post-workflow verification downloaded both public files,
571+
verified both provenance records with `pypi-attestations==0.0.29`, installed
572+
`cometapi==0.1.2` from `https://pypi.org/simple/`, verified the public version
573+
and imports, and passed supported mocked calls plus all README examples. The
574+
wheel metadata contains the release-neutral 0.1.x installation guidance.
575+
- `RELEASE_PLEASE_ENABLED=false` and `LIVE_SMOKE_ENABLED=false`.
576+
`RELEASE_RECOVERY_TAG` and `RELEASE_RECOVERY_SHA` are absent; no recovery tag,
577+
workflow dispatch, or workflow rerun was used for `0.1.2`.

ROADMAP.md

Lines changed: 57 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# CometAPI Python SDK Roadmap
22

3-
Status: `0.1.2` stable maintenance in progress
3+
Status: `0.1.2` stable maintenance released
44
Last updated: 2026-07-30
55
Repository contract: this roadmap is self-contained.
66
Current gate: maintain the verified stable 0.1 surface. Begin 0.2 only after a
@@ -13,12 +13,12 @@ to CometAPI while preserving official request, response, error, retry, timeout,
1313
sync, async, and streaming behavior.
1414

1515
Private Remote Validation, Public Preview, the functional `0.1.0a1` Registry
16-
Alpha, stable `0.1.0`, and maintenance release `0.1.1` are complete for the
17-
sanitized public repository. Protected repository configuration, public
18-
default-branch CI, exact-release live smoke, PyPI OIDC publication, provenance,
19-
digest comparison, and public-registry smoke provide separate evidence layers.
20-
Maintenance `0.1.2` is active only to harden release automation and immutable
21-
package metadata; it does not activate 0.2 scope.
16+
Alpha, stable `0.1.0`, and maintenance releases `0.1.1` and `0.1.2` are complete
17+
for the sanitized public repository. Protected repository configuration,
18+
public default-branch CI, exact-release live smoke, PyPI OIDC publication,
19+
provenance, digest comparison, and public-registry smoke provide separate
20+
evidence layers. Only 0.1.x maintenance is active; `0.1.2` does not activate
21+
0.2 scope.
2222
Support and release claims remain limited to the evidence defined in this
2323
roadmap and `COMPATIBILITY.md`.
2424

@@ -32,7 +32,7 @@ roadmap and `COMPATIBILITY.md`.
3232
| `0.1.0a1` Registry Alpha | Complete | Early adopters can install the functional prerelease from PyPI; every release and registry gate passed. |
3333
| `0.1.0` stable | Complete | Complete runtime, release-PR, example, provenance, and registry gates passed. |
3434
| `0.1.1` maintenance | Complete | Configuration validation and every stable release, live, provenance, and registry gate passed. |
35-
| `0.1.2` maintenance | In progress | Publication-neutral metadata and release-transport boundaries must pass every normal release gate before publication. |
35+
| `0.1.2` maintenance | Complete | Publication-neutral metadata and release-transport boundaries passed every normal release, live, provenance, and registry gate. |
3636
| `0.2.0` provider-native text | Planned | Optional official Anthropic and Gemini adapters. |
3737
| `0.3.0` CometAPI resources | Planned | First schema-backed typed CometAPI-specific resource. |
3838
| Media and task APIs | Planned | Coherent task lifecycle precedes individual media helpers. |
@@ -590,6 +590,55 @@ isolated transport close, while immutable tag and GitHub Release creation can
590590
never be automatically replayed. This remains 0.1.x maintenance and does not
591591
authorize provider, resource, CLI, or 0.2 work.
592592

593+
[Metadata and runtime PR #29](https://github.com/cometapi-dev/cometapi-python/pull/29)
594+
made the packaged README release-neutral, added wheel and source-distribution
595+
long-description assertions, and moved Release Please to its pinned v5 Node 24
596+
runtime. It passed
597+
[CI run 30509063138](https://github.com/cometapi-dev/cometapi-python/actions/runs/30509063138)
598+
and squash-merged as `67bd1893983c724d1cc81b824106b7c3d9418e97`.
599+
[Transport-boundary PR #31](https://github.com/cometapi-dev/cometapi-python/pull/31)
600+
passed
601+
[CI run 30510887049](https://github.com/cometapi-dev/cometapi-python/actions/runs/30510887049)
602+
and squash-merged as `a411bf5c4aeba341a2d4520a023ad0fe2c5ccee3`.
603+
The resulting first-attempt
604+
[Release Please run 30511071674](https://github.com/cometapi-dev/cometapi-python/actions/runs/30511071674)
605+
created and maintained
606+
[release PR #32](https://github.com/cometapi-dev/cometapi-python/pull/32).
607+
Its final head `322fdf40585f46aef64bc8b881ee2ce36c09c951` passed
608+
[all required CI in run 30511373822](https://github.com/cometapi-dev/cometapi-python/actions/runs/30511373822),
609+
received human owner approval at that exact head, and squash-merged as release
610+
commit `710c56491d9ef5f47cccff3ce837ab7e799455b0`. The release commit passed
611+
[default-branch CI run 30515861285](https://github.com/cometapi-dev/cometapi-python/actions/runs/30515861285).
612+
613+
First-attempt
614+
[release run 30515861246](https://github.com/cometapi-dev/cometapi-python/actions/runs/30515861246)
615+
created and verified the immutable non-draft
616+
[GitHub release](https://github.com/cometapi-dev/cometapi-python/releases/tag/v0.1.2)
617+
and lightweight tag `v0.1.2` at that exact release commit. It rebuilt and
618+
clean-installed the exact artifacts, passed the four-request exact-release live
619+
suite, received protected `pypi` approval, published directly from top-level
620+
`publish.yml` through OIDC with attestations, and passed public registry
621+
verification without a rerun or recovery path.
622+
623+
The exact [PyPI release](https://pypi.org/project/cometapi/0.1.2/) has wheel
624+
SHA256 `3f12c26ae1ae7a1de5ac19d8ef27a784b2bf592143c716493f1b0f35ec19daca`
625+
and source-distribution SHA256
626+
`21c8edc0586610de1a9a8cd39b54ed23d2b1e20552100f69f53938cb7678da3d`.
627+
Both files match the retained pre-publication digest record. Their PyPI
628+
Integrity API provenance names repository `cometapi-dev/cometapi-python`,
629+
workflow `publish.yml`, environment `pypi`, release commit `710c5649`, and
630+
[run attempt 1](https://github.com/cometapi-dev/cometapi-python/actions/runs/30515861246/attempts/1).
631+
An independent post-workflow verification downloaded both public files,
632+
verified both provenance records with `pypi-attestations==0.0.29`, installed
633+
`cometapi==0.1.2` from the public simple index, verified the public version and
634+
imports, and passed every supported mocked call and README example. The wheel's
635+
immutable long description contains the release-neutral 0.1.x installation
636+
guidance rather than a stale pre-publication version claim.
637+
638+
`RELEASE_PLEASE_ENABLED=false` and `LIVE_SMOKE_ENABLED=false`. Recovery
639+
variables are absent. No recovery tag, workflow dispatch, or workflow rerun was
640+
used for `0.1.2`.
641+
593642
## `0.2.0`: Provider-native text adapters
594643

595644
Planned scope:

0 commit comments

Comments
 (0)