# NousResearch/hermes-agent · Fix Hermes update on shallow/stale git checkouts

## Open now

- Nothing open on GitHub.

These issues and PRs address a failure mode where updating Hermes times out on shallow or stale installations because the full history fetch hits a time cap before the repository can be properly unshallowed. The proposed fixes reorder or restructure the fetch steps to unshallow the commit graph first.

## TL;DR

- 4 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 2 PR(s) closed without merging.
- A fix was merged to main in PR #126150. Verify it addresses your case.
- **Recommended:** read PR #126150 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-126150`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.50`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #123254: hermes update can never succeed on a stale shallow install: main fetch pulls ~full history and hits the 300s cap before the post-update unshallow step can run

## Prior & competing PRs

- **#126150: hermes update works on shallow, stale and partial-clone checkouts (salvage #122430, #123312, #124293, #124671)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `hermes_cli/gitlock.py`, `hermes_cli/update_cmd.py`, `hermes_cli/update_cmd_check.py`, `tests/e2e/core/upgrade/git/test_partial_clone.py`, `tests/e2e/core/upgrade/git/test_shallow_install.py`, `tests/hermes_cli/test_gitlock.py`, `tests/hermes_cli/test_shallow_boundary_repair.py`, `tests/hermes_cli/test_shallow_graft_prune.py`, `tests/hermes_cli/test_tag_fetch_partial_clone.py`, `tests/hermes_cli/test_update_shallow_heal.py`
- **#123312: fix(update): heal stale shallow history before the bounded fetch (#123254)**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#126150`
- **#123335: fix(update): unshallow a stale install's commit graph before the branch fetch**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#123312`, `#123254`

## Fix status

- Merged to main in PR #126150 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-09-28`.