feat: add infrahubctl availability detection and warnings

[claude]

Closes #71

Changes

This PR implements comprehensive infrahubctl detection to warn users when the tool is missing from their Python environment, addressing the issue where users experience cryptic failures when infrahubctl is not installed.

Key Features

🔍 InfrahubctlChecker Utility Class

• Detects infrahubctl availability in the current Python environment
• Caches results for performance (30-second cache duration)
• Supports custom path configuration via settings
• Cross-platform compatibility with Windows .exe detection

⚠️ Status Bar Warning Indicator

• Shows persistent warning icon when infrahubctl is missing
• Clickable guidance with installation instructions
• Configurable via infrahub-vscode.showInfrahubctlWarnings setting

🛡️ Pre-Command Validation

• Validates infrahubctl before running affected commands
• User-friendly modal dialogs with installation guidance
• "Continue Anyway" option for advanced users
• Direct links to Infrahub documentation

📋 Enhanced Commands with Validation

• checkAllSchemaFiles() - Pre-flight infrahubctl check
• loadAllSchemaFiles() - Pre-flight infrahubctl check
• checkSchemaFile() - Pre-flight infrahubctl check
• loadSchemaFile() - Pre-flight infrahubctl check
• runTransformCommand() - Pre-flight infrahubctl check

🚨 Improved Error Handling

• Differentiates "command not found" vs "command failed" errors
• Contextual error messages with Python environment info
• Actionable guidance for resolution steps
• Links to installation documentation

⚙️ New Configuration Options

• infrahub-vscode.showInfrahubctlWarnings (boolean, default: true) - Control warning visibility
• infrahub-vscode.infrahubctlPath (string, optional) - Custom infrahubctl path override

User Experience Improvements

• Clear Messaging: Replaces generic "Failed to run infrahubctl" with specific guidance
• Environment Context: Shows which Python environment was checked for debugging
• Non-Blocking: Other extension features continue to work normally
• Graceful Degradation: Users can dismiss warnings and continue with limited functionality

Files Modified

• src/common/infrahubctlChecker.ts - New utility class for detection logic
• src/extension.ts - Extension state management and status bar integration
• src/common/utilities.ts - Pre-command validation and enhanced error handling
• src/common/commands.ts - Integration of infrahubctl checks in affected commands
• package.json - New configuration options and command registration

Testing

✅ Compilation successful (npm run compile)
✅ Linting passes (npm run lint)
✅ Follows existing code patterns and architecture
✅ Proper disposal handling for status bar items
✅ Timeout handling for API calls included

Generated by Claude

Implemented from the detailed plan in issue #71 comments.

[cloudflare-workers-and-pages]

Deploying infrahub-vscode with    Cloudflare Pages

Latest commit:	4a0b4fa
Status:	⚡️  Build in progress...

View logs

[minitriga]

@claude can you update the PR to link to docs https://docs.infrahub.app/python-sdk/guides/installation

and also use the command to install only via uv like so uv add "infrahub-sdk[all]"

[claude]

Claude finished @minitriga's task in 1m 38s —— View job

---

Updates completed

• Analyze the request
• Read changed files to find installation references
• Update documentation links to https://docs.infrahub.app/python-sdk/guides/installation
• Update installation commands to use uv add "infrahub-sdk[all]"
• Commit changes locally

Changes Made

Updated installation guidance across three files:

src/common/infrahubctlChecker.ts

• Changed installation command from multiple options (pip, poetry) to recommended: uv add "infrahub-sdk[all]"
• Updated documentation link from /getting-started/installation to /python-sdk/guides/installation

src/common/utilities.ts

• Updated documentation link to https://docs.infrahub.app/python-sdk/guides/installation

src/extension.ts

• Updated documentation link to https://docs.infrahub.app/python-sdk/guides/installation

Note

I've committed the changes locally (commit c84e8a9), but I don't have push permissions to the remote repository. The repository maintainers will need to push these changes or grant the necessary permissions to the GitHub Actions bot.

Local commit created:

docs: update installation guidance to use uv and new docs link

- Update installation command to use `uv add "infrahub-sdk[all]"`
- Update documentation links to https://docs.infrahub.app/python-sdk/guides/installation
- Simplify installation guidance to focus on recommended uv method

Co-authored-by: Alex Gittings <minitriga@users.noreply.github.com>

---