52 lines
3.1 KiB
Markdown
52 lines
3.1 KiB
Markdown
# Installation review
|
|
|
|
Two independent reviewers examined installation conventions and stable OpenCode
|
|
compatibility. Both agreed that removing the V2 gate alone would hide real API
|
|
incompatibility rather than fix it.
|
|
|
|
## Findings addressed
|
|
|
|
- Installation mixed binary building with Docker provisioning, provider login,
|
|
private npm installation, service registration, and startup. It is now a thin
|
|
standard `go install ./cmd/...` operation, with no runtime checks or side effects.
|
|
- Go's repository import path did not match `go.mod`. The module now matches the
|
|
repository, enabling normal module installation (with `GOPRIVATE` for private access).
|
|
- Generic `server`/`tui` commands required renaming and a custom layout. They are
|
|
now `pipelines-server` and `pipelines-tui`, installed directly by Go.
|
|
- Runtime configuration was guessed relative to the binary, and a saved PATH
|
|
overrode the caller. Standard locations/explicit flags now select data; legacy
|
|
setup requires an explicit `PIPELINES_PREFIX`, and the caller's PATH is preserved.
|
|
- Native stable OpenCode has no equivalent to the V2 CLI/API contract. It now has
|
|
a separate HTTP adapter, using the existing executable/account, strict JSON
|
|
contracts, explicit models, translated scoped permissions, and an owned loopback
|
|
service. The existing V2 adapter is retained rather than pretending APIs match.
|
|
- Crash ownership must include the backend and native service. Additive metadata
|
|
records those references without rewriting immutable definitions or histories.
|
|
- The skill name did not match its directory. It is now `pipelines`. Installation
|
|
installs/updates the global skill; authoring references it directly instead of
|
|
preloading instructions or making preliminary session/API calls.
|
|
- Ownership persistence failure could leak created agent sessions. That failure
|
|
path cleans up its owned session. Authoring no longer pre-creates sessions.
|
|
|
|
## Deliberately removed from default installation
|
|
|
|
Private dependency installs, login prompts, mandatory notifications, automatic
|
|
LAN HTTP exposure, generated system bin symlinks, private binary prefixes, and a
|
|
second background supervisor. Configure optional services separately using normal
|
|
OS tools. The old managed installation helper remains only for explicit legacy
|
|
data/lifecycle access; it is not the standard installer.
|
|
|
|
Optional autostart is a separate explicit `pipelines service enable` step. It
|
|
uses the OS user manager directly, supports a
|
|
side-effect-free preview, and captures only documented environment settings.
|
|
Uninstallation refuses to remove binaries while its autostart definition remains;
|
|
disable the service first. Installation itself still registers or starts nothing.
|
|
|
|
## Verification limitations
|
|
|
|
The reviewer checked official stable OpenCode 1.18.35 in isolation and found V2
|
|
bridge URLs that return HTTP 200 **HTML**. The adapter rejects non-JSON responses.
|
|
No live inference or real model tool-permission enforcement was run. See
|
|
[verification scope](installation-verification.md); do not confuse successful
|
|
installation or stored permission rules with proven model execution.
|