Skip to content

Commit 65ba3f3

Browse files
authored
docs: mark public preview complete
Public Preview controls and evidence are complete; Registry Alpha remains separate.
1 parent 40021cf commit 65ba3f3

4 files changed

Lines changed: 37 additions & 31 deletions

File tree

CHANGELOG.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,8 @@ follows Keep a Changelog, and versions follow Semantic Versioning.
55

66
## [Unreleased]
77

8-
No user-visible changes are currently recorded beyond the initial alpha scope.
8+
- Completed the Public Preview repository transition, protected configuration,
9+
and authorized live-smoke verification. Registry Alpha remains unpublished.
910

1011
## [0.1.0-alpha.1] - Unreleased
1112

README.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,8 @@ The official CometAPI entry point for the OpenAI-compatible API. The SDK keeps
44
the official OpenAI JavaScript request, response, stream, and error types while
55
defaulting the client to CometAPI.
66

7-
> **Pre-release:** the SDK is under active 0.1 development. The package is not
8-
> yet available from npm, and its API may change before `0.1.0`.
7+
> **Public Preview pre-release:** the SDK is under active 0.1 development. The
8+
> package is not yet available from npm, and its API may change before `0.1.0`.
99
1010
## Supported 0.1 surface
1111

@@ -207,16 +207,18 @@ parent.
207207
208208
## Project status
209209
210-
The repository is preparing for Public Preview and the first Registry Alpha.
211-
Mocked responses, packed artifacts, GitHub Actions, trusted live tests, and npm
212-
publication are separate evidence layers; one must not be represented as
210+
The repository is in Public Preview. Blocking CI, protected repository rules,
211+
security reporting, protected environments, and the authorized live smoke have
212+
passed. The first Registry Alpha remains a separate release gate; mocked
213+
responses, packed artifacts, GitHub Actions, trusted live tests, and npm
214+
publication are separate evidence layers and must not be represented as
213215
another.
214216
215217
See:
216218
217219
- [Canonical repository](https://github.com/cometapi-dev/cometapi-node)
218220
- Support and conduct: `support@cometapi.com`
219-
- [Private vulnerability reporting](https://github.com/cometapi-dev/cometapi-node/security/advisories/new), activated during Public Preview
221+
- [Private vulnerability reporting](https://github.com/cometapi-dev/cometapi-node/security/advisories/new), enabled for Public Preview
220222
- [COMPATIBILITY.md](./COMPATIBILITY.md) for the supported protocol matrix
221223
- [ARCHITECTURE.md](./ARCHITECTURE.md) for design constraints
222224
- [CONTRIBUTING.md](./CONTRIBUTING.md) for contributor checks

ROADMAP.md

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

3-
Status: Public Preview pre-visibility complete; visibility change awaiting explicit authorization
4-
Last updated: 2026-07-23
3+
Status: Public Preview complete; Registry Alpha awaits separate authorization
4+
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.
77

@@ -11,27 +11,26 @@ The TypeScript and Node.js SDK will provide a typed CometAPI entry point that
1111
preserves the official OpenAI JavaScript client experience while shipping a
1212
small, auditable package for supported Node.js LTS runtimes.
1313

14-
Private Remote Validation and Public Preview pre-visibility preparation are
15-
complete for the sanitized private repository. The repository remains private
16-
at the visibility authorization gate. Public Preview is not ready until the
17-
visibility transition and all public-only controls and live evidence pass under
18-
separate explicit authorization. The functional `0.1.0-alpha.1` prerelease
14+
Private Remote Validation and Public Preview are complete for the sanitized
15+
repository. The repository is public with blocking CI, protected repository and
16+
tag rules, Private Vulnerability Reporting, protected environments, and
17+
authorized live-smoke evidence. The functional `0.1.0-alpha.1` prerelease
1918
remains a separate evidence gate after Public Preview. Registry publication
2019
proceeds only through Private Remote Validation, Public Preview, Registry Alpha,
2120
and stable 0.1.0 stages.
2221

2322
## Milestones
2423

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

3635
## Repository Foundation
3736

@@ -115,9 +114,15 @@ visibility or publish to a private or public registry.
115114

116115
## Public Preview
117116

118-
Changing the repository to public begins a short configuration interval; it
119-
does not establish Public Preview readiness by itself. The preview is ready
120-
only when:
117+
Public Preview is complete. The repository visibility transition and public-only
118+
configuration were followed by successful default-branch verification and an
119+
authorized protected live smoke. Evidence for the final pre-documentation
120+
commit is recorded in the corresponding GitHub Actions runs:
121+
122+
- [Main CI run 30246345118](https://github.com/cometapi-dev/cometapi-node/actions/runs/30246345118)
123+
- [Live smoke run 30246431866](https://github.com/cometapi-dev/cometapi-node/actions/runs/30246431866)
124+
125+
The readiness criteria remain:
121126

122127
- The README describes real 0.1 scope and clearly labels the repository as a
123128
pre-release project.

SECURITY.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -17,10 +17,8 @@ issue.
1717

1818
The canonical confidential reporting URL is
1919
<https://github.com/cometapi-dev/cometapi-node/security/advisories/new>.
20-
Private Vulnerability Reporting is activated during Public Preview, after
21-
Private Remote Validation. Until it is active, contact `support@cometapi.com`
22-
to arrange confidential reporting. Do not make the repository public without a
23-
working confidential reporting path.
20+
Private Vulnerability Reporting is enabled for Public Preview. Contact
21+
`support@cometapi.com` if the reporting URL is unavailable.
2422

2523
Include:
2624

0 commit comments

Comments
 (0)