Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
009d3ec
docs: point at the admin console and how to host it
an1ndra Nov 17, 2026
d56baf6
feat: delegate admin auth to an SSO proxy
an1ndra Nov 17, 2026
7fa8b9b
fix: the proxy-auth startup warning never fired
an1ndra Nov 17, 2026
eb172b4
fix: never write a provider API key into the audit log
an1ndra Nov 17, 2026
cbb8433
feat: email alerts and a way to test them
an1ndra Nov 17, 2026
24ee537
feat: configure alert email from the console
an1ndra Nov 17, 2026
6c82615
build: Dokploy deployment assets and a container health check
an1ndra Nov 17, 2026
fce547b
fix: drop the env_file block from the Dokploy compose
an1ndra Nov 17, 2026
d069a11
deploy: declare the Traefik router for path.hacksubset.com in the com…
an1ndra Nov 17, 2026
c02ca99
fix(health): stop reporting DOWN when no SMTP host is configured
an1ndra Nov 17, 2026
cc722d6
feat(seed): make the example provider/route catalogue opt-out
an1ndra Nov 17, 2026
688210b
fix(security): close three findings from the external pentest
an1ndra Nov 17, 2026
56fb151
fix(security): make the admin limiter safe to use, and close the orig…
an1ndra Nov 17, 2026
1300475
docs(deploy): record the origin exposure and the cf-only middleware
an1ndra Nov 17, 2026
fd0653d
fix(security): remove the API-key oracle, budget key guesses, and nev…
an1ndra Nov 17, 2026
a1ff891
fix(security): flatten the timing oracle on key rejection
an1ndra Nov 17, 2026
97ef8aa
docs(agents): IntelliJ cannot use this wrapper, and how it fails
an1ndra Nov 19, 2026
eae02af
feat(alerts): retry webhook delivery with bounded backoff
an1ndra Nov 20, 2026
3596435
feat(admin): report scopes and subject in /admin/settings
an1ndra Nov 20, 2026
19da5ba
feat(admin): add a bucketed time series to /admin/stats
an1ndra Nov 20, 2026
1517cca
feat(alerts): report a provider whose error rate stays high
an1ndra Nov 20, 2026
5a036ac
feat(ops): ship Prometheus alert rules with the chart
an1ndra Nov 20, 2026
d6b9f3f
test(smoke): authenticate the Prometheus metrics check
an1ndra Nov 20, 2026
ab4479c
fix(alerts): mark the Spring constructor explicit
an1ndra Nov 20, 2026
c19cbc9
docs(alerts): describe the sample gate as a total, not a window
an1ndra Nov 20, 2026
814b803
feat(metrics): export the upstream error class and code
an1ndra Nov 20, 2026
6a4c5d2
feat(alerts): bound the email channel like the webhook
an1ndra Nov 20, 2026
3cb1106
feat(metering): count semantic cache hits from usage records
an1ndra Nov 20, 2026
22fe300
feat(alerts): send a daily spend digest by email
an1ndra Nov 20, 2026
970b6cc
ci(release): scan the image before naming it
an1ndra Nov 20, 2026
40f5676
feat(metering): opt-in Postgres partitioning and an archive slice
an1ndra Nov 20, 2026
3c7aec2
feat(ops): share circuit and in-flight state across replicas
an1ndra Nov 20, 2026
5ffb125
feat(spring-ai): add the path-spring-ai adapter module
an1ndra Nov 20, 2026
ddeee23
feat(providers): native Gemini for AI Studio and Vertex
an1ndra Nov 20, 2026
591d086
ci: move setup-helm to v5.1.0 (node24)
an1ndra Nov 20, 2026
f08beb8
release: v0.2.3
an1ndra Nov 20, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/workflows/canary.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ jobs:
if: steps.gate.outputs.enabled == 'true'
run: |
./mvnw -B -DskipTests package
GATEWAY_ADMIN_TOKEN=canary java -jar target/path-*.jar > /tmp/gateway.log 2>&1 &
GATEWAY_ADMIN_TOKEN=canary java -jar path-gateway/target/path-*.jar > /tmp/gateway.log 2>&1 &
for i in $(seq 1 60); do
curl -sf http://127.0.0.1:8080/actuator/health > /dev/null && break
sleep 1
Expand Down
15 changes: 11 additions & 4 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -38,18 +38,24 @@ jobs:
uses: actions/upload-artifact@cf430e030ddbb5b0abf93d22962f4752f3646cd9 # v7
with:
name: surefire-reports
path: target/surefire-reports/
path: path-gateway/target/surefire-reports/
retention-days: 7

