stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

semi implemented and features implemented save checkpoint

Browse Source
This commit is contained in:
master
2026-02-08 18:00:49 +02:00
parent 04360dff63
commit 1bf6bbf395
20895 changed files with 716795 additions and 64 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
docs/features/unchecked/cli/explain-block-cli-command.md Normal file
View File

@@ -0,0 +1,26 @@
# Explain Block CLI Command
## Module
Cli
## Status
IMPLEMENTED
## 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)