feat: enhance branch detection with CI support and robust fallbacks

[dacoburn]

With the latest update the automatic detection of the branch information in a detached head state was not being picked up like for Gitlab.

Root Cause

Gitlab variables and proper git detection for detached head state were not being done.

Fix

• Add comprehensive CI environment variable support for GitLab, GitHub, and Bitbucket
• Implement priority system: CLI args → CI variables → git properties → defaults
• Add robust fallback chain for branch detection in detached HEAD scenarios
• Replace hard failures with sensible defaults (socket-default-repo, socket-default-branch)
• Fix GitLab CI branch detection issue where branch was showing as None
• Support additional commit SHA sources (CI_COMMIT_SHA, BITBUCKET_COMMIT)
• Enhance default branch detection logic for all CI platforms
• Improve error handling and logging throughout git interface

Resolves GitLab pipeline branch detection failures and ensures CLI never fails due to missing repository or branch information.

Public Changelog

• Improved branch detection in CI environments to properly handle GitLab CI, GitHub Actions, and Bitbucket Pipelines environment variables
• Fixed branch detection showing "None" in GitLab CI pipelines by implementing proper fallback logic
• Enhanced repository and branch detection with priority system: CLI arguments → CI variables → Git properties → defaults
• Added robust fallback system with default values ("socket-default-repo", "socket-default-branch") to prevent CLI failures
• Improved detached HEAD branch detection using git name-rev and describe commands for more accurate results

[github-actions]

🚀 Preview package published!

Install with:

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple socketsecurity==2.1.27.dev1

Docker image: socketdev/cli:pr-104