# oikos-web

The Oikos control-room client: the Svelte 5 SPA (`web/`), the Wails v3
desktop wrapper (`desktop/`), and the delivery stack that serves it
(`compose/`, `docker-compose.yml`, `scripts/deploy.sh`).

Extracted from [dtoro/oikos](https://git.hubris.network/dtoro/oikos) in
Phase 1 of the hexagonal-architecture refactor
(plans/2026-08-15-hexagonal-architecture.md in that repo). The backend
(API, MCP, scheduler) stays in dtoro/oikos — this repo talks to it over
REST/SSE only.

## Layout

```
web/                Control-room SPA (Svelte 5, Vite)
desktop/            Wails v3 desktop wrapper (macOS + Linux)
compose/            Dockerfile + Caddyfile for the oikos-web image
cmd/webhook/        Deploy-webhook receiver (Gitea push → deploy)
scripts/deploy.sh   Deploy script (CI-green gate, versioned images)
docker-compose.yml  The single `web` service, publishing 8091:80
```

## Dev

```bash
cd web && OIKOS_API_TOKEN=dev-token npm run dev   # proxies to api :8090/:8092
make desktop                                       # build the desktop app
```

The SPA's first-launch Config screen stores the server URL + token; the
backend version is available via the API ping — the sidebar shows this
repo's VERSION.

## Versioning

Own `VERSION` file with the same rule as oikos: every commit to `main`
bumps it (patch for fixes, minor for features). The version tag is shown
in the SPA sidebar and stamped into desktop builds.

## Deploy

Push to `main` → Gitea webhook → `cmd/webhook` receiver →
`scripts/deploy.sh`: waits for CI green, builds `oikos-web:v$VERSION` from
the working tree, `docker compose up -d`, prunes to the 3 newest tags.
Rollback: `OIKOS_VERSION=v0.x.y docker compose up -d`.

Desktop auto-update reads this repo's Gitea releases. Builds installed
before the extraction point at dtoro/oikos and need one manual reinstall
(see the first release notes).