Files
git.stella-ops.org/docs/features/checked/cli/cli-slice-management-commands.md
2026-02-14 09:11:48 +02:00

2.0 KiB

CLI Slice Management Commands

Module

Cli

Status

VERIFIED

Description

CLI commands for reachability slice lifecycle: query by CVE/symbol, verify DSSE signature with replay, export to offline bundle (OCI layout tar.gz), and import from bundle with integrity verification.

Implementation Details

  • Command Group: src/Cli/StellaOps.Cli/Commands/Slice/ -- slice management commands
  • Commands:
    • stella slice query --cve <cve> -- query slices by CVE
    • stella slice query --symbol <symbol> -- query slices by symbol
    • stella slice verify <slice-id> -- verify DSSE signature and replay integrity
    • stella slice export <slice-id> --output <path> -- export to OCI layout tar.gz offline bundle
    • stella slice import <bundle-path> -- import from bundle with integrity verification
  • OCI Integration: Exports use OCI layout format for registry compatibility

E2E Test Plan

  • Run stella slice query --cve CVE-2024-1234 and verify matching slices returned
  • Run stella slice query --symbol "org.example.Class.method" and verify symbol-based query
  • Run stella slice verify <id> and verify DSSE signature validation
  • Run stella slice export <id> --output ./slice-bundle.tar.gz and verify OCI layout tar.gz
  • Run stella slice import ./slice-bundle.tar.gz and verify import with integrity check
  • Verify import fails for tampered bundles
  • Verify deterministic replay after import matches original

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-slice-management-commands/run-001/tier2-integration-check.json