hermes-agent/website/docs/reference
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Halldrix 60f9d2abb1 fix(debug-share): capture update.log and desktop-update-handoff.log
When a Desktop-driven update fails at the Electron rebuild (updater
exit 6, 'Code and dependencies updated, but the Desktop app REBUILD
FAILED'), the only artifacts holding the root cause are
~/.hermes/logs/update.log (full stdout/stderr mirror of hermes update,
written by _UpdateOutputStream) and ~/.hermes/logs/desktop-update-handoff.log
(hand-off stages including the 'desktop --force-build --build-only' retry).
Both the updater's failure messages and the Desktop error box direct
users to 'hermes debug share', but the share captured neither file:
LOG_FILES and the debug.py capture chain covered only the classic
five logs, so update-failure issues (e.g. #100874) arrived with the
diagnostics that matter most missing.

Additionally, 'hermes logs list' (a directory scan) already listed
both files while LOG_FILES had no readable key for them, so
'hermes logs update' failed with 'Unknown log' against a file the
CLI itself displays.

Wire both files through the whole chain:
- hermes_cli/logs.py: add 'update' and 'handoff' LOG_FILES keys
  (fixes list-vs-read inconsistency; tail/follow/filters come free).
- hermes_cli/debug.py: _capture_default_log_snapshots,
  collect_debug_report (512 KB snapshot cap and the 100-line tail
  budget both apply; a hand-built snapshot dict without the new keys
  degrades to the old five-section report instead of KeyError),
  collect_share_bundle full logs, the paste-upload label list in
  build_debug_share, and the --local print list. The --nous bundle
  and privacy notice inherit the new keys; force-redaction applies
  via _capture_log_snapshot as for every other log.
- hermes_cli/subcommands/logs.py + website docs: name the new logs.

Tests (tests/hermes_cli/test_debug_share_update_logs.py): 12 new
tests — snapshot keys present with real content, missing files
degrade to the honest note without raising, report sections appear,
bundle keys omitted when absent, upload/--local label lists include
the new logs, LOG_FILES keys resolve, tail_log end-to-end. Sabotage
pass: 10 of 12 fail without the fix.
2026-09-29 21:48:25 -05:00
..
_category_.json
automation-blueprints-catalog.mdx docs: finish Automation Blueprints terminology rebrand (#44470) 2026-06-11 17:22:22 -04:00
cli-commands.md fix(debug-share): capture update.log and desktop-update-handoff.log 2026-09-29 21:48:25 -05:00
cli-symbols.md fix(branding): use the Caduceus ☤ (U+2624), not the Rod of Asclepius ⚕ (U+2625) 2026-09-12 08:25:54 -07:00
environment-variables.md Merge origin/main into chore/relay-0.9 2026-09-28 09:22:11 -07:00
faq.md docs: clarify Python updater range and test sandbox marker 2026-09-24 09:20:50 -04:00
mcp-config-reference.md fix(review): MCP owner rebuild keeps the launch profile's env-only credentials (#119092 review) 2026-09-28 05:24:26 -07:00
model-catalog.md fix(picker): curated fallback for cold OAuth rows; Z.AI failed-probe negative cache; trim salvage 2026-09-18 11:01:52 -07:00
optional-skills-catalog.md feat(skills): brag and brag-slim join the optional-skills catalog as upstream stubs 2026-09-26 21:41:31 -05:00
package-management.md fix: install cua-driver and the Browser Use CLI by default again 2026-09-27 19:18:58 -07:00
profile-commands.md fix(profiles): rename removes the old name's gateway service even when stopped (#124401, salvage #124402) 2026-09-28 04:04:23 -07:00
skills-catalog.md docs(website): regenerate the skill docs from the shipped skill tree 2026-09-20 12:54:07 -07:00
slash-commands.md feat(gateway): /branch opens a sibling thread by default; --here keeps this chat (#66023) 2026-09-20 13:37:10 -07:00
tools-reference.md Clarify: one question shape and one result shape on every surface (skip, cancel, timeout and undelivered are told apart) (#127760) 2026-09-29 18:33:44 +05:30
toolsets-reference.md feat: setup agent can search the catalog and install plugins and skills through the approval card 2026-09-23 08:04:33 +05:30