Add Deterministic analyze Support for PowerCLI Scripts

[tsanders-rh]

Summary

Implements deterministic gap analysis for PowerCLI scripts, bringing PowerCLI to feature parity with vRealize workflows.

Closes #94

Changes

1. PowerCLI Analyzer Module (ops_translate/analyze/powercli.py)

Regex-based PowerShell parsing (MVP approach):

• VMware cmdlet detection (New-VM, Set-VM, Get-VM, Start-VM, Stop-VM, etc.)
  • Organized by category: vm_lifecycle, compute, networking, storage, tagging
• NSX cmdlet detection (Get-Nsx*, New-Nsx*, Set-Nsx*, etc.)
  • Categories: security_groups, firewall_rules, load_balancers, segments, tier_gateways
• REST API call detection (Invoke-RestMethod, Invoke-WebRequest, curl)
• Line-number tracking for evidence
• Confidence scoring (0.0-0.95)
• Complexity calculation (0-100 scale)

Output contract matches vRealize analyzer:

{
    "source_file": "script.ps1",
    "signals": {"vmware_cmdlets": 5, "nsx_cmdlets": 2, "rest_calls": 0},
    "confidence": "high",
    "evidence": [...],
    "vmware_operations": {...},
    "nsx_operations": {...},
    "rest_api_calls": [...],
    "complexity_score": 15,
    "has_external_dependencies": True
}

2. CLI Integration (ops_translate/cli.py)

Updated analyze command:

• Finds .xml files in input/vrealize/ AND .ps1 files in input/powercli/
• Routes to appropriate analyzer based on file extension
• Unified caching for both file types
• Combined gap reports merging both sources
• Updated messaging: "Analyzing automation" instead of "Analyzing workflows"

CLI Output:

Analyzing automation for external dependencies...

Found 2 vRealize workflow(s) to analyze
Found 2 PowerCLI script(s) to analyze
Analyzing 4 changed file(s)

Analyzing simple-vm.ps1...
  ⚠ simple-vm.ps1: Found external dependencies

3. VMware Cmdlet Classifier (ops_translate/intent/classifiers/vmware_cmdlets.py)

Handles PowerCLI analyzer output:

• Classifies vmware_operations detections
• All basic VMware operations → SUPPORTED
• Maps to KubeVirt/OpenShift equivalents:
  • VM lifecycle → VirtualMachine/virtctl
  • Compute → resources.requests/limits
  • Networking → Pod networking/NAD
  • Storage → PVC/DataVolume
  • Tagging → labels/annotations

4. Updated Demo (demo.sh)

Now showcases both sources:

• Imports PowerCLI scripts (simple-vm.ps1, environment-aware.ps1) for SUPPORTED examples
• Imports vRealize workflows (NSX-heavy) for BLOCKED examples
• Demonstrates multi-source analysis in single workflow

Testing

Tested with simple-vm.ps1:

✓ Correctly detects 2 vm_lifecycle operations (New-VM, Start-VM)
✓ Classifies as Fully Supported
✓ Generates proper gap analysis report
✓ Maps to KubeVirt VirtualMachine

Gap Analysis Output:

### ✅ Fully Supported Components

#### VMware Vm Lifecycle

**OpenShift Equivalent**: KubeVirt VirtualMachine

**Recommendations**:
- VM lifecycle operations map directly to KubeVirt
- New-VM → VirtualMachine manifest
- Start-VM → virtctl start
- Stop-VM → virtctl stop

Impact

✅ PowerCLI scripts now get deterministic gap analysis
✅ SUPPORTED/PARTIAL/BLOCKED classifications work for PowerCLI
✅ HTML reports show PowerCLI analysis
✅ Decision Interview compatible
✅ True parity between vRealize and PowerCLI

Design Principle

This feature reinforces:

We do not guess.
We detect, classify, and make risk visible.

PowerCLI now meets the same deterministic bar as vRealize workflows.

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 74.35065% with 79 lines in your changes missing coverage. Please review.
✅ Project coverage is 73.24%. Comparing base (3c35128) to head (8b865d8).

Files with missing lines	Patch %	Lines
ops_translate/cli.py	0.00%	36 Missing ⚠️
ops_translate/intent/classifiers/vmware_cmdlets.py	35.89%	25 Missing ⚠️
ops_translate/analyze/powercli.py	92.27%	18 Missing ⚠️
❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #95      +/-   ##
==========================================
+ Coverage   72.99%   73.24%   +0.24%     
==========================================
  Files          63       65       +2     
  Lines        7936     8222     +286     
==========================================
+ Hits         5793     6022     +229     
- Misses       2143     2200      +57     

Flag	Coverage Δ
unittests	73.24% <74.35%> (+0.24%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.