helm:
name: Helm chart
runs-on: ubuntu-26.04
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
- uses: azure/setup-helm@1a275c3b69536ee54be43f2070a358922e12c8d4 # v4
- uses: azure/setup-helm@2f5e7bc67f1f9972ab16657bb795f36d8f04de0e # v5.1.0
with:
version: v3.16.3

- name: Prometheus rules are valid
run: |
docker run --rm -v "$PWD/deploy/prometheus:/rules:ro" \
--entrypoint /bin/promtool prom/prometheus:v3.1.0 \
check rules /rules/path-rules.yml

- name: Lint
run: helm lint deploy/helm/path --set existingSecret=path-credentials

Expand All @@ -58,7 +64,8 @@ jobs:
helm template path deploy/helm/path --set existingSecret=x > /dev/null
helm template path deploy/helm/path --set existingSecret=x \
--set autoscaling.enabled=true --set postgres.enabled=true \
--set valkey.enabled=true --set serviceMonitor.enabled=true > /dev/null
--set valkey.enabled=true --set serviceMonitor.enabled=true \
--set prometheusRule.enabled=true > /dev/null

- name: No credentials are rendered inline
run: |
Expand Down Expand Up @@ -99,7 +106,7 @@ jobs:
GATEWAY_PROMPT_LOGGING=true \
GATEWAY_GUARDRAILS_MODERATION=true \
GATEWAY_SEMANTIC_MODEL=embed-test \
java -jar target/path-*.jar \
java -jar path-gateway/target/path-*.jar \
> /tmp/opencode/gateway.log 2>&1 &
for i in $(seq 1 60); do
if curl -sf http://127.0.0.1:8080/actuator/health > /dev/null; then
Expand Down
39 changes: 28 additions & 11 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -40,17 +40,17 @@ jobs:

# --- supply chain: checksums -------------------------------------------
- name: Collect SBOM
run: cp target/classes/META-INF/sbom/application.cdx.json target/bom.json
run: cp path-gateway/target/classes/META-INF/sbom/application.cdx.json path-gateway/target/bom.json

- name: Write SHA-256 checksums
run: |
cd target
cd path-gateway/target
sha256sum path-*.jar bom.json | sort -k2 > checksums.txt
ls -l path-*.jar bom.json checksums.txt
cat checksums.txt

- name: Verify the checksums we just wrote
run: cd target && sha256sum -c checksums.txt
run: cd path-gateway/target && sha256sum -c checksums.txt

# --- container: build, scan, push --------------------------------------
- name: Set up QEMU
Expand All @@ -64,16 +64,19 @@ jobs:
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}

- name: Build and push container image
# Only an unversioned sha- tag is pushed before the scan. A failed scan then leaves
# nothing a deployment could pull by version, and the version number stays unused for
# the retry. The version tag and latest are created after the gate, by promoting this
# exact digest instead of rebuilding.
- name: Build and push the candidate image
id: image
uses: docker/build-push-action@c3c9e263c25d99ce0380d002d59b67737d91b0dc # v7
with:
context: .
push: true
platforms: linux/amd64,linux/arm64
tags: |
ghcr.io/${{ github.repository }}:${{ github.ref_name }}
ghcr.io/${{ github.repository }}:latest
ghcr.io/${{ github.repository }}:sha-${{ github.sha }}
cache-from: type=gha
cache-to: type=gha,mode=max

