Files
git.stella-ops.org/docs/features/checked/binaryindex/binaryindex-ops-cli-commands.md
2026-02-12 10:27:23 +02:00

28 lines
1.8 KiB
Markdown

# BinaryIndex Ops CLI Commands (stella binary ops)
## Module
BinaryIndex
## Status
IMPLEMENTED
## Description
CLI commands for BinaryIndex ops: health, bench, cache, config subcommands with JSON/table output and BinaryIndex base URL configuration. Also adds --semantic flag to deltasig extract/author/match commands.
## Implementation Details
- **Modules**: `src/BinaryIndex/StellaOps.BinaryIndex.WebService/Controllers/`, `src/Cli/`
- **Key Classes**:
- `BinaryIndexOpsController` (`src/BinaryIndex/StellaOps.BinaryIndex.WebService/Controllers/BinaryIndexOpsController.cs`) - serves health, bench, cache stats, and config endpoints consumed by CLI
- `BinaryIndexOpsHealthResponse` (`src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Core/Configuration/BinaryIndexOpsModels.cs`) - health response model with lifter warmness, component versions
- `BinaryIndexOpsOptions` (`src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Core/Configuration/BinaryIndexOpsModels.cs`) - ops configuration with redacted keys and bench rate limits
- `B2R2LifterPool` (`src/BinaryIndex/__Libraries/StellaOps.BinaryIndex.Disassembly.B2R2/B2R2LifterPool.cs`) - lifter pool stats reported via ops health endpoint
- **Source**: SPRINT_20260112_006_CLI_binaryindex_ops_cli.md
## E2E Test Plan
- [ ] Run `stella binary ops health` and verify JSON output includes lifter warmness and version info
- [ ] Run `stella binary ops bench` and verify latency measurement results are returned
- [ ] Run `stella binary ops cache` and verify Valkey hit/miss statistics are reported
- [ ] Run `stella binary ops config` and verify effective configuration is returned with secrets redacted
- [ ] Run `stella deltasig extract --semantic` and verify semantic flag is passed through
- [ ] Verify table output format renders correctly for all subcommands