Files
pipelines/docs/notes/alpha-readiness.md
T

66 lines
3.8 KiB
Markdown

# Alpha readiness pass — 2026-10-20
## Source changes
- Native macOS/Linux remains the default installer; Docker remains opt-in.
- Native installation now includes the authenticated, dependency-free web client,
Go server and ntfy under one per-user supervisor. Raw API defaults to loopback.
- Native service enable/status/disable select the existing owned installation,
not a separate developer server/database. Existing credentials and valid host
harness defaults are retained; no harness is installed or upgraded.
- Fresh model defaults come from OpenCode's resolved host configuration, not
the installer checkout. If unavailable, model selection happens inside setup;
cancelled/noninteractive incomplete configuration fails before service startup.
- Fresh native installs explicitly enable pipeline authoring. Existing missing or
false roles remain execution-only unless the operator chooses
`./install --allow-authoring`. No live role or definition was changed.
- Five primary generic starters: small code change/review, research/fact-check,
summarize documents, compare options, plan/checklist. All five earlier keys
remain available (eight entries total). Models bind from configured defaults.
- README and tester walkthrough now prioritize native browser setup and explain
separate browser/ntfy channels. Closed-app browser push remains unsupported.
## Evidence
The scratch lifecycle smoke validates all primary drafts, creates a definition
explicitly, checks definition transfer and verifies restart persistence. It does
not call providers or mutate the operator's database.
`web/test/ui-smoke.mjs --scratch` exercised actual catalogue reads and template
validation/publication against a current-source loopback server and scratch
database with explicit authoring enabled. All eight entries were present.
Desktop and 390px captures include create dialog, success and resulting list;
card geometry checks catch clipped stage counts and document overflow.
Captures are in the approved OpenCode temporary
`alpha-template-browser-captures/` directory, not committed private evidence.
Native installer and service tests use isolated prefixes, fake dependencies and
mock launchd/systemd. Docker setup regressions remain separate and opt-in.
A real Node proxy check with scratch-only credentials confirmed anonymous
pages/assets/artifacts and WebSocket upgrades are denied, browser navigation
redirects to sign-in, and successful login issues an HttpOnly session cookie
that permits app assets. No authentication bypass or running backend was used.
Go build/vet, source tests, Python installer tests and browser tests are verification
of source behavior, not proof of a successful operating-system installation.
Final merged checks: `go test -race ./...`, build/vet, 699 web tests, 151 Python
tests (one skipped), shell syntax, clean repository-wide gofmt output, and the
scratch lifecycle smoke passed. Linux amd64 CLI/server and arm64 server
cross-builds passed with CGO disabled. Browser audit and actual scratch-server
template create/list checks passed. These checks did not install the release.
## Release boundaries
No production deployment, service restart, provider login, phone/device test,
or live definition publication was performed. Original histories and branches
were preserved. Native Linux installation, real login autostart, fresh-provider
OAuth and real starter inference still need an operator/tester trial. A Linux
cross-build or systemd mock must not be reported as those checks passing.
Deployment remains the operator's step under `internal/server/AGENTS.md`.
Repository-wide formatting also normalized four pre-existing ignored Go
verification files under `tmp/`; they were retained, not deleted or published.
Those ignored files have no Git diff capture; tracked changes are captured in
the local commits. No ignored diagnostic code was otherwise changed.