Files
git.stella-ops.org/docs/features/checked/web/audit-trail-why-am-i-seeing-this.md
2026-02-12 10:27:23 +02:00

2.4 KiB

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).