save checkpoint
This commit is contained in:
33
docs/features/checked/cli/resource-oriented-cli-hierarchy.md
Normal file
33
docs/features/checked/cli/resource-oriented-cli-hierarchy.md
Normal file
@@ -0,0 +1,33 @@
|
||||
# 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`
|
||||
Reference in New Issue
Block a user