git.stella-ops.org/docs-archived/implplan/SPRINT_20260117_022_CLI_registry.md

Sprint 022 - Registry CLI

Topic & Scope

• Surface OCI registry authentication and token capabilities via CLI
• Add login, token management, and registry operations commands
• Working directory: src/Cli/
• Expected evidence: CLI commands, unit tests
• Note: From FEATURE_GAPS_REPORT.md Batch 14 (Auth & Access Control)

Dependencies & Concurrency

• No upstream sprint dependencies
• Can run in parallel with other CLI sprints
• Depends on Registry service

Documentation Prerequisites

• docs/modules/registry/architecture.md
• docs/FEATURE_GAPS_REPORT.md (Batch 14)
• OCI Distribution Spec, Docker Registry Auth

Delivery Tracker

REG-001 - Add stella registry login command

Status: DONE Dependency: none Owners: Developer

Task description:

• Create RegistryCommandGroup.cs with login subcommand
• Authenticate to OCI registry and store credentials
• Support multiple authentication methods

Completion criteria:

• stella registry login <registry-url> authenticates
• Supports --username and --password options
• Supports --password-stdin for secure input
• Supports --token for token-based auth
• Stores credentials in secure credential store
• Supports Docker config.json format

REG-002 - Add stella registry logout command

Status: DONE Dependency: REG-001 Owners: Developer

Task description:

• Add logout subcommand for credential removal
• Remove stored credentials for registry
• Support selective or all logout

Completion criteria:

• stella registry logout <registry-url> removes credentials
• stella registry logout --all removes all credentials
• Confirms credential removal
• Updates credential store

REG-003 - Add stella registry token command

Status: DONE Dependency: REG-001 Owners: Developer

Task description:

• Add token subcommand for token operations
• Generate tokens with specific scopes
• Inspect and validate tokens

Completion criteria:

• stella registry token generate --scope <scope> generates token
• Scopes: pull, push, catalog, admin
• Supports --expires <duration> for token lifetime
• stella registry token inspect <token> shows token details
• stella registry token validate <token> validates token
• Supports --format json

REG-004 - Add stella registry list command

Status: DONE Dependency: REG-001 Owners: Developer

Task description:

• Add list subcommand for repository listing
• List repositories in registry
• Support filtering and pagination

Completion criteria:

• stella registry list <registry-url> lists repositories
• Supports --filter <pattern> for filtering
• Supports --limit N for pagination
• Output includes repository name, tag count
• Supports --format json|table

REG-005 - Add stella registry tags command

Status: DONE Dependency: REG-001 Owners: Developer

Task description:

• Add tags subcommand for tag listing
• List tags for a repository
• Include digest information

Completion criteria:

• stella registry tags <repository> lists tags
• Output includes tag name, digest, created date
• Supports --filter <pattern> for filtering
• Supports --format json|table

REG-006 - Add stella registry delete command

Status: DONE Dependency: REG-001 Owners: Developer

Task description:

• Add delete subcommand for manifest/tag deletion
• Delete tags or manifests from registry
• Include safety confirmation

Completion criteria:

• stella registry delete <repository>:<tag> deletes tag
• stella registry delete <repository>@<digest> deletes manifest
• Requires --confirm for safety
• Supports --dry-run for preview
• Returns deletion status

Execution Log

Date (UTC)	Update	Owner
2026-01-17	Sprint created from FEATURE_GAPS_REPORT.md Batch 14	Planning
2026-01-16	REG-001 through REG-006: Created RegistryCommandGroup.cs with all commands	Developer

Decisions & Risks

• Credential storage must be secure (keychain, credential manager)
• Token generation requires appropriate permissions
• Delete operations are destructive; need strong confirmation

Next Checkpoints

• Sprint kickoff: TBD
• Mid-sprint review: TBD
• Sprint completion: TBD