41 lines
2.1 KiB
Markdown
41 lines
2.1 KiB
Markdown
# CLI Parity (stella advise)
|
|
|
|
## Module
|
|
Cli
|
|
|
|
## Status
|
|
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
|
|
|
|
## Related Documentation
|
|
- Advise chat commands: `src/Cli/StellaOps.Cli/Commands/Advise/AdviseChatCommandGroup.cs`
|
|
- Chat services: `src/Cli/StellaOps.Cli/Services/Chat/`
|