Explain Block CLI Command

Module

Cli

Status

VERIFIED

Description

CLI command stella explain block <digest> that provides a complete "why is this blocked?" explanation with evidence linking, policy rule identification, and deterministic output formatting for audit trails.

Implementation Details

Command Group: src/Cli/StellaOps.Cli/Commands/ExplainCommandGroup.cs -- ExplainCommandGroup for stella explain commands
Verdict Rationale: src/Cli/StellaOps.Cli/Commands/CommandHandlers.VerdictRationale.cs -- verdict rationale handlers
Rationale Client: src/Cli/StellaOps.Cli/Services/RationaleClient.cs / IRationaleClient.cs -- rationale API client
Commands:
- stella explain block <digest> -- explain why an artifact is blocked. Options: --format text|json, --verbose
Output includes: blocking policy rule, triggering findings, evidence links, remediation suggestions

E2E Test Plan

Run stella explain block sha256:abc123 and verify block explanation with policy rule identification
Verify evidence links are included in the explanation
Verify --format json produces structured explanation with policy, findings, evidence
Verify --verbose shows additional rule evaluation details
Verify deterministic output (same digest produces identical explanation)
Verify error handling for non-blocked artifacts (shows "not blocked" message)

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/explain-block-cli-command/run-001/tier2-integration-check.json

1.9 KiB Raw Blame History