CLI IR Commands (stella ir lift/canon/fp/pipeline)

Module

Cli

Status

VERIFIED

Description

Standalone CLI command group for intermediate representation (IR) operations including stella ir lift (binary to IR lifting), stella ir canon (IR canonicalization), stella ir fp (fingerprint generation from IR), and stella ir pipeline (full lift-canon-fingerprint pipeline). While "Semantic Analysis Library" exists in known features, these CLI commands providing direct access to IR operations are a distinct user-facing capability.

Implementation Details

Command Group: src/Cli/StellaOps.Cli/Commands/Ir/IrCommandGroup.cs -- IrCommandGroup for IR operations
Commands:
- stella ir lift <binary> -- lift a binary file to intermediate representation
- stella ir canon <ir-file> -- canonicalize an IR file for deterministic comparison
- stella ir fp <ir-file> -- generate fingerprint from IR
- stella ir pipeline <binary> -- run full lift -> canon -> fingerprint pipeline
Backend: Uses semantic analysis library for IR operations

E2E Test Plan

Run stella ir lift ./binary and verify IR output generated
Run stella ir canon ./ir-file.json and verify canonicalized IR output
Run stella ir fp ./ir-file.json and verify fingerprint hash output
Run stella ir pipeline ./binary and verify end-to-end pipeline produces fingerprint
Verify pipeline output is deterministic (same binary produces same fingerprint)
Verify --format json produces structured output
Verify error handling for unsupported binary formats

Verification

Verified: 2026-02-13T15:30:00Z
Tier 0 (Source): pass -- all referenced source files exist on disk
Tier 1 (Build): pass -- module builds cleanly, 238 tests pass in StellaOps.Cli.Formatting.Tests
Tier 2d (Integration): pass -- targeted integration tests confirm behavioral correctness
Test Project: src/Cli/__Tests/StellaOps.Cli.Formatting.Tests/StellaOps.Cli.Formatting.Tests.csproj
Evidence: docs/qa/feature-checks/runs/cli/cli-ir-commands/run-001/tier2-integration-check.json

2.1 KiB Raw Blame History