Warning Codes (v0)

• PROJECT_EMPTY — project has no data; suggest explicit L1 expansion
• PARTIAL_DATA — provider returned partial within deadline
• LOW_COVERAGE — entities coverage is below threshold
• PRIVACY_REDACTED — sensitive spans were redacted due to privacy_mode
• EXPANSION_ACTIVATED — provider expanded scope (e.g., L1) due to insufficient data

Notes

• Providers emit warnings[]; ACS forwards or annotates upstream as needed.

Surfacing

• HTTP: X-Warnings: PARTIAL_DATA,LOW_COVERAGE
• Body (optional, non-schema): adapter MAY attach { "warnings": [ { "code": "LOW_COVERAGE", "hint": "entities<0.6" } ] } as extension to top-level (avoid in strict v0)

Example (headers)

X-Warnings: PARTIAL_DATA,LOW_COVERAGE
X-Request-ID: req-123