stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
359fafa9da86cf6722ed82bf90d67db9c8f81b17
git.stella-ops.org/docs/features/checked/cli/advisory-source-management-cli.md
master e9aeadc040 save checkpoint
2026-02-14 09:11:48 +02:00

2.7 KiB
Raw Blame History

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