Files
git.stella-ops.org/docs/features/checked/cli/resource-oriented-cli-hierarchy.md
2026-02-14 09:11:48 +02:00

1.9 KiB

Resource-Oriented CLI Hierarchy

Module

Cli

Status

VERIFIED

Description

Reduction of 81+ top-level CLI commands to a resource-oriented hierarchy with ~18 top-level groups (scan, release, verify, attest, evidence, policy, vex, reachability, sbom, crypto, config, auth, admin, ci, setup, explain, tools). A FullConsolidationTests test suite validates the entire consolidation.

Implementation Details

  • Command Factory: src/Cli/StellaOps.Cli/Commands/CommandFactory.cs -- builds resource-oriented hierarchy
  • Infrastructure: src/Cli/StellaOps.Cli/Infrastructure/ -- command router and resolution
  • Route Mapping: src/Cli/StellaOps.Cli/cli-routes.json -- 60+ route mappings for backward compatibility
  • Tests: src/Cli/__Tests/StellaOps.Cli.Tests/Integration/FullConsolidationTests.cs -- validates entire consolidation
  • Top-level groups: scan, release, verify, attest, evidence, policy, vex, reachability, sbom, crypto, config, auth, admin, ci, setup, explain, tools, doctor

E2E Test Plan

  • Run stella --help and verify ~18 top-level groups listed (not 81+)
  • Verify each top-level group contains appropriate subcommands
  • Run FullConsolidationTests and verify all consolidation mappings valid
  • Verify old command paths still work via backward-compatible aliases
  • Verify help text shows clear resource-oriented hierarchy

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, 193 tests pass in StellaOps.Cli.Core.Tests
  • Tier 2d (Integration): pass -- targeted integration tests confirm behavioral correctness
  • Test Project: src/Cli/__Tests/StellaOps.Cli.Core.Tests/StellaOps.Cli.Core.Tests.csproj
  • Evidence: docs/qa/feature-checks/runs/cli/resource-oriented-cli-hierarchy/run-001/tier2-integration-check.json