stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

save checkpoint

Browse Source
This commit is contained in:
master
2026-02-14 09:11:48 +02:00
parent 9ca2de05df
commit e9aeadc040
1512 changed files with 30863 additions and 4728 deletions
Download Patch File Download Diff File Expand all files Collapse all files

39
docs/features/checked/cli/image-inspect-cli-command.md Normal file
View File

@@ -0,0 +1,39 @@
# 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`