Skip to content

opx v0.3.0 - Enhanced Version Command and Policy Debugging

Choose a tag to compare

@zach-source zach-source released this 21 Sep 17:53
· 40 commits to main since this release
53f1fc1

🔍 opx v0.3.0 - Enhanced Debugging and Version Information

🆕 Enhanced Version Command

  • Server process detection: Shows which daemon executable is actually running
  • Command line display: Full daemon command with flags and arguments
  • Configuration debugging: Identify client/server version mismatches
  • Process identification: Distinguish between Nix/Homebrew/local daemon installations

🛠️ Policy Debugging Tools

  • Policy state machine: Step-by-step rule evaluation with detailed breakdown
  • Audit failure analysis: Quick identification of access denials with reasons
  • Interactive debugging: Visual policy evaluation with ✅/❌ indicators
  • Consistent policy testing: Fixed discrepancy between test and debug commands

🔧 New Commands

# Enhanced version information
opx version                    # Shows client version + server process info

# Comprehensive policy debugging  
opx policy debug <path> <ref>  # Detailed rule evaluation breakdown
opx audit failures --since=1h # Quick denial analysis with reasons

# Server version
opx-authd --version           # Shows daemon version and exits

📦 Installation (macOS ARM64)

Download signed binaries for Apple Silicon Macs.

💡 Debugging Benefits

  • Configuration troubleshooting: Identify daemon path and command line mismatches
  • Policy analysis: Complete rule evaluation with failure point identification
  • Audit investigation: Quick access denial analysis with suggested fixes
  • Version verification: Ensure client/server compatibility

This release provides professional debugging tools for comprehensive troubleshooting of access control and configuration issues.