# Audit Trail "Why am I seeing this?" (Reason Capsule)

## Module
Web

## Status
VERIFIED

## Description
Inline per-finding reason capsule that explains why a verdict is shown, including policy/rule provenance and deterministic input references.

## Implementation Details
- **Reason capsule component**:
  - `src/Web/StellaOps.Web/src/app/features/triage/components/reason-capsule/reason-capsule.component.ts`
- **Reason data client (`/api/audit/reasons/:verdictId`) with deterministic fallback**:
  - `src/Web/StellaOps.Web/src/app/core/api/audit-reasons.client.ts`
- **Mounted in findings and triage rows**:
  - `src/Web/StellaOps.Web/src/app/features/findings/findings-list.component.html`
  - `src/Web/StellaOps.Web/src/app/features/triage/components/triage-list/triage-list.component.ts`
- **Focused tests**:
  - `src/Web/StellaOps.Web/src/tests/audit_reason_capsule/reason-capsule.component.spec.ts`
  - `src/Web/StellaOps.Web/src/tests/audit_reason_capsule/audit-reasons.client.spec.ts`
  - `src/Web/StellaOps.Web/src/tests/audit_reason_capsule/findings-list.reason-capsule.spec.ts`

## Verification
- Date: 2026-02-10
- Run artifacts: `docs/qa/feature-checks/runs/web/audit-trail-why-am-i-seeing-this/run-001/`
- Tier results:
  - `tier0-source-check.json`: pass
  - `tier1-build-check.json`: pass
  - `tier2-e2e-check.json`: pass


## Recheck (run-002)
- Date (UTC): 2026-02-10
- Status: VERIFIED (replayed)
- Tier 1 evidence: Angular build passed and checked-web suite passed 145/145.
- Tier 2 evidence: docs/qa/feature-checks/runs/web/audit-trail-why-am-i-seeing-this/run-002/tier2-e2e-check.json.





## Recheck (run-004)
- Date (UTC): 2026-02-10
- Status: VERIFIED (replayed)
- Tier 1 evidence: Angular build passed and checked-web suite passed 145/145 across 47 files.
- Tier 2 evidence: docs/qa/feature-checks/runs/web/audit-trail-why-am-i-seeing-this/run-004/tier2-e2e-check.json.

## Recheck (run-006)
- Date (UTC): 2026-02-11
- Status: VERIFIED (strict Tier 2 UI replay)
- Tier 1 evidence: Targeted audit reason capsule suites passed 8/8 and Web build passed.
- Tier 2 evidence: `docs/qa/feature-checks/runs/web/audit-trail-why-am-i-seeing-this/run-006/tier2-ui-check.json`
- Replay scope:
  - Navigate to `/audit/reasons` and verify reason-capsule workbench rendering.
  - Expand primary reason capsule and verify deterministic policy/rule provenance.
  - Exercise retry/error path (`unavailable -> Retry -> recovered reason details`).