fix(cli): fix dimos --help (both bad imports and speed)

[jeff-hykin]

Problem

uv pip install dimos
dimos --help  # throws error, missing langchain

dimos --help takes ~5s because GlobalConfig imports NavigationStrategy from path_map.py (which pulls in matplotlib/scipy/numpy) and VlModelName from create.py (which pulls in torch/langchain). These are just Literal type aliases but they drag in the entire ML stack.

Solution

Move the type aliases into lightweight files in their respective packages:

• dimos/mapping/occupancy/types.py → NavigationStrategy
• dimos/models/vl/types.py → VlModelName

global_config.py imports from these instead. Original modules re-export so existing imports still work.

Also adds a regression test that fails if dimos --help takes >8s or if heavy deps leak into the CLI entrypoint.

Breaking Changes

None. All existing imports of NavigationStrategy and VlModelName still work.

How to Test

time dimos --help
# Should be ~2s, was ~5s before

python -m pytest dimos/robot/cli/test_cli_startup.py -v
# Both tests should pass

Contributor License Agreement

• I have read and approved the CLA.

[greptile-apps]

Greptile Summary

Extracts lightweight Literal type aliases (NavigationStrategy, VlModelName) into dedicated types.py modules so that GlobalConfig no longer transitively imports heavy ML/viz libraries (matplotlib, scipy, torch) at CLI startup, cutting dimos --help time from ~5s to ~2s.

• dimos/mapping/occupancy/types.py and dimos/models/vl/types.py are new zero-dependency modules housing the extracted type aliases
• global_config.py now imports from these lightweight modules instead of path_map.py (scipy/numpy) and create.py (torch/langchain)
• Original modules re-import from types.py, preserving backward compatibility for all existing consumers
• Adds two regression tests: one verifying no heavy deps leak into GlobalConfig, another ensuring dimos --help finishes within 8s
• .venv added to .gitignore

Confidence Score: 5/5

• This PR is safe to merge — it only moves type aliases to leaf modules with no behavioral changes.
• The changes are minimal and mechanical: two Literal type aliases are extracted into standalone files, import paths are updated, and original modules re-export for backward compatibility. No logic changes, no new dependencies, and the regression tests provide a good safety net. Verified that no other files in the repo use the old import paths directly.
• No files require special attention.

Important Files Changed

Filename	Overview
.gitignore	Adds .venv to gitignore — straightforward and safe.
dimos/core/global_config.py	Switches imports of NavigationStrategy and VlModelName from heavy modules to lightweight types.py files — the core change that breaks the heavy import chain.
dimos/mapping/occupancy/path_map.py	Moves NavigationStrategy definition to types.py and re-imports it, maintaining backward compatibility. Typing-only imports removed cleanly.
dimos/mapping/occupancy/types.py	New lightweight module containing only the NavigationStrategy type alias with no heavy dependencies.
dimos/models/vl/types.py	New lightweight module containing only the VlModelName Literal type with no heavy dependencies.
dimos/models/vl/create.py	Moves VlModelName definition to types.py and re-imports it. Unused Literal import removed cleanly.
dimos/robot/cli/test_cli_startup.py	New regression tests for CLI startup time and heavy-dep leakage. Unused pytest import. Tests are well-structured with reasonable timeouts.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    subgraph Before["Before (slow path)"]
        CLI_OLD["dimos CLI"] --> GC_OLD["global_config.py"]
        GC_OLD --> PM_OLD["path_map.py"]
        PM_OLD --> SCIPY["scipy / numpy / matplotlib"]
        GC_OLD --> CR_OLD["create.py"]
        CR_OLD --> TORCH["torch / langchain"]
    end

    subgraph After["After (fast path)"]
        CLI_NEW["dimos CLI"] --> GC_NEW["global_config.py"]
        GC_NEW --> OT["occupancy/types.py\n(NavigationStrategy)"]
        GC_NEW --> VT["vl/types.py\n(VlModelName)"]
        OT -. "only typing stdlib" .-> STDLIB["typing (stdlib)"]
        VT -. "only typing stdlib" .-> STDLIB
    end

    style SCIPY fill:#f88,stroke:#a00
    style TORCH fill:#f88,stroke:#a00
    style STDLIB fill:#8f8,stroke:#0a0
    style OT fill:#8f8,stroke:#0a0
    style VT fill:#8f8,stroke:#0a0

Loading

_{Last reviewed commit: 0bd3622}

[greptile-apps]

Unused pytest import

pytest is imported on this line but never used in the module — no pytest.mark, pytest.raises, pytest.fixture, etc. appear anywhere. This will trigger linter warnings (e.g. F401 in flake8/ruff).

Suggested change

# CI runners are slower — give generous headroom but still catch gross regressions.