Expand All @@ -83,7 +86,7 @@ jobs:
TRIVY_USERNAME: ${{ github.actor }}
TRIVY_PASSWORD: ${{ secrets.GITHUB_TOKEN }}
with:
image-ref: ghcr.io/${{ github.repository }}:${{ github.ref_name }}
image-ref: ghcr.io/${{ github.repository }}:sha-${{ github.sha }}
# CRITICAL blocks the release; HIGH is visible in the scan output but the
# Debian base image rotates packages too often to gate on it.
#
Expand All @@ -96,12 +99,26 @@ jobs:
exit-code: "1"
ignore-unfixed: true

# The scan passed, so the same digest can carry the version. imagetools copies the
# multi-arch manifest; nothing is rebuilt and the digest recorded below is the one
# Trivy scanned.
- name: Promote the scanned digest to the version and latest
run: |
docker buildx imagetools create \
-t "ghcr.io/${{ github.repository }}:${{ github.ref_name }}" \
-t "ghcr.io/${{ github.repository }}:latest" \
"ghcr.io/${{ github.repository }}:sha-${{ github.sha }}"

- name: Record the image digest
run: |
digest="$(docker buildx imagetools inspect \
--format '{{.Manifest.Digest}}' \
"ghcr.io/${{ github.repository }}:${{ github.ref_name }}")"
echo "### Container digest" >> "$GITHUB_STEP_SUMMARY"
echo '```' >> "$GITHUB_STEP_SUMMARY"
echo "ghcr.io/${{ github.repository }}@${{ steps.image.outputs.digest }}" >> "$GITHUB_STEP_SUMMARY"
echo "ghcr.io/${{ github.repository }}@${digest}" >> "$GITHUB_STEP_SUMMARY"
echo '```' >> "$GITHUB_STEP_SUMMARY"
echo "Also kept for traceability: ghcr.io/${{ github.repository }}:sha-${{ github.sha }}"

# --- Maven Central (optional) -------------------------------------------
- name: Publish to Maven Central
Expand Down Expand Up @@ -140,7 +157,7 @@ jobs:
name: ${{ github.ref_name }}
body_path: /tmp/release-notes.md
files: |
target/path-*.jar
target/bom.json
target/checksums.txt
path-gateway/target/path-*.jar
path-gateway/target/bom.json
path-gateway/target/checksums.txt
fail_on_unmatched_files: true
35 changes: 32 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,18 +19,32 @@ dependency: the gateway translates to each provider's native protocol.
# unit + integration tests (85)
./mvnw verify

# full end-to-end suite against a mock upstream (104 checks, no real keys)
# full end-to-end suite against a mock upstream (no real keys)
python3 tools/mock-upstream.py 9099 &
GATEWAY_ADMIN_TOKEN=test-admin java -jar target/path-*.jar &
GATEWAY_ADMIN_TOKEN=test-admin java -jar path-gateway/target/path-*.jar &
python3 tools/smoke_test.py

# run locally
export OPENAI_API_KEY=... ANTHROPIC_API_KEY=... GATEWAY_ADMIN_TOKEN=...
./mvnw spring-boot:run
./mvnw -pl path-gateway spring-boot:run
```

The seeder prints a demo `sk-gw-...` key on the first boot only.

## Modules

`./mvnw` is a Maven reactor, not a single project:

| Module | Artifact | Contents |
|---|---|---|
| `path-gateway/` | `io.github.an1ndra:path` | the gateway jar, the runnable Spring Boot application |
| `path-spring-ai/` | `io.github.an1ndra:path-spring-ai` | a Spring AI `ChatModel`/`EmbeddingModel` over the gateway |

The gateway is the published root artifact and never depends on Spring AI; the adapter is
the only module that knows about it. `./mvnw verify` builds both. The Dockerfile builds only
`-pl path-gateway`, so the image does not carry the adapter's dependencies. `tools/` and
`deploy/` stay at the repository root.

## Layout

```
Expand Down Expand Up @@ -176,6 +190,12 @@ a smoke check. Never claim a fix without running both.
`v*.*.*` tag → jar + SBOM + checksums + multi-arch `ghcr.io/an1ndra/path`. The workflow
publishes `changelog/<tag>.md` verbatim as the release body and fails if the file is
missing or empty (`tools/changelog.py`).
- **The image is scanned before it is published.** The workflow pushes only
`ghcr.io/<repo>:sha-<commit>`; Trivy gates that tag; only then does
`docker buildx imagetools create` copy the same digest to `<tag>` and `latest`. A failed
scan therefore leaves a `sha-` tag and an unused version number, not a released image.
The digest in the workflow summary is the one that was scanned. Do not move the version
tag back into the build step.

