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

3.8 KiB

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.