# 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`