Skip to content

Commit b335b32

Browse files
authored
docs: record alpha.3 registry release (#24)
1 parent 817c40b commit b335b32

3 files changed

Lines changed: 64 additions & 24 deletions

File tree

README.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ the official OpenAI JavaScript request, response, stream, and error types while
55
defaulting the client to CometAPI.
66

77
> **Registry Alpha pre-release:** the SDK is under active 0.1 development.
8-
> `0.1.0-alpha.3` is approved for npm publication under the `next` dist-tag,
9-
> and its API may change before `0.1.0`.
8+
> `0.1.0-alpha.3` is available from npm under the `next` dist-tag, and its API
9+
> may change before `0.1.0`.
1010
1111
## Supported 0.1 surface
1212

@@ -210,10 +210,12 @@ parent.
210210
211211
The repository has completed Public Preview. Blocking CI, protected repository
212212
rules, security reporting, protected environments, and the authorized live
213-
smoke have passed. Registry Alpha `0.1.0-alpha.1` is available from npm. The
214-
immutable `0.1.0-alpha.2` GitHub release failed before invoking npm, and
215-
`0.1.0-alpha.3` is approved for OIDC publication. Mocked responses, packed
216-
artifacts, GitHub Actions, trusted live tests, and npm publication remain
213+
smoke have passed. Registry Alpha `0.1.0-alpha.3` was published from the
214+
immutable release artifact through GitHub Actions OIDC with provenance, and
215+
independent public-registry ESM, CommonJS, and compatible-OpenAI host installs
216+
passed. The immutable `0.1.0-alpha.2` GitHub release remains as an unpublished
217+
failure record because its guard stopped before invoking npm. Mocked responses,
218+
packed artifacts, GitHub Actions, trusted live tests, and npm publication remain
217219
separate evidence layers and must not be represented as another.
218220
219221
See:

RELEASING.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -351,6 +351,44 @@ one-time exception:
351351

352352
This exception must never become a reusable source-controlled publishing path.
353353

354+
## Registry Alpha release evidence
355+
356+
Registry Alpha completed on 2026-07-27 with these independently auditable
357+
layers:
358+
359+
- The one-time `0.1.0-alpha.1` bootstrap recovery published the exact artifact
360+
with provenance in [GitHub Actions run 30251436832](https://github.com/cometapi-dev/cometapi-node/actions/runs/30251436832).
361+
- npm ownership lists both `tensornull <tensor.null@gmail.com>` and the
362+
company-controlled `cometapi_dev <dev@cometapi.com>` account. The bootstrap
363+
token was revoked, local npm authentication was removed, the protected `npm`
364+
environment has no secrets or variables, and npm disallows token publishing.
365+
- The immutable `0.1.0-alpha.2` release passed exact-artifact verification and
366+
protected live smoke in [run 30270656080](https://github.com/cometapi-dev/cometapi-node/actions/runs/30270656080),
367+
then failed before invoking npm because the local publication guard rejected
368+
the fixed `actions/setup-node` authentication placeholder. No alpha.2
369+
registry artifact exists.
370+
- Pull request [#23](https://github.com/cometapi-dev/cometapi-node/pull/23)
371+
added regression coverage for that placeholder while preserving rejection of
372+
real registry credentials. Default-branch [CI run 30272606126](https://github.com/cometapi-dev/cometapi-node/actions/runs/30272606126)
373+
passed before tagging.
374+
- The immutable [`v0.1.0-alpha.3` release](https://github.com/cometapi-dev/cometapi-node/releases/tag/v0.1.0-alpha.3)
375+
completed exact-artifact verification, the bounded three-request live smoke,
376+
OIDC publication, registry convergence, signature verification, dependency
377+
deduplication, and public installation in [run 30272764488](https://github.com/cometapi-dev/cometapi-node/actions/runs/30272764488).
378+
- npm identifies the publisher as GitHub Actions using
379+
`npm-oidc-no-reply@github.com`. The registry reports SLSA provenance v1 and
380+
integrity
381+
`sha512-dtzQOz0dxif74jJpu2fhfUVjiq6TLm3YkPydtsryHGxuU6usaLWTpcblky854T42TG+SbTApCgOoNJDMkEYIOg==`,
382+
and Sigstore transparency-log index
383+
[`2257566579`](https://search.sigstore.dev/?logIndex=2257566579).
384+
- Independent installs from the public registry passed for ESM, CommonJS, and a
385+
host already declaring `openai@6.47.0`. The host resolved one effective
386+
OpenAI installation and preserved `APIError instanceof` identity. Registry
387+
signatures and attestations were verified with `npm audit signatures`.
388+
- The `next` dist-tag resolves to `0.1.0-alpha.3`. The registry-created `latest`
389+
tag remains on `0.1.0-alpha.1`; it is outside the prerelease installation path
390+
and remains explicit residual cleanup before stable publication.
391+
354392
## Stable 0.1.0 sequence
355393

356394
```text

ROADMAP.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# CometAPI TypeScript and Node.js SDK Roadmap
22

3-
Status: Public Preview complete; Registry Alpha OIDC closeout in progress
3+
Status: Public Preview and Registry Alpha complete; 0.1.0 stable planned
44
Last updated: 2026-07-27
55
Repository contract: This roadmap is self-contained and is the public source
66
of truth for this repository's release sequence.
@@ -17,22 +17,22 @@ tag rules, Private Vulnerability Reporting, protected environments, and
1717
authorized live-smoke evidence. The functional `0.1.0-alpha.1` prerelease is
1818
available from npm. The immutable `0.1.0-alpha.2` GitHub release failed locally
1919
before invoking npm because its publication guard rejected the fixed
20-
`actions/setup-node` authentication placeholder. Registry Alpha remains open
21-
until `0.1.0-alpha.3` completes the OIDC, provenance, ownership, and
22-
public-install verification sequence.
20+
`actions/setup-node` authentication placeholder. `0.1.0-alpha.3` completed the
21+
OIDC, provenance, ownership, and public-install verification sequence and is
22+
available from npm's `next` channel.
2323

2424
## Milestones
2525

26-
| Milestone | Status | User outcome |
27-
| -------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
28-
| Repository foundation | In progress | The repository has reproducible development, contribution, security, and release processes. |
29-
| Private Remote Validation | Complete | The sanitized private repository passes real credential-free default-branch CI; public-only controls and live tests remain disabled. |
30-
| Public Preview | Complete | The public repository has blocking CI, repository rules, security reporting, protected environments, and authorized live-smoke evidence. |
31-
| 0.1.x Registry Alpha | In progress | Early adopters can install a functional prerelease from npm's `next` channel; alpha.3 must prove the OIDC-only publication path. |
32-
| 0.1.0 Stable | Planned | Users can install a fully verified package from npm's default channel. |
33-
| 0.2.0 provider-native text | Planned | Users can opt into Anthropic Messages and Gemini text adapters through isolated subpath exports. |
34-
| 0.3.0 CometAPI resources | Planned | Users receive typed access to the first stable CometAPI-specific account or platform resources. |
35-
| Media and task APIs | Later | Users receive typed image, video, audio, upload, polling, and task lifecycle helpers after their contracts are stable. |
26+
| Milestone | Status | User outcome |
27+
| -------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
28+
| Repository foundation | In progress | The repository has reproducible development, contribution, security, and release processes. |
29+
| Private Remote Validation | Complete | The sanitized private repository passes real credential-free default-branch CI; public-only controls and live tests remain disabled. |
30+
| Public Preview | Complete | The public repository has blocking CI, repository rules, security reporting, protected environments, and authorized live-smoke evidence. |
31+
| 0.1.x Registry Alpha | Complete | Early adopters can install a functional, provenance-verified prerelease from npm's `next` channel through the OIDC-only publication path. |
32+
| 0.1.0 Stable | Planned | Users can install a fully verified package from npm's default channel. |
33+
| 0.2.0 provider-native text | Planned | Users can opt into Anthropic Messages and Gemini text adapters through isolated subpath exports. |
34+
| 0.3.0 CometAPI resources | Planned | Users receive typed access to the first stable CometAPI-specific account or platform resources. |
35+
| Media and task APIs | Later | Users receive typed image, video, audio, upload, polling, and task lifecycle helpers after their contracts are stable. |
3636

3737
## Repository Foundation
3838

@@ -347,10 +347,10 @@ npm does not allow configuration before the first package publication, only
347347
local publication guard rejected the fixed `actions/setup-node`
348348
authentication placeholder before npm was invoked; no alpha.2 registry
349349
artifact exists.
350-
6. The project preserves that immutable failure record, publishes
351-
`0.1.0-alpha.3` through OIDC with regression coverage for the placeholder,
352-
verifies provenance and installation, and confirms that `next` resolves to
353-
`0.1.0-alpha.3`.
350+
6. The project preserved that immutable failure record and published
351+
`0.1.0-alpha.3` through OIDC with regression coverage for the placeholder.
352+
Provenance, registry signatures, independent installation, ownership, and
353+
the `next` dist-tag were verified.
354354

355355
This exception must be recorded in the release evidence and must never become
356356
a reusable publication path.

0 commit comments

Comments
 (0)