save checkpoint

docs/features/checked/cli/cli-reachability-trace-export.md

@@ -0,0 +1,37 @@
+# CLI Reachability Trace Export
+
+## Module
+Cli
+
+## Status
+VERIFIED
+
+## Description
+New stella reachability trace command with flags for scan ID, output format (GraphSON/JSON), runtime-confirmed filtering, minimum score threshold, and deterministic output.
+
+## Implementation Details
+- **Command Group**: `src/Cli/StellaOps.Cli/Commands/ReachabilityCommandGroup.cs` -- `ReachabilityCommandGroup` for reachability commands
+- **ReachGraph Commands**: `src/Cli/StellaOps.Cli/Commands/ReachGraph/ReachGraphCommandGroup.cs` -- reachability graph operations
+- **ReachGraph Handlers**: `src/Cli/StellaOps.Cli/Commands/ReachGraph/ReachGraphCommandHandlers.cs`
+- **Tests**: `src/Cli/__Tests/StellaOps.Cli.Tests/ReachabilityTraceExportCommandTests.cs`
+- **Commands**:
+  - `stella reachability trace --scan <scan-id>` -- export reachability trace. Options: `--format graphson|json`, `--runtime-only` (confirmed only), `--min-score <threshold>`, `--output <path>`
+- **Determinism**: Output is deterministically ordered for reproducible results
+
+## E2E Test Plan
+- [ ] Run `stella reachability trace --scan <id> --format json` and verify JSON trace export
+- [ ] Run `stella reachability trace --scan <id> --format graphson` and verify GraphSON output
+- [ ] Run `stella reachability trace --scan <id> --runtime-only` and verify only runtime-confirmed paths
+- [ ] Run `stella reachability trace --scan <id> --min-score 0.7` and verify score filtering
+- [ ] Verify output is deterministic (same scan produces byte-identical output)
+- [ ] Verify `--output` flag writes to file instead of stdout
+- [ ] Verify error handling for non-existent scan IDs
+
+## 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, 412 tests pass in StellaOps.Cli.Commands.Tests
+- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
+- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Commands.Tests/StellaOps.Cli.Commands.Tests.csproj`
+- **Evidence**: `docs/qa/feature-checks/runs/cli/cli-reachability-trace-export/run-001/tier2-integration-check.json`