new advisories work and features gaps work

docs/technical/reviews/cli-command-name-sweep-2026-01-14.md

@@ -0,0 +1,143 @@
+# 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
+
+```powershell
+# 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