Files
git.stella-ops.org/docs/features/unchecked/cli/image-inspect-cli-command.md

1.5 KiB

Image Inspect CLI Command

Module

Cli

Status

IMPLEMENTED

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