git.stella-ops.org/docs/technical/reviews/cli-command-name-sweep-2026-01-14.md

CLI Command Name Sweep Report

Date: 2026-01-14 Sprint: SPRINT_20260112_010_DOCS_cli_command_name_sweep Owner: Docs Guild

---

Executive Summary

This report inventories all CLI command references in documentation to confirm the canonical command name (stella) and identify legacy references (stellaops) for cleanup or alias documentation.

Command Pattern	Count	Status
stella <command>	984	Canonical - no action
stellaops <command>	140	Legacy - review needed

---

Classification Summary

Category 1: Replace (CLI Commands)

These are direct CLI command invocations using stellaops that should be updated to stella:

File Path	Line	Context	Recommendation
docs/benchmarks/performance-baselines.md	191-239	Benchmark commands	Replace with stella
docs/benchmarks/smart-diff-wii.md	141	Verify attestation example	Replace with stella
docs/benchmarks/submission-guide.md	144-147	Submission examples	Replace with stella

Estimated count: ~25 references in benchmark docs.

Category 2: Keep (Namespaces/Headers)

These are valid namespace, assembly, or header references that should remain as-is:

Pattern	Context	Recommendation
StellaOps.* namespace	Code namespaces in docs	Keep - matches source code
X-StellaOps-* headers	API authentication headers	Keep - canonical header prefix
stellaops:tenant claim	JWT claim names	Keep - canonical claim name
stellaops.console.*	Payload/event types	Keep - canonical type prefixes

Estimated count: ~100+ references.

Category 3: Ambiguous (Requires CLI Guild Input)

Pattern	Context	Question
URLs with stellaops	gateway.stellaops.local	Is this the canonical domain?
Product name references	"StellaOps Scanner"	Product name vs CLI command

---

File-by-File Inventory (CLI Commands Only)

docs/benchmarks/performance-baselines.md

Line 191: time stellaops scan --image example:latest
Line 195: time stellaops scan --image example:latest --format json
Line 199: /usr/bin/time -v stellaops scan ...
Line 203: perf stat stellaops scan ...
Line 223: time stellaops sbom --image ...
Line 226: stellaops sbom --image ...
Line 234: time stellaops scan --image ...
Line 239: stellaops scan --image ...

Action: Replace stellaops with stella in all commands.

docs/benchmarks/smart-diff-wii.md

Line 141: stellaops verify-attestation ...

Action: Replace with stella verify-attestation.

docs/benchmarks/submission-guide.md

Line 144: 'stellaops scan --image ...'
Line 147: /usr/bin/time -v stellaops ...

Action: Replace with stella.

---

Legacy Alias Policy Recommendation

If stellaops is supported as a shell alias for stella:

1. Document the alias in CLI reference: docs/modules/cli/guides/commands/aliases.md
2. Add a note in examples that stellaops is a legacy alias
3. Prefer stella in all new documentation

If stellaops is NOT supported:

1. Replace all CLI command references with stella
2. Update CI examples and scripts

---

Follow-Up Tasks

Task ID	Description	Owner	Priority
CLISWEEP-REPLACE-001	Replace stellaops CLI commands in benchmark docs	Docs Guild	P2
CLISWEEP-ALIAS-002	Confirm alias policy with CLI Guild	CLI Guild	P1
CLISWEEP-DOC-003	Document alias behavior if supported	Docs Guild	P2
CLISWEEP-VERIFY-004	Verify no broken examples after replacement	QA Guild	P3

---

Methodology

1. Searched docs/**/*.md for pattern stellaops\s+<command> where command is a known CLI verb
2. Excluded namespace/header/claim references (matched by StellaOps.*, X-StellaOps-*, stellaops:*)
3. Counted canonical stella <command> references for comparison
4. Classified each reference by context and owner

---

Appendix: Search Commands Used

# Count stellaops CLI commands
Get-ChildItem -Recurse -Path docs -Include *.md |
  Select-String -Pattern "stellaops\s+(scan|export|verify|...)"

# Count stella CLI commands (canonical)
Get-ChildItem -Recurse -Path docs -Include *.md |
  Select-String -Pattern "stella\s+(scan|export|verify|...)" |
  Where-Object { $_.Line -notmatch "stellaops" }

---

Report Status: Complete Next Review: After CLI Guild alias policy confirmation