syntaxis/docs/howto/workspace_env_info.md
Jesús Pérez 9cef9b8d57 refactor: consolidate configuration directories
Merge _configs/ into config/ for single configuration directory.
Update all path references.

Changes:
- Move _configs/* to config/
- Update .gitignore for new patterns
- No code references to _configs/ found

Impact: -1 root directory (layout_conventions.md compliance)
2025-12-26 18:36:23 +00:00

37 lines
1.2 KiB
Markdown

Summary:
✅ Do NOT add to .env (they're handled by wrapper scripts)
- WORKSPACE_CONFIG_DIR - Set by wrapper to ~/.config/syntaxis
- WORKSPACE_DATA_DIR - Set by wrapper to ~/.local/share/syntaxis
✅ Why This Design is Good:
1. User-agnostic - Each user gets their own ~/.config/ and ~/.local/share/ directories
2. Standard Unix - Follows XDG Base Directory specification
3. Automatic - Wrapper scripts handle it, no manual setup needed
4. Overridable - Users can still export WORKSPACE_CONFIG_DIR=/custom/path if needed
✅ Current System Flow:
Development:
cargo run -p syntaxis-cli (env vars NOT set, uses hardcoded search paths)
find_config_path_warn_conflicts("config.toml")
Searches: .project/ → .vapora/ → .coder/
Production (after install):
workspace --help (wrapper runs first)
Wrapper sets env vars
workspace.real binary runs with environment set
✅ Config Discovery (Already Implemented):
The Rust code in shared/rust/config_finder.rs already handles all the logic. The wrapper is just a convenience layer for
production use.
You don't need to add these to .env - the current system is already well-designed! ✅