Skip to content

fix(doctor): prevent false positives for WAL and launcher checks - #97456

Closed
wooyongbin3-cpu wants to merge 1 commit into
NousResearch:mainfrom
wooyongbin3-cpu:fix/doctor-false-positives
Closed

wooyongbin3-cpu wants to merge 1 commit into
NousResearch:mainfrom
wooyongbin3-cpu:fix/doctor-false-positives

Conversation

@wooyongbin3-cpu

Copy link
Copy Markdown
Contributor

Summary

This PR fixes #96976 by preventing false positives in hermes doctor for WAL and launcher checks.

Problem

Two false positives in hermes doctor:

  1. WAL check: Large WAL file was flagged as an issue even when fully checkpointed
  2. Launcher check: ~/.local/bin/hermes not found was reported even when hermes is available on PATH from another location

Solution

1. WAL Check

Now checks PRAGMA wal_checkpoint(PASSIVE) result before flagging:

  • If all frames checkpointed (log == checkpointed), reports as healthy
  • Only flags as issue if there are uncheckpointed frames

2. Launcher Check

Now checks shutil.which("hermes") before reporting missing:

  • If hermes is found on PATH from any location, reports success
  • Only reports missing if hermes is not on PATH at all

Changes

  • Modified hermes_cli/doctor.py: Added checkpoint verification and PATH check

🤖 Generated with Codebuff
Co-Authored-By: Codebuff noreply@codebuff.com

Two false positives in hermes doctor:

1. WAL check: Large WAL file was flagged as an issue even when fully
   checkpointed. Now checks PRAGMA wal_checkpoint(PASSIVE) result before
   flagging. Fully checkpointed WALs are reported as healthy.

2. Launcher check: ~/.local/bin/hermes not found was reported even when
   hermes is available on PATH from another location (e.g., /usr/local/bin).
   Now checks shutil.which("hermes") before reporting missing.

These are both cosmetic fixes that prevent unnecessary repair suggestions.

Fixes NousResearch#96976

🤖 Generated with Codebuff
Co-Authored-By: Codebuff <noreply@codebuff.com>
@alt-glitch alt-glitch added type/bug Something isn't working comp/cli CLI entry point, hermes_cli/, setup wizard P3 Low — cosmetic, nice to have duplicate This issue or pull request already exists labels Aug 28, 2026
@alt-glitch

Copy link
Copy Markdown
Contributor

This was generated by AI during triage.

Duplicate of #97133: it implements the same WAL checkpoint-state and PATH-resolved launcher checks.

@teknium1

Copy link
Copy Markdown
Collaborator

Closing as a duplicate of #97133, which carries tests and the fuller WAL-health classification; #97133 stays open for a doctor-lane review. Thanks @wooyongbin3-cpu.

@teknium1 teknium1 closed this Sep 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

comp/cli CLI entry point, hermes_cli/, setup wizard duplicate This issue or pull request already exists P3 Low — cosmetic, nice to have type/bug Something isn't working

Projects

None yet

Development

Successfully merging this pull request may close these issues.

doctor: flags a fully-checkpointed WAL and a PATH-resolved hermes launcher as issues; repairs are unnecessary/counter-productive

3 participants