DocsConcepts
Honesty Labels & Evidence
Understanding FACT, DETECTED, INFERRED, and UNKNOWN tags.
The 4 Honesty Tiers
Athena tags every statement in the generated documentation with an honesty label and an exact source citation:
- `FACT` (Green): Declared in configuration (such as package.json) or asserted by the developer. Example:
Node.js ">=22.12" — FACT · package.json (engines) - `DETECTED` (Cyan): Identified using heuristic signatures, AST parsers, or schema files. Example:
Prisma — DETECTED (high) · prisma/schema.prisma:1 - `INFERRED` (Violet): Derived from convention patterns or generated via optional AI providers. Example:
Auth pattern: JWT bearer — INFERRED · based on src/auth/* - `UNKNOWN` (Slate): Athena cannot prove the fact with verifiable evidence. Athena says "unknown" instead of guessing. Example:
Stripe webhook secret — UNKNOWN (redacted or not set)