hermes - 💡(How to fix) Fix v0.15.1 wheel installs hermes_cli/dashboard_auth/ to wrong path → dashboard ModuleNotFoundError

Environment

• Image with broken wheel: nousresearch/hermes-agent @ sha256:b6e41c155d6b… (8.51GB, built 12 days ago). Issue is in the PyPI wheel, not the image — reproduces from uv pip install --upgrade hermes-agent in any v0.14.x container.
• Current :latest (sha256:06b89c64f69d…, 4.66GB, src-layout editable install) is NOT affected.
• Version: Hermes Agent v0.15.1 (2026.5.29)
• Python: 3.13.5, installer: uv

Symptom

After in-place upgrade to v0.15.1, dashboard subprocess crashes at import:

[dashboard] File ".../hermes_cli/web_server.py", line 4822, in <module>
[dashboard]     from hermes_cli.dashboard_auth.routes import router
[dashboard] ModuleNotFoundError: No module named 'hermes_cli.dashboard_auth'

Gateway main process unaffected; only dashboard dies.

Root cause

The v0.15.1 wheel installs dashboard_auth/ to the wrong path. RECORD shows:

plugins/dashboard_auth/nous/__init__.py    ← installed to top-level plugins/

But code imports it as hermes_cli.dashboard_auth.routes — i.e. expects hermes_cli/dashboard_auth/. Wheel packaging config likely scopes dashboard_auth/ as a top-level plugin path instead of as a hermes_cli/ subpackage.

The new image with editable install (__editable__.hermes_agent-0.15.1.pth → /opt/hermes/hermes_cli/) bypasses this — dashboard_auth/ lives correctly under hermes_cli/ in the source tree, and live import returns a real APIRouter.

Repro

1. Container from any image where uv pip install of hermes-agent==0.15.1 writes the wheel into venv (any user who runs hermes update from 0.14.x).
2. Restart dashboard → ModuleNotFoundError.
3. Verify: grep dashboard_auth {venv}/site-packages/hermes_agent-0.15.1.dist-info/RECORD → only plugins/dashboard_auth/... entries, none under hermes_cli/dashboard_auth/....

Workaround

docker pull nousresearch/hermes-agent:latest && docker compose up -d --force-recreate — the new image uses editable install of the source tree, sidestepping the broken wheel.

Suggested fix

Audit wheel [tool.hatch.build.targets.wheel] (or equivalent in pyproject.toml) to ensure hermes_cli/dashboard_auth/ ships as a hermes_cli subpackage. Post-build RECORD should show hermes_cli/dashboard_auth/* entries.