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