Files
git.stella-ops.org/docs/features/checked/cli/cli-export-profile-and-run-management.md
2026-02-14 09:11:48 +02:00

2.4 KiB

CLI Export Profile and Run Management

Module

Cli

Status

VERIFIED

Description

CLI commands for managing export profiles, triggering export runs, downloading artifacts with hash verification, and scheduling evidence/attestation exports with selectors and callbacks.

Implementation Details

  • Command Group: src/Cli/StellaOps.Cli/Commands/ExportCommandGroup.cs -- ExportCommandGroup for stella export commands
  • Export Configuration: src/Cli/StellaOps.Cli/Export/ -- export profile configuration and management
  • Command Handlers: src/Cli/StellaOps.Cli/Commands/CommandHandlers.ExportCache.cs -- export cache handlers
  • Sprint: SPRINT_0202_0001_0001_cli_ii
  • Commands:
    • stella export profile list -- list configured export profiles
    • stella export profile create -- create a new export profile with selectors
    • stella export run <profile> -- trigger an export run
    • stella export download <run-id> -- download exported artifacts with hash verification
    • stella export schedule <profile> -- schedule recurring exports
  • Services: src/Cli/StellaOps.Cli/Services/PackClient.cs / IPackClient.cs -- evidence pack management

E2E Test Plan

  • Run stella export profile list and verify export profiles displayed
  • Run stella export profile create --name "nightly" --selector "env:production" and verify profile created
  • Run stella export run nightly and verify export run triggered with progress output
  • Run stella export download <run-id> --output ./export/ and verify artifacts downloaded with hash verification
  • Run stella export schedule nightly --cron "0 2 * * *" and verify schedule configured
  • Verify hash verification fails when artifact is tampered
  • Verify callback URL is invoked on export completion when configured
  • Verify --format json provides structured 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, 238 tests pass in StellaOps.Cli.Formatting.Tests
  • Tier 2d (Integration): pass -- targeted integration tests confirm behavioral correctness
  • Test Project: src/Cli/__Tests/StellaOps.Cli.Formatting.Tests/StellaOps.Cli.Formatting.Tests.csproj
  • Evidence: docs/qa/feature-checks/runs/cli/cli-export-profile-and-run-management/run-001/tier2-integration-check.json