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

2.1 KiB

Image Inspect CLI Command

Module

Cli

Status

VERIFIED

Description

CLI command stella image inspect for querying OCI image metadata including manifest type, architecture platforms, layer digests, annotations, and SBOM/attestation referrers in table or JSON output.

Implementation Details

  • Command Group: src/Cli/StellaOps.Cli/Commands/ImageCommandGroup.cs -- ImageCommandGroup for stella image commands
  • Command Handlers: src/Cli/StellaOps.Cli/Commands/CommandHandlers.Image.cs -- image command handlers
  • OCI Registry Client: src/Cli/StellaOps.Cli/Services/OciRegistryClient.cs / IOciRegistryClient.cs -- OCI registry operations
  • OCI Reference Parser: src/Cli/StellaOps.Cli/Services/OciImageReferenceParser.cs -- parses image references
  • Tests: src/Cli/__Tests/StellaOps.Cli.Tests/GoldenOutput/ImageInspectGoldenOutputTests.cs
  • Commands:
    • stella image inspect <image> -- inspect OCI image metadata. Options: --format table|json, --verbose
    • Shows: manifest type, architecture platforms, layer digests, annotations, referrers (SBOMs, attestations)

E2E Test Plan

  • Run stella image inspect myregistry/app:v1.0 and verify metadata displayed
  • Verify manifest type shown (OCI, Docker)
  • Verify architecture platforms listed (linux/amd64, linux/arm64, etc.)
  • Verify layer digests displayed with sizes
  • Verify annotations shown
  • Verify SBOM/attestation referrers listed
  • Run with --format json and verify structured JSON output
  • Verify golden output tests pass

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/image-inspect-cli-command/run-001/tier2-integration-check.json