Skip to content

Commit cea8d3a

Browse files
committed
docs: retain Android support in target policy
1 parent f81ffa1 commit cea8d3a

3 files changed

Lines changed: 23 additions & 13 deletions

File tree

‎.coderabbit.yaml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ reviews:
3131
Review tests for Bun test idioms, deterministic behavior, and meaningful coverage of safety decisions, provider/runtime flows, session events, and TUI command behavior.
3232
- path: "**/*.go"
3333
instructions: |
34-
Do not request Plan 9 or other unsupported GOOS/GOARCH shims. Supported targets are the five release platforms (linux-x64, linux-arm64, macos-arm64, macos-x64, windows-x64). Other GOOS/GOARCH combinations are not a review criterion.
34+
Do not request Plan 9 or other unsupported GOOS/GOARCH shims. The five native prebuilt release targets are linux-x64, linux-arm64, macos-arm64, macos-x64, and windows-x64. Android/Termux is also a supported runtime through the documented android-arm64 source build and Linux artifact fallback. Other GOOS/GOARCH combinations are not a review criterion.
3535
tools:
3636
github-checks:
3737
timeout_ms: 300000

‎AGENTS.md‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -81,12 +81,13 @@ These classes drive multi-round reviews. Fix them before requesting review:
8181
assert raw `t.TempDir()` spellings (`/var` vs `/private/var` on macOS, short
8282
paths on Windows). Prefer one cross-platform function with small `GOOS`
8383
checks over duplicated helpers that drift.
84-
- **Supported targets only:** The five release platforms in CONTRIBUTING.md
85-
(`linux-x64`, `linux-arm64`, `macos-arm64`, `macos-x64`, `windows-x64`) are
86-
the supported set. Other `GOOS`/`GOARCH` combinations, including `plan9`,
87-
are unsupported and are not a review criterion. Do not block a PR for
88-
failing to compile on an unsupported `GOOS`/`GOARCH`. Tests may use `plan9`
89-
as a fixture for "unsupported".
84+
- **Supported targets only:** CONTRIBUTING.md names the five native prebuilt
85+
release artifacts (`linux-x64`, `linux-arm64`, `macos-arm64`, `macos-x64`,
86+
`windows-x64`) and the additional supported Android/Termux source-build and
87+
artifact-fallback path. Other `GOOS`/`GOARCH` combinations, including
88+
`plan9`, are unsupported and are not a review criterion. Do not block a PR
89+
for failing to compile on an unsupported `GOOS`/`GOARCH`. Tests may use
90+
`plan9` as a fixture for "unsupported".
9091
- **Security edges:** Keep secrets out of argv, env dumps, and logs. Redact
9192
success and error paths (including stderr). Fail closed on ownership, lease,
9293
and permission checks. Do not rely on pre-open path resolution

‎CONTRIBUTING.md‎

Lines changed: 15 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -128,19 +128,28 @@ an approved feature.
128128

129129
## Supported platforms
130130

131-
Zero is released for the same five platforms that `scripts/install.sh`,
132-
`scripts/install.ps1`, and the npm wrapper resolve, and that
133-
`.github/workflows/release-artifacts.yml` packages:
131+
Zero publishes five native prebuilt artifacts from
132+
`.github/workflows/release-artifacts.yml`:
134133

135134
- `linux-x64` (`linux/amd64`)
136135
- `linux-arm64` (`linux/arm64`)
137136
- `macos-arm64` (`darwin/arm64`)
138137
- `macos-x64` (`darwin/amd64`)
139138
- `windows-x64` (`windows/amd64`)
140139

141-
Other `GOOS`/`GOARCH` values, including Plan 9, are unsupported. They are not
142-
a review criterion. Do not block a pull request for failing to compile on an
143-
unsupported `GOOS`. Tests may use `plan9` as a fixture for an unsupported OS.
140+
The shell installer and npm wrapper resolve the applicable artifacts from that
141+
list. The PowerShell installer supports the published `windows-x64` artifact;
142+
there is no native Windows ARM64 artifact. Windows on ARM users can run the x64
143+
build under emulation or build from source.
144+
145+
Android/Termux is also supported even though it has no distinct release
146+
artifact. The npm wrapper maps Android to the Linux artifact, and
147+
`docs/INSTALL.md` documents the native `android/arm64` source build needed on
148+
devices whose seccomp policy blocks the Linux build's syscall path.
149+
150+
Other `GOOS`/`GOARCH` values, including Plan 9, are unsupported. They are not a
151+
review criterion. Do not block a pull request for failing to compile on an
152+
unsupported target. Tests may use `plan9` as a fixture for an unsupported OS.
144153

145154
## What We Prioritize
146155

0 commit comments

Comments
 (0)