Skip to content

Commit d492c3f

Browse files
committed
Add TurtleTerm release status tracker
1 parent 855a987 commit d492c3f

1 file changed

Lines changed: 78 additions & 0 deletions

File tree

docs/sourceos/RELEASE_STATUS.md

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
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

Comments
 (0)