# Updating the upstream version Upstream is [PayPerQ/ppq-private-mode-proxy](https://github.com/PayPerQ/ppq-private-mode-proxy), vendored as the `ppq-private-mode-proxy` git submodule and built from its own `Dockerfile`. The package version tracks upstream's `package.json` version, which upstream tags as `v`. ## Determining the upstream version ```bash git -C ppq-private-mode-proxy fetch origin --tags git -C ppq-private-mode-proxy describe --tags HEAD # current pin git -C ppq-private-mode-proxy tag --sort=-v:refname | head # latest released ``` The packaged version lives in `startos/versions/current.ts` (`version: ':'`). ## Applying the bump 1. Advance the submodule: `git -C ppq-private-mode-proxy checkout v` 2. Read the upstream diff (`git -C ppq-private-mode-proxy diff ..`) for anything the package has to follow — new or renamed environment variables, changed endpoints, a changed bind/attestation order (the health check depends on the port being bound only after attestation), or a model catalog change that the docs name. 3. Update `version` in `startos/versions/current.ts` to the new upstream `package.json` version with revision `:0` (bump only the revision for packaging-only changes), and write release notes in every locale. 4. Rebuild and test: `make x86` (or `make arm`), install, verify attestation completes, the Status Page loads, and a `/v1/models` request succeeds.