feat(gateway): tier-detector with fail-fast PG/Valkey/pgvector probes (FED-M1-04) #473

Merged

jason.woltje merged 2 commits from feat/federation-m1-detector into main

2026-04-20 00:07:08 +00:00

Author	SHA1	Message	Date
jarvis	f74fc9687f	docs(federation): mark FED-M1-02 done (PR #471 merged) ci/woodpecker/push/ci Pipeline was successful Details ci/woodpecker/pr/ci Pipeline was successful Details	2026-04-19 19:02:39 -05:00
jarvis	7383380f64	feat(gateway): tier-detector with fail-fast PG/Valkey/pgvector probes (FED-M1-04) Implements `apps/gateway/src/bootstrap/tier-detector.ts` invoked from `main.ts` before NestJS bootstraps. For each tier: - `local`: no-op (PGlite is in-process) - `standalone`: probe Postgres + Valkey - `federated`: probe Postgres + Valkey + pgvector extension; reject config upfront if `queue.type !== 'bullmq'` Each probe has a 5-second hard cap and emits a structured `TierDetectionError` with service / host / port / remediation. The remediation field discriminates pgvector failure modes ("library not available" vs "permission denied") so operators get actionable hints without leaking credentials. Adds `postgres` and `ioredis` as direct gateway deps; previously only transitive. 12 unit tests cover happy paths and each fail-fast branch. Refs #460	2026-04-19 19:02:12 -05:00

Author

SHA1

Message

Date

jarvis

f74fc9687f

docs(federation): mark FED-M1-02 done (PR #471 merged)

ci/woodpecker/push/ci Pipeline was successful

Details

ci/woodpecker/pr/ci Pipeline was successful

Details

2026-04-19 19:02:39 -05:00

jarvis

7383380f64

feat(gateway): tier-detector with fail-fast PG/Valkey/pgvector probes (FED-M1-04)

Implements `apps/gateway/src/bootstrap/tier-detector.ts` invoked from
`main.ts` before NestJS bootstraps. For each tier:

- `local`: no-op (PGlite is in-process)
- `standalone`: probe Postgres + Valkey
- `federated`: probe Postgres + Valkey + pgvector extension; reject
  config upfront if `queue.type !== 'bullmq'`

Each probe has a 5-second hard cap and emits a structured
`TierDetectionError` with service / host / port / remediation. The
remediation field discriminates pgvector failure modes ("library not
available" vs "permission denied") so operators get actionable hints
without leaking credentials.

Adds `postgres` and `ioredis` as direct gateway deps; previously only
transitive. 12 unit tests cover happy paths and each fail-fast branch.

Refs #460

2026-04-19 19:02:12 -05:00