stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
4bdc298ec1fc821ee0d9dda6d2d4643dcedf6b35
git.stella-ops.org/docs/features/unchecked/cli/advisory-source-management-cli.md

2.2 KiB
Raw Blame History

Advisory Source Management CLI (stella sources list/check/enable/disable/status)

Module

Cli

Status

IMPLEMENTED

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