fix: add smart sys.path fallback for init_db entrypoint

[Wee7]

1. Related Issue

NA

2. Type of Change

Type of Change: Bug Fix

3. Description

Fixes issues when project path contains spaces (e.g., "Mobile Documents" on macOS).

• Add smart path handling in init_db.py to support direct script execution
• Add quotes to all path variables in launch.py for space compatibility
• Manually load .env file and pass via subprocess to avoid shell parsing issues
• Fixes ModuleNotFoundError when running uv run valuecell/server/db/init_db.py
• Fixes environment variable loading failure on paths like 'Example Path'

The changes are backward compatible:

• init_db.py: Only adds path when import fails (try-except pattern)
• launch.py: Quotes work for both standard and space paths
• No impact on users with standard installation paths

4. Testing

• ✅ Tested on macOS with path containing spaces
• ✅ Backward compatible with standard paths
• ✅ All services start successfully

5. Checklist

• ✅ I have read the Code of Conduct
• ✅ I have followed the Contributing Guidelines
• ✅ My changes follow the project's coding style
• ✅ Tested locally

[Copilot]

Pull Request Overview

This PR addresses issues when the project directory path contains spaces (common on macOS in "Mobile Documents" directories). The changes add path quoting in launch.py and path handling logic in init_db.py to support direct script execution.

Key Changes:

• Added try-except import pattern in init_db.py to support running the script directly via uv run
• Added single quotes around all path variables in command strings to handle spaces
• Implemented manual .env file parsing to pass environment variables via subprocess instead of using --env-file flag

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 7 comments.

File	Description
python/valuecell/server/db/init_db.py	Adds smart path handling to allow direct script execution by conditionally adding the Python package root to sys.path when imports fail
python/scripts/launch.py	Adds quotes to path variables and implements manual .env loading to avoid shell parsing issues with spaces in paths

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[vcfgv]

Thanks for the Pull Request. Could you please run ⁠make format to ensure the code style is consistent with our project standards?

[Wee7]

Hi @vcfgv,

I've updated this PR to resolve merge conflicts with the latest main branch.

Current changes:

• Only modifies python/valuecell/server/db/init_db.py (+12 lines)
• Adds smart path handling to support project directories containing spaces (e.g., "Mobile Documents" on macOS)
• Resolves ModuleNotFoundError when running uv run valuecell/server/db/init_db.py from paths with spaces

What happened:
The previous commits modified launch.py, which has since been refactored and removed in the upstream main branch (#401). I've rebased on the latest main and removed those obsolete changes. The PR now only contains the necessary fix for init_db.py.

Implementation:
Uses a try-except import guard pattern that only modifies sys.path when the valuecell package import fails, ensuring backward compatibility with standard installation paths.

The PR is now ready for review. Thank you for your patience!

[vcfgv]

LGTM

[vcfgv]

I updated the title to better reflect the actual changes. Thanks for the contribution!