Files
git.stella-ops.org/docs/features/checked/cli/verdict-ladder-ui.md
2026-02-14 09:11:48 +02:00

41 lines
2.7 KiB
Markdown

# Verdict Ladder UI (8-step verdict explainability)
## Module
Cli (with Web frontend)
## Status
VERIFIED
## Description
8-step verdict ladder providing visual explainability for verdict computation stages. Both CLI verdict commands and Angular UI component are implemented.
## Implementation Details
- **Verdict CLI commands**: `src/Cli/StellaOps.Cli/Commands/VerdictCommandGroup.cs` -- `stella verdict verify`, `stella verdict list`, `stella verdict push`, `stella verdict rationale`
- **Compare CLI**: `src/Cli/StellaOps.Cli/Commands/Compare/CompareCommandBuilder.cs` -- `stella compare` with base/target diff
- **Explain CLI**: `src/Cli/StellaOps.Cli/Commands/ExplainCommandGroup.cs` -- `stella explain` for block/decision explanations
- **Score Gate CLI**: `src/Cli/StellaOps.Cli/Commands/ScoreGateCommandGroup.cs` -- score gate with baseline comparison
- **Verdict Ladder Angular component**: `src/Web/StellaOps.Web/src/app/features/triage/components/verdict-ladder/verdict-ladder.component.ts` -- full stepper visualization with `VerdictLadderStep` (step, name, status: complete/partial/missing/na, summary, evidence items), `EvidenceItem` (type, title, source, hash, signed, signedBy, uri, preview), `VerdictLadderData` model
- **Verdict Ladder builder service**: `src/Web/StellaOps.Web/src/app/features/triage/services/verdict-ladder-builder.service.ts` -- builds ladder data from backend evidence
- **Policy explainability library**: `src/Policy/__Libraries/StellaOps.Policy.Explainability/` -- policy decision explainability
- **Policy engine**: `src/Policy/StellaOps.Policy.Engine/` -- verdict computation with deterministic evaluation
## E2E Test Plan
- [ ] Verify verdict ladder renders all 8 steps with correct pass/fail/skip status
- [ ] Verify clicking a ladder step expands to show underlying evidence
- [ ] Verify evidence items show hash, signature status, and source
- [ ] Verify `stella verdict rationale` CLI output matches ladder steps
- [ ] Verify ladder updates when verdict is recomputed
## Related Documentation
- Verdict CLI: `src/Cli/StellaOps.Cli/Commands/VerdictCommandGroup.cs`
- Verdict ladder UI: `src/Web/StellaOps.Web/src/app/features/triage/components/verdict-ladder/`
## Verification
- **Verified**: 2026-02-13T15:30:00Z
- **Tier 0 (Source)**: pass -- all referenced source files exist on disk
- **Tier 1 (Build)**: pass -- module builds cleanly, 238 tests pass in StellaOps.Cli.Formatting.Tests
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Formatting.Tests/StellaOps.Cli.Formatting.Tests.csproj`
- **Evidence**: `docs/qa/feature-checks/runs/cli/verdict-ladder-ui/run-001/tier2-integration-check.json`