# 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`