## Issue labels

Expand All @@ -202,6 +222,15 @@ is a guess, not a commitment — re-tag when reality disagrees.

## Gotchas

- **IntelliJ: point Maven home at a real install, not "Use Maven wrapper".** The wrapper here
is `distributionType=only-script` (no `maven-wrapper.jar`), and IntelliJ's Maven server
resolves its own home instead of running `mvnw`. It then bootstraps Maven without the
plexus artifact bindings and fails with
`Guice/MissingImplementation: No implementation for ArtifactHandlerManager was bound`.
Set Settings -> Build Tools -> Maven -> Maven home to the wrapper's extracted 3.10.1
(`~/.m2/wrapper/dists/apache-maven-3.10.1/<hash>`) or to the IDE's bundled Maven.
The CLI `./mvnw` is unaffected.

- **Flyway owns the schema; `ddl-auto` is `validate`.** Add `V<n>__name.sql` for every
entity change and never edit an applied migration. `V1__baseline.sql` is written in
portable SQL: `bigint generated by default as identity`, `timestamp(6) with time zone`,
Expand Down
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ verbatim as the body of the matching GitHub release.

| Version | Date | Notes |
|---|---|---|
| v0.2.3 | 2026-11-20 | [changelog/v0.2.3.md](changelog/v0.2.3.md) |
| v0.2.2 | 2026-11-17 | [changelog/v0.2.2.md](changelog/v0.2.2.md) |
| v0.2.1 | 2026-11-17 | [changelog/v0.2.1.md](changelog/v0.2.1.md) |
| v0.2.0 | 2026-11-17 | [changelog/v0.2.0.md](changelog/v0.2.0.md) |
Expand Down
22 changes: 19 additions & 3 deletions Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -23,14 +23,24 @@ RUN set -eux; \
mvn -v

COPY pom.xml ./
COPY path-gateway/pom.xml path-gateway/pom.xml
COPY path-spring-ai/pom.xml path-spring-ai/pom.xml
RUN mvn -B -q -DskipTests dependency:go-offline

COPY src/ src/
RUN mvn -B -q -DskipTests package
COPY path-gateway/src/ path-gateway/src/
# The gateway does not depend on the adapter, so the image build skips the Spring AI module.
RUN mvn -B -q -DskipTests -pl path-gateway package

FROM eclipse-temurin:21-jre
WORKDIR /app
COPY --from=build /app/target/path-*.jar app.jar

