Skip to content

The agent that grows with you

2.2 KB
Raw Blame

pm/ — dependencies and Hermes environments

Applies on top of the root AGENTS.md (which carries the short form of the pinning rule).

Dependency pinning policy

All dependencies carry upper bounds (litellm compromise #2796/#2810; Mini Shai-Hulud worm, May 2026). PyPI: >=floor,<next_major ("httpx>=0.28.1,<1"); pre-1.0: <0.(minor+2) (>=0.29,<0.32). Git URLs: 40-char commit SHA. GitHub Actions: SHA + # vN comment. CI-only Python requirements: ==exact. A bare >=X.Y.Z is rejected by CI and reviewers. After changing pyproject.toml, run hermes pm lock, re-source ./activate, and commit pyproject.toml with uv.lock. Reference: #2810 (bounds), #9801 (SHA pinning + audit CI).

PM owns Hermes Python dependency changes. Use pm.sync_venv(['extra'], explicit=True) for declared runtime extras, hermes pm install for setup/sync, and hermes pm repair for damaged dependencies. Do not mutate Hermes environments with raw pip or uv. Use pm.build_environment for fresh build outputs and pm.ensure_environment for isolated tool environments. Callers receive an interpreter or tool path, not uv. Nix's declarative uv2nix builds and unrelated user projects remain independently owned.

The [tool.uv] exclude-newer = "3 days" release-age check covers Hermes's own dependencies only, exact pins included, with one per-package exemption class: CA trust stores (certifi), whose revocation releases must reach the lock the day they ship (exclude-newer-package; nothing else goes there). It runs when Hermes LOCKS (hermes pm lock, CI's lock check), never on users' machines: every generated workspace drops the cutoff (pm/workspace.py::_without_release_age), so a mirror without upload times cannot break an install (#135589). Plugin resolution is unchanged by this: core's exact pins stay put, and a plugin may move a transitive core package within core's declared ranges (tests/pm/test_workspace_build_inputs.py::test_plugin_can_move_compatible_transitive_but_not_exact_requirement). Plugin python_dependencies follow the plugin's own policy. Teknium's rulings: "plugins dont have to abide by our 14 day rule … Only hermes' dependencies themselves have to"; dates are checked by us, not users; pinned deps need >3 days.