# NousResearch/hermes-agent · Refactoring and decomposing update command code

## Open now

- Nothing open on GitHub.

These items focus on restructuring and simplifying existing code—particularly around update command logic—by breaking up large files into smaller, responsibility-focused units. All changes are described as behavior-preserving refactors aimed at reducing code complexity and source line count.

## TL;DR

- 4 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 2 merged PR(s), 1 PR(s) closed without merging.
- A fix was merged to main in PR #100928. Verify it addresses your case.
- **Recommended:** read PR #100928 (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: `unresolved`. 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

- #97633: refactor(update): decompose update_cmd.py without changing behavior

## Prior & competing PRs

- **#100165: fix(update): recover the hermes serve generation after an aborted restart phase (salvage #96235)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `hermes_cli/dashboard_procs.py`, `hermes_cli/update_abort_recovery.py`, `hermes_cli/update_cmd.py`, `hermes_cli/update_inventory.py`, `hermes_cli/update_receipt.py`, `hermes_cli/update_restart_recovery.py`, `tests/hermes_cli/test_serve_runtime_inventory.py`, `tests/hermes_cli/test_update_receipt.py`, `tests/hermes_cli/test_update_restart_recovery.py`, `tests/hermes_cli/test_update_serve_generation_recovery.py`, `tests/hermes_cli/test_update_stale_dashboard.py`
- **#100928: fix(update): a successful update no longer credits or ignores surviving unmanaged serve runtimes (#100479, salvage #100490 + #100493)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`
  - files: `contributors/emails/[redacted:email]`, `hermes_cli/update_cmd.py`, `hermes_cli/update_inventory.py`, `tests/hermes_cli/test_restart_plan_reconciliation.py`, `tests/hermes_cli/test_update_fleet_restart_pending.py`
- **#97634: refactor(update): decompose command by responsibility**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `49db219ea01a265cd9b1c4f0ac58368c0eff9f52`, `593aa74c6182ce2e5e23bc102daaaae71710c05d`, `7c23c6d8663de920c2c877849b01cf680c451c7c`, `17cdb78a4e558c8fcfc2499f194ba67aa421eae9`, `#96235`, `#100165`, `#100928`, `#100490`, `#100493`, `#92934`, `#97634`, `#99450`, `#97633`

## Fix status

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