Feature Health - Production Smoke Tests

Real-time verification of search, chat, and system integrity.

Endpoint

GET /v1/feature-health

Run all feature tests and return a full report.

GET /v1/feature-health/:feature

Run tests for a single feature (e.g. /v1/feature-health/search).

What it tests

Feature	What it validates
`health`	API responds with `status: ok`
`search`	Product listing returns results, access control enforced, results include score and paragraph text
`chat`	Query validation (400 on empty/oversized), product scoping, response streaming
`transparency`	EU AI Act Article 52 disclosure present
`rate-limiting`	Tier enforcement, daily counter, 429 on limit exceeded

How to read the report

verdict: "PASS" - test passed
verdict: "FAIL" - test failed, check the evidence field for details
evidence - human-readable proof string
duration_ms - per-test latency

HTTP status codes: 200 = all tests passed. 207 = some tests failed.

curl example

curl "https://pauhu.eu/v1/feature-health"

Response example

{
  "timestamp": "2026-03-11T10:00:00Z",
  "duration_ms": 2450,
  "total": 42,
  "passed": 40,
  "failed": 2,
  "results": [
    {
      "feature": "search",
      "case": "eurlex-returns-results",
      "invariant": "Search eurlex returns ≥1 match with score",
      "verdict": "PASS",
      "evidence": "matches=8",
      "duration_ms": 450
    }
  ]
}

Using in CI/CD

Fail a build if any health check reports a failure:

# Fail build if any health check fails
HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" https://pauhu.eu/v1/feature-health)
if [ "$HTTP_CODE" != "200" ]; then echo "Health check failed"; exit 1; fi

Support

Technical: support@pauhu.eu

API keys: Get an API key

Full documentation: Documentation index