# curl is here for the container health check below: Dokploy (and Docker) can act on it,
# and it is one small, patched package rather than the whole JDK toolchain.
RUN apt-get update \
&& apt-get install -y --no-install-recommends curl \
&& rm -rf /var/lib/apt/lists/*

COPY --from=build /app/path-gateway/target/path-*.jar app.jar

# Run as an unprivileged user (Trivy DS-0002) and keep ./data writable for the H2 file
# and the generated master key.
Expand All @@ -41,4 +51,10 @@ USER path

ENV PORT=8080
EXPOSE 8080

# Readiness includes drain state: a shutting-down pod reports 503, which is what a rolling
# update should see. Uses the same endpoint the Helm chart probes.
HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
CMD curl -fsS http://127.0.0.1:8080/actuator/health || exit 1

ENTRYPOINT ["java", "-jar", "/app/app.jar"]
6 changes: 5 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ export ANTHROPIC_API_KEY=sk-ant-...
export GROQ_API_KEY=gsk_...
export GATEWAY_ADMIN_TOKEN=pick-something-long

./mvnw spring-boot:run
./mvnw -pl path-gateway spring-boot:run
```

First boot seeds four providers and a starter route table. To also mint a demo key
Expand Down Expand Up @@ -97,13 +97,17 @@ print(client.chat.completions.create(

| Document | Contents |
|---|---|
| [Spring AI adapter](docs/SPRING-AI.md) | `path-spring-ai`: ChatModel and EmbeddingModel over the gateway |
| [API reference](docs/API.md) | Every endpoint, request/response shapes, error codes, idempotency, cache, embeddings |
| [Architecture](docs/ARCHITECTURE.md) | Request flow, providers, routing, what is metered |
| [Configuration](docs/CONFIGURATION.md) | Every environment variable, timeouts, credentials, Postgres |
| [Operations](docs/OPERATIONS.md) | Admin API, metrics, tracing, migrations, alerts, load testing |
| [Limits](docs/LIMITS.md) | Design decisions and known gaps |
| [Testing](docs/TESTING.md) | Unit tests, the 99-check smoke suite, the mock upstream |
| [Why Path](docs/WHY-PATH.md) | Honest comparison and a 60-second demo |
| [SSO and 2FA](docs/SSO.md) | Google/GitHub/enterprise SSO, passkeys and 2FA via an authenticating proxy |
| [Admin UI](docs/ADMIN-UI.md) | The web console lives in `an1ndra/path-admin`; auth, hosting and CORS |
| [Deploy on Dokploy](deploy/dokploy/README.md) | Two apps, compose or plain application, health checks, CORS |
| [Publishing](docs/PUBLISHING.md) | Maven Central setup, signing and the release profile |
| [Roadmap](docs/ROADMAP.md) | Delivered work and the open stories |
| [Changelog](CHANGELOG.md) | Release notes, also used as the GitHub release body |
Expand Down
113 changes: 113 additions & 0 deletions changelog/v0.2.3.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
# v0.2.3

The largest release since v0.1.0: a Spring AI adapter module, native Gemini on AI Studio and
Vertex, a daily digest, shared circuit state for clusters, and the alerting and security
work that had accumulated on `Develop` since v0.2.2.

Everything is additive for existing deployments. Two optional switches are worth a look:
`GATEWAY_SHARED_STATE_BACKEND=valkey` for clusters (see Changed) and the opt-in Postgres
partitioning (see Database).

## Added

### Spring AI adapter

- **`path-spring-ai`**, published as `io.github.an1ndra:path-spring-ai`. A `ChatModel` and
`EmbeddingModel` over the gateway: messages, options, tool definitions and tool responses,
non-streaming tool calls, SSE content streaming, and `Idempotency-Key` when a caller
retries. `X-Path-Cache`, `X-Gateway-Provider` and `X-Gateway-Cost-Usd` land in the
`ChatResponse` metadata; a gateway error surfaces as `PathException` with the status and
the gateway's code. See [`docs/SPRING-AI.md`](docs/SPRING-AI.md).
- The build is now a reactor: `path` (the gateway, unchanged coordinates) and
`path-spring-ai` are sibling modules under a `path-parent` POM. The gateway does not
depend on Spring AI, and the container image still contains only the gateway.

### Providers

- **Native Gemini** for AI Studio and Vertex (`GEMINI` and `VERTEX` provider types) on
`generateContent`. `thinkingConfig` (or `reasoning_effort`) and `safetySettings` are
honoured instead of dropped; thinking tokens are billed as output and broken out as
`reasoning_tokens`; `cachedContentTokenCount` is priced as cache reads. A blocked prompt
is 400 `content_blocked` naming the safety category, and a parameter Gemini cannot honour
is 422 `unsupported_parameter` — the same contract the Anthropic adapter keeps.
- **Vertex credentials**: a service-account JSON in the encrypted credential column, an
RS256 assertion exchanged for a cached OAuth token, and `project`/`location` on the
provider row.

### Metering and reporting

- **Daily digest email** at `GATEWAY_DIGEST_CRON` (default 08:00): yesterday's requests with
the day-over-day delta, spend, tokens with the cache hit ratio, failures with the top
error code, the slowest model's p95, top spend and any parked provider. Silent without a
mail channel; nothing is sent for an empty day. `POST /admin/digest/test` renders it on
demand.
- **Bucketed time series** on `GET /admin/stats?bucket=1h|5m|1m|1d`: per-bucket requests,
cost, failures and p95 latency from one query, zero-filled and capped at 500 points.
Omitting `bucket` returns the previous response unchanged.
- **Archive slice**: `/admin/usage/export` accepts `from`/`to`, so the exact range a
retention purge will delete can be captured for finance.
- **Semantic cache hits are counted from usage rows** (`cache_tier` column) instead of a
process-local counter, so the number survives a restart and matches across replicas.

### Operations

- **Prometheus rules** in `deploy/prometheus/path-rules.yml`: fallback rate, cache hit ratio
against its 7-day average, spend rate, 5xx rate and providers parked for 15 minutes, each
with a `runbook` annotation. The Helm chart renders them with `prometheusRule.enabled`.
- **New metrics**: `path_errors_total{provider,class,code}`, `path_fallbacks_total`,
`path_provider_circuit_open` and `path_alerts_sent_total{channel,outcome}`.
- **Scopes in `/admin/settings`**: `subject` and `scopes` (plus `can_write`) for both token
and proxy auth, so a console can hide write actions instead of discovering a 403.
- **Email alerting**: `GATEWAY_ALERT_EMAIL_TO` plus `SPRING_MAIL_*` sends every alert by
mail; `POST /admin/alerts/test` reports which channels are configured; `GET/PUT
/admin/mail-settings` moves the SMTP settings into the console (password encrypted and
write-only).
- **SSO proxy auth** for the admin API: an authenticating proxy can inject an identity
header instead of a pasted token. Read [`docs/SSO.md`](docs/SSO.md) first — it is only
safe when the gateway is unreachable except through that proxy.
- **Dokploy deployment assets**, including a Traefik router and a container health check.

## Changed

- **Webhook alerts retry** up to three times with jittered exponential backoff, only on 429,
5xx and connect/timeout, honouring `Retry-After`. Both webhook and email run on bounded
queues; a full queue drops and counts instead of blocking the request or growing without
limit.
- **Provider error-rate alert**: a one-minute check over the routing EWMA fires
`provider.error_rate_high` when a provider's rate stays above
`GATEWAY_ALERT_ERROR_RATE` (0.25) with enough samples, and `provider.error_rate_normal`
when it recovers. This catches the provider that fails 30% of the time without ever
tripping the consecutive-failure breaker.
- **Cluster state**: `GATEWAY_SHARED_STATE_BACKEND=valkey` shares circuit-breaker and
in-flight state across replicas. Exactly one replica claims the half-open probe, an OPEN
entry expires even if the replica that opened it dies, and a killed pod's concurrency
permits age out. Memory remains the default and is unchanged.
- **Release images are scanned before they are named.** The workflow pushes only
`sha-<commit>`, scans it, and promotes that digest to the version and `latest` with
`imagetools`; a failed scan no longer burns a version number.
- **Seeding the example catalogue is opt-out** (`GATEWAY_SEED_DEFAULTS=false`) for a real
deployment.
- **CI** runs on `ubuntu-26.04` with `azure/setup-helm` v5.1.0 (Node 24).

## Fixed

- **Security (external pentest):** three findings closed, including a timing oracle on API
key rejection and an admin limiter that could be bypassed via the origin. API-key
guessing is budgeted and rejected responses are never cached, so a wrong key cannot be
turned into a cache oracle.
- **Security:** a provider API key is never written into the audit log; the proxy-auth
startup warning now actually fires.
- Health no longer reports DOWN when no SMTP host is configured.
- The end-to-end suite authenticates its Prometheus check instead of failing with a 401.
- The Dokploy compose no longer uses `env_file`, which broke the deployment.

## Database

- `V19__usage_cache_tier.sql` adds `usage_records.cache_tier` (`exact`, `semantic`, or null).
- `V20__provider_vertex.sql` adds `providers.project` and `providers.location` and widens
`api_key_cipher` to hold a service-account JSON.

Both run automatically on startup. The partitioning script in
[`deploy/postgres/partitions.sql`](deploy/postgres/partitions.sql) is separate and opt-in:
it rewrites `usage_records`, so it is documented as a maintenance-window step after a
`pg_dump`.
Loading
Loading