50 lines
2.6 KiB
Markdown
50 lines
2.6 KiB
Markdown
# CLI Parity (stella advise)
|
|
|
|
## Module
|
|
Cli
|
|
|
|
## Status
|
|
VERIFIED
|
|
|
|
## 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/`
|
|
|
|
## 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, 238 tests pass in StellaOps.Cli.Formatting.Tests
|
|
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
|
|
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Formatting.Tests/StellaOps.Cli.Formatting.Tests.csproj`
|
|
- **Evidence**: `docs/qa/feature-checks/runs/cli/cli-parity/run-001/tier2-integration-check.json`
|