CCO Doctor
When the user runs /cco-doctor or reports the plugin "isn't working", run a quick health check.
How to use
Standard run (fast — under 1s):
node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js
With test suite (slower — runs all unit tests):
node ${CLAUDE_PLUGIN_ROOT}/src/doctor.js --tests
What it checks
- Plugin manifest and
package.jsonexist - Versions are in sync (
plugin.jsonandpackage.json) hooks.jsonis valid JSON with all expected event types- All hook scripts present in
src/ - Data directory
~/.claude-context-optimizer/is writable patterns.jsonsize is reasonable- Global stats file is parseable
- User config has sane model + budget for the chosen model
- Node version meets the >=18 requirement
Presentation
Translate the doctor output into plain language. If anything is fail, walk the user through the fix:
- versions out of sync →
npm run sync-version - patterns.json too big →
/cco-clean - budget > model window →
/cco-budget set <smaller>or pick a 1M-context model (e.g.opus-4.8) - node too old → upgrade Node
If everything is pass, confirm "плагин в порядке, текущая версия Х.Y.Z" and stop.