Files
git.stella-ops.org/docs/features/unchecked/cli/resource-oriented-cli-hierarchy.md

1.4 KiB

Resource-Oriented CLI Hierarchy

Module

Cli

Status

IMPLEMENTED

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