save checkpoint

docs/features/checked/cli/advisory-source-management-cli.md

@@ -0,0 +1,43 @@
+# Advisory Source Management CLI (stella sources list/check/enable/disable/status)
+
+## Module
+Cli
+
+## Status
+VERIFIED
+
+## Description
+Manage advisory data sources: list by category (primary/distro/ecosystem/scoring), check connectivity, enable/disable sources, and view detailed source status.
+
+## Implementation Details
+- **Command Group**: `src/Cli/StellaOps.Cli/Commands/Sources/` -- advisory source management commands
+- **Command Handlers**: `src/Cli/StellaOps.Cli/Commands/CommandHandlers.cs` -- partial class with source-related handlers
+- **Config consolidation**: Sources commands are consolidated under `stella config sources` via route mapping in `src/Cli/StellaOps.Cli/cli-routes.json` (old: `sources list` -> new: `config sources list`)
+- **Commands**:
+  - `stella config sources list` -- list advisory sources filtered by category (primary, distro, ecosystem, scoring)
+  - `stella config sources check` -- verify connectivity to configured advisory sources
+  - `stella config sources enable <source>` -- enable a specific advisory source
+  - `stella config sources disable <source>` -- disable a specific advisory source
+  - `stella config sources status` -- show detailed status for all configured sources
+- **Config Group**: `src/Cli/StellaOps.Cli/Commands/ConfigCommandGroup.cs` -- `ConfigCommandGroup` hosts the sources subcommand
+- **Config Catalog**: `src/Cli/StellaOps.Cli/Commands/ConfigCatalog.cs` -- catalog of configuration items including sources
+
+## E2E Test Plan
+- [ ] Run `stella config sources list` and verify sources listed with name, category, enabled status
+- [ ] Run `stella config sources list --category distro` and verify only distro sources shown
+- [ ] Run `stella config sources check` and verify connectivity status for each source
+- [ ] Run `stella config sources enable nvd` and verify source is enabled
+- [ ] Run `stella config sources disable nvd` and verify source is disabled
+- [ ] Run `stella config sources status` and verify detailed status including last sync, error counts
+- [ ] Verify deprecated alias `stella sources list` still works and shows deprecation warning
+- [ ] Run with `--format json` and verify valid JSON output
+- [ ] Verify exit code is non-zero when connectivity check fails
+
+## 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/advisory-source-management-cli/run-001/tier2-integration-check.json`