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

2.5 KiB
Raw Blame History

AdvisoryAI Chat CLI (stella advise ask)

Module

Cli

Status

VERIFIED

Description

Interactive AI chat queries from the terminal scoped to specific container images, digests, or environments for security advisory assistance.

Implementation Details

  • Command Group: src/Cli/StellaOps.Cli/Commands/Advise/AdviseChatCommandGroup.cs -- AdviseChatCommandGroup (internal static class)
  • Chat Renderer: src/Cli/StellaOps.Cli/Commands/Advise/ChatRenderer.cs -- terminal rendering for chat responses
  • Chat Service: src/Cli/StellaOps.Cli/Services/Chat/ -- backend chat client and models
  • Chat Models: src/Cli/StellaOps.Cli/Services/Models/Chat/ -- request/response DTOs
  • Commands:
    • stella advise ask <query> -- ask the advisory AI assistant a question. Options: --image|-i <ref> (scope to container image), --digest|-d <digest> (scope to artifact digest), --environment|-e <env> (scope to environment)
    • stella advise chat-doctor -- diagnose advisory AI connectivity and configuration
    • stella advise chat-settings -- view/update chat configuration
  • Configuration: src/Cli/StellaOps.Cli/Configuration/StellaOpsCliOptions.cs -- CLI options including advisory AI endpoint settings

E2E Test Plan

  • Run stella advise ask "What CVEs affect this image?" and verify a response is returned
  • Run stella advise ask "Is CVE-2024-1234 reachable?" --image myregistry/app:v1.0 and verify image-scoped response
  • Run stella advise ask "Show risk summary" --digest sha256:abc123 and verify digest-scoped response
  • Run stella advise ask "What's the risk?" --environment production and verify environment-scoped response
  • Run stella advise chat-doctor and verify connectivity/configuration diagnostics
  • Run stella advise chat-settings and verify settings are displayed
  • Verify error handling when advisory AI service is unavailable
  • Verify --verbose flag shows additional request/response details

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/advisoryai-chat-cli/run-001/tier2-integration-check.json