Skip to content

fix(doctor): correct command syntax in graph_coverage warn message#687

Closed
brandonlipman wants to merge 1 commit into
garrytan:masterfrom
brandonlipman:fix/doctor-extract-command-syntax
Closed

fix(doctor): correct command syntax in graph_coverage warn message#687
brandonlipman wants to merge 1 commit into
garrytan:masterfrom
brandonlipman:fix/doctor-extract-command-syntax

Conversation

@brandonlipman
Copy link
Copy Markdown
Contributor

@brandonlipman brandonlipman commented May 6, 2026

Bug

The graph_coverage doctor check tells users to run commands that don't exist:

[WARN] graph_coverage: Entity link coverage 11%, timeline 7%.
       Run: gbrain link-extract && gbrain timeline-extract
$ gbrain link-extract
Unknown command: link-extract

The actual commands are gbrain extract links and gbrain extract timeline (registered as the extract subcommand at src/cli.ts:525, with the kind argument links / timeline / all parsed inside src/commands/extract.ts).

Fix

One-character change in src/commands/doctor.ts:588:

- Run: gbrain link-extract && gbrain timeline-extract
+ Run: gbrain extract links && gbrain extract timeline

This is the only place in src/ with the wrong syntax — every other reference to extract commands (init.ts:221, init.ts:331, features.ts:120, migrations/v0_13_0.ts:67, the sync.ts:752 comment) already uses extract links / extract timeline. This brings doctor in line.

Test

test/doctor.test.ts — 15 pass, 0 fail.


View in Codesmith
Need help on this PR? Tag @codesmith with what you need.

  • Let Codesmith autofix CI failures and bot reviews

graph_coverage warn directs users to run `gbrain link-extract &&
gbrain timeline-extract`, but no commands by those names are
registered in cli.ts. The actual commands are `gbrain extract links`
and `gbrain extract timeline` (registered as the 'extract'
subcommand at src/cli.ts:525, with the kind argument 'links' /
'timeline' / 'all' parsed inside src/commands/extract.ts).

A user who runs the suggested command gets:
  $ gbrain link-extract
  Unknown command: link-extract

This is the only place in src/ with the wrong syntax — the rest of
the docs (init.ts:221, init.ts:331, features.ts:120,
v0_13_0.ts:67, sync.ts:752 comment) all already say 'extract links'.
This patch just brings doctor.ts in line.
@garrytan
Copy link
Copy Markdown
Owner

Closing — your fix landed in master via the v0.30.3 fix-wave PR #776 (merged at ff53a4c9): "doctor graph_coverage warn message correction".

Thank you for the contribution — credit is preserved in the v0.30.3 CHANGELOG entry. 🙏

@garrytan garrytan closed this May 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants