# CLI Implementation Plan

## Purpose
Provide a concise, living plan for CLI feature delivery, determinism, parity, and offline workflows.

## Active work
- `docs/implplan/SPRINT_20260112_004_CLI_reachability_trace_export.md`
- `docs/implplan/SPRINT_20260112_006_CLI_binaryindex_ops_cli.md`
- `docs/implplan/SPRINT_20260112_010_CLI_ai_code_guard_command.md`
- `docs/implplan/SPRINT_20260112_010_CLI_unknowns_grey_queue_cli.md`
- `docs/implplan/SPRINT_20260112_011_CLI_evidence_card_remediate_cli.md`
- `docs/implplan/SPRINT_20260112_014_CLI_determinization_config_viewer.md`
- `docs/implplan/SPRINT_20260112_014_CLI_witness_commands.md`

## Near-term deliverables
- Witness commands: list/show/verify/export with DSSE status and deterministic output.
- Reachability trace export in JSON and SARIF formats.
- Unknowns queue and determinization config viewer commands with stable sorting.
- Evidence card remediate workflows and AI code guard command.
- Updated docs and CLI fixtures covering new commands.

## Dependencies
- Authority for auth flows and DPoP.
- Scanner, Policy, and Attestor APIs for data and verification.
- Offline kit bundles and trust roots for verification.
- Deterministic output contract in `docs/modules/cli/contracts/output-determinism.md`.

## Evidence of completion
- Command handlers updated under `src/Cli/StellaOps.Cli/Commands`.
- Backend client updates in `src/Cli/StellaOps.Cli/Services`.
- CLI tests and golden fixtures updated under `src/Cli/__Tests/StellaOps.Cli.Tests`.
- Command documentation updated under `docs/modules/cli/guides/commands`.

## Reference docs
- `docs/modules/cli/README.md`
- `docs/modules/cli/architecture.md`
- `docs/modules/cli/contracts/output-determinism.md`
- `docs/modules/cli/contracts/install-integrity.md`
- `docs/modules/cli/guides/cli-reference.md`
- `docs/modules/platform/architecture-overview.md`