Feature/automate credential key setup

[lakshitaa-chellaramani]

Description

Automates the HIVE_CREDENTIAL_KEY setup in the quickstart script to eliminate the manual post-installation step. The script now detects existing keys, generates new ones if needed, and guides users through persisting the key in their environment or .env file.

Type of Change

• Bug fix (non-breaking change that fixes an issue)
• New feature (non-breaking change that adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Refactoring (no functional changes)

Related Issues

Fixes #2825

Changes Made

• Added new Step 4 to quickstart.sh for credential encryption key setup
• Implemented detection of existing HIVE_CREDENTIAL_KEY in environment variables and .env file
• Added automatic Fernet encryption key generation using Python's cryptography library
• Implemented shell detection (bash/zsh/fish) to suggest appropriate RC file for persistence
• Added interactive prompt to offer adding the key to .env file
• Included graceful fallback with warning if cryptography package is not installed
• Updated step numbering (old Step 4 is now Step 5)

Testing

Describe the tests you ran to verify your changes:

• Unit tests pass (cd core && pytest tests/)
• Lint passes (cd core && ruff check .)
• Manual testing performed
  • Verified Fernet key generation works correctly
  • Tested existing key detection from environment variables
  • Tested existing key detection from .env file
  • Verified shell detection logic for different shells
  • Tested .env file parsing logic

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

Screenshots (if applicable)

Example user experience during quickstart:

⬢ Step 4: Configuring credential encryption...

Generating encryption key for secure credential storage...

⬢ Generated credential encryption key

To persist credentials across sessions, add this to your shell:

export HIVE_CREDENTIAL_KEY="qGCISQY8g-8WjKs8JWsChp03f_Q2kWS2E2wSfbh9j-Y="

Add the above line to ~/.bashrc to make it permanent

Add to .env file in this directory? [Y/n]