Files
git.stella-ops.org/docs/features/unimplemented/cli/cli-parity.md

2.1 KiB

CLI Parity (stella advise)

Module

Cli

Status

PARTIALLY_IMPLEMENTED

Description

The CLI infrastructure is extensive but a dedicated stella advise command with --evidence --no-action flags as described is not explicitly found. However, the stella advise ask command does exist with these flags.

What's Implemented

  • Advise Chat Command Group: src/Cli/StellaOps.Cli/Commands/Advise/AdviseChatCommandGroup.cs -- AdviseChatCommandGroup (internal static class)
    • Implements stella advise ask <query> with options:
      • --image <ref> / --digest <digest> / --environment <env> -- scope the advisory query
      • --no-action (-n) -- suppress proposed actions (read-only mode), default: true
      • --evidence -- include evidence links and citations in response
      • --format table|json|markdown -- output format
      • --output <path> -- write to file
      • --conversation-id <id> -- follow-up queries in same conversation
      • --tenant <id> -- tenant scoping
    • Chat rendering: src/Cli/StellaOps.Cli/Commands/Advise/ChatRenderer.cs
    • Services: src/Cli/StellaOps.Cli/Services/Chat/ -- chat client services
  • Chat sub-commands: chat-doctor and chat-settings subcommands also registered

What's Missing

  • Full parity check: Need to verify all advisory operations available in Web UI are also exposed through CLI
  • Batch advisory queries: No --batch or --file option for processing multiple queries from a file
  • Advisory export: No dedicated stella advise export for exporting advisory conversation history
  • Advisory templates: No --template option for pre-defined query templates

Implementation Plan

  • Audit Web UI advisory features against CLI surface for parity gaps
  • Add batch query support via --file <queries.jsonl> option
  • Add conversation export command stella advise export --conversation-id <id>
  • Add template support if Web UI has pre-built query templates
  • Advise chat commands: src/Cli/StellaOps.Cli/Commands/Advise/AdviseChatCommandGroup.cs
  • Chat services: src/Cli/StellaOps.Cli/Services/Chat/