Files
git.stella-ops.org/docs/features/unchecked/binaryindex/binaryindex-ops-cli-commands.md

1.8 KiB

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