Files
git.stella-ops.org/docs/features/checked/cli/replay-command-generator-service.md
2026-02-14 09:11:48 +02:00

1.8 KiB

Replay Command Generator Service

Module

Cli

Status

VERIFIED

Description

Backend service that generates copy-ready replay commands for deterministic verdict reproduction. Builds command strings with all necessary hashes (artifact, manifest, feeds, policy) and provides downloadable evidence bundles as ZIP for one-click replay from the UI.

Implementation Details

  • Replay Infrastructure: src/Cli/StellaOps.Cli/Replay/ -- replay command generation
  • Determinism Harness: src/Cli/StellaOps.Cli/Services/DeterminismHarness.cs -- determinism enforcement
  • Commands:
    • stella replay generate <digest> -- generate replay command with all input hashes
    • stella replay bundle <digest> --output <path> -- download evidence bundle as ZIP
  • Output: Copy-ready command string with all hashes pinned for deterministic reproduction

E2E Test Plan

  • Run stella replay generate sha256:abc123 and verify command string output
  • Verify generated command includes artifact hash, manifest hash, feeds hash, policy hash
  • Run the generated command and verify deterministic reproduction
  • Run stella replay bundle sha256:abc123 --output ./replay.zip and verify ZIP created
  • Verify ZIP bundle enables offline replay

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/replay-command-generator-service/run-001/tier2-integration-check.json