|
| 1 | +# TurtleTerm Release Status |
| 2 | + |
| 3 | +## Current objective |
| 4 | + |
| 5 | +Make TurtleTerm easy to install and verify on macOS and Linux. |
| 6 | + |
| 7 | +Windows packaging is postponed until the macOS/Linux distribution lane is stable. |
| 8 | + |
| 9 | +## Current public install paths |
| 10 | + |
| 11 | +### Tapless Homebrew HEAD install |
| 12 | + |
| 13 | +```bash |
| 14 | +brew install --HEAD https://raw.githubusercontent.com/SourceOS-Linux/wezterm/main/packaging/homebrew/Formula/turtle-term.rb |
| 15 | +``` |
| 16 | + |
| 17 | +### Future tap install |
| 18 | + |
| 19 | +```bash |
| 20 | +brew install SourceOS-Linux/tap/turtle-term |
| 21 | +``` |
| 22 | + |
| 23 | +Blocked until `SourceOS-Linux/homebrew-tap` exists. |
| 24 | + |
| 25 | +### Future direct artifact install |
| 26 | + |
| 27 | +```bash |
| 28 | +curl -fsSL https://raw.githubusercontent.com/SourceOS-Linux/wezterm/main/packaging/scripts/install-turtle-term.sh | bash |
| 29 | +``` |
| 30 | + |
| 31 | +Blocked until the first `turtle-term-v*` release publishes artifacts. |
| 32 | + |
| 33 | +## Release readiness matrix |
| 34 | + |
| 35 | +| Lane | Status | Notes | |
| 36 | +| --- | --- | --- | |
| 37 | +| TurtleTerm branding | Ready | README, formula, tests, and wrappers use TurtleTerm. | |
| 38 | +| WezTerm attribution | Ready | License and upstream engine attribution preserved. | |
| 39 | +| CLI wrappers | Ready for CI | `turtle-term` and `sourceos-term` both tested. | |
| 40 | +| Tapless Homebrew formula | Ready for CI | Raw formula install path documented. | |
| 41 | +| Public Homebrew tap | Blocked | Requires `SourceOS-Linux/homebrew-tap` repository. | |
| 42 | +| Release tarballs | Ready for CI | Release workflow builds macOS/Linux targets. | |
| 43 | +| Checksums | Ready for CI | Package script emits SHA-256 files. | |
| 44 | +| Manifests | Ready for CI | Package script emits release manifest JSON. | |
| 45 | +| Artifact verification | Ready for CI | Verifier checks archive, checksum, manifest, binaries, profile, docs, license. | |
| 46 | +| SBOM | Ready for CI | Release workflow emits SPDX JSON SBOM. | |
| 47 | +| Attestations | Ready for CI | Release workflow attests artifacts and SBOM. | |
| 48 | +| Bottles | Scaffolded | Tap workflow exists; bottle publication still needs tap CI validation. | |
| 49 | +| Security policy | Ready | `SECURITY.md` added. | |
| 50 | +| Dependency updates | Ready | Dependabot covers GitHub Actions and Cargo weekly. | |
| 51 | +| Windows packaging | Deferred | Candidate lanes: Chocolatey, WinGet, Scoop. | |
| 52 | + |
| 53 | +## Hard blockers |
| 54 | + |
| 55 | +1. `SourceOS-Linux/homebrew-tap` does not exist yet. |
| 56 | +2. GitHub Actions results have not been confirmed green from this assistant session. |
| 57 | +3. No `turtle-term-v*` release tag has been cut yet. |
| 58 | +4. No bottles have been published yet. |
| 59 | + |
| 60 | +## Next publish sequence |
| 61 | + |
| 62 | +1. Confirm CI on `SourceOS-Linux/wezterm` is green. |
| 63 | +2. Create or sync `SourceOS-Linux/homebrew-tap`. |
| 64 | +3. Confirm `brew install --HEAD SourceOS-Linux/tap/turtle-term` works on supported macOS/Linux targets. |
| 65 | +4. Cut `turtle-term-v0.1.0`. |
| 66 | +5. Confirm tarballs, checksums, manifests, SBOMs, and attestations are published. |
| 67 | +6. Promote a stable Homebrew formula from the release tag. |
| 68 | +7. Build and publish Homebrew bottles. |
| 69 | + |
| 70 | +## Definition of world-class v0 |
| 71 | + |
| 72 | +TurtleTerm v0 is world-class enough to publish when a user can install it with one command, verify what was installed, inspect provenance, and run: |
| 73 | + |
| 74 | +```bash |
| 75 | +turtle-term run -- echo turtle-term-ok |
| 76 | +``` |
| 77 | + |
| 78 | +without needing to clone the repo or understand SourceOS internals. |
0 commit comments