stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
0473a5876a87c79d0a9ae87aa450bb866790073a
git.stella-ops.org/docs/features/checked/cli/cli-reachability-trace-export.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.1 KiB
Raw Blame History

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