Phase 8C.1: External beta readiness - #56
Merged
Merged
Conversation
There was a problem hiding this comment.
🟢 Approval recommended
Changes are scoped to documentation/templates/scripts and a deterministic CI smoke check with no product-runtime behavior modifications.
Pull request overview
Adds an “external beta readiness” documentation + CI smoke layer that codifies the external-beta contract, the single provider-free golden journey, and the feedback/qualification artifacts, then enforces their presence and key safety constraints in CI.
Changes:
- Introduces an
smoke:external-betacheck that validates the external beta contract, qualification template, feedback form, and related doc links/safety guidance. - Adds a macOS-only fixture generator plus a checked-in spoken script for deterministic qualification runs.
- Aligns creator-facing docs (README/INSTALL/FIRST_EXPORT) and CI documentation/workflow wiring to reference the external beta contract and feedback path.
File summaries
| File | Description |
|---|---|
| scripts/smoke-external-beta.js | New smoke check that validates external-beta docs/forms and safety constraints. |
| scripts/generate-beta-fixture.js | New macOS-only script to generate a deterministic spoken WAV fixture. |
| README.md | Adds external-beta links and clarifies release authority + signing/notarization limits. |
| package.json | Wires new smoke:external-beta and beta:fixture scripts. |
| docs/INSTALL.md | Reframes install guidance for external beta and links to beta contract/qualification. |
| docs/fixtures/external-beta-spoken.txt | Adds a short deterministic spoken script for fixture generation. |
| docs/FIRST_EXPORT.md | Links to external beta contract/qualification and adds redacted-support-report guidance. |
| docs/EXTERNAL_BETA.md | Adds the durable external-beta contract + golden journey + exit signals. |
| docs/CI.md | Documents the new external-beta smoke as part of CI checks. |
| docs/BETA_QUALIFICATION.md | Adds a manually aggregable qualification record template and severity contract. |
| .github/workflows/ci.yml | Runs the new smoke:external-beta check in CI. |
| .github/ISSUE_TEMPLATE/beta_feedback.yml | Adds a focused beta feedback issue form with redaction + secrets guidance. |
Review details
- Files reviewed: 12/12 changed files
- Comments generated: 0
- Review effort level: Lite
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
FernandoAbishai
force-pushed
the
codex/phase-8c1-external-beta-readiness
branch
from
September 1, 2026 02:18
14da8b6 to
bfab4c1
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Scope boundary
Documentation, issue-template, fixture-recipe, smoke, package-script, and CI wiring only. No product behavior, release version, tag, artifact, Apple credential, paid service, telemetry, or dependency changes.
Verification
npm run smoke:external-betanpm run smoke:public-releasenpm run smoke:release-notesnpm run smoke:release-identitynpm run smoke:release-metadatanpm run smoke:release-workflownpm run lintnpm run build --prefix frontendnpm run smoke:model-managernpm run smoke:backendpython -m compileall -q backendgit diff --checkThis PR is based on current
mainat4ee8470549b65037d2126a993baebe78a300498f.Do not merge as part of this PR.