stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
08006100a5b609e53d9b3ff01aa12a180bc3d360
git.stella-ops.org/docs/features/checked/cli/cli-reachability-upload-and-explain-commands.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.2 KiB
Raw Blame History

CLI Reachability Upload and Explain Commands

Module

Cli

Status

VERIFIED

Description

Commands for uploading call graphs (stella reachability upload-callgraph) and querying reachability status with explanation (stella reachability list/explain), with streaming upload and pagination support.

Implementation Details

  • Command Group: src/Cli/StellaOps.Cli/Commands/ReachabilityCommandGroup.cs -- reachability commands
  • ReachGraph Commands: src/Cli/StellaOps.Cli/Commands/ReachGraph/ReachGraphCommandGroup.cs -- graph operations
  • ReachGraph Handlers: src/Cli/StellaOps.Cli/Commands/ReachGraph/ReachGraphCommandHandlers.cs -- upload and query handlers
  • Commands:
    • stella reachability upload-callgraph <file> -- upload call graph with streaming support. Options: --digest <digest>, --format <format>
    • stella reachability list -- list reachability results with pagination. Options: --scan <id>, --status reachable|unreachable|unknown, --limit, --offset
    • stella reachability explain <cve> -- explain reachability determination for a CVE with evidence chain

E2E Test Plan

  • Run stella reachability upload-callgraph ./callgraph.json --digest sha256:abc123 and verify upload success
  • Verify streaming upload for large call graphs
  • Run stella reachability list --scan <id> and verify reachability results displayed
  • Run stella reachability list --status reachable and verify filtering
  • Run stella reachability explain CVE-2024-1234 and verify explanation with evidence chain
  • Verify pagination with --limit and --offset
  • Verify --format json output for automation

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-upload-and-explain-commands/run-001/tier2-integration-check.json