40 lines
2.1 KiB
Markdown
40 lines
2.1 KiB
Markdown
# 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`
|