This release aligns the plugin with the CLI’s global sources feature, turning two otherwise-cryptic failure modes into clear guidance at session start.
Improvements
- The session-start hook detects when an older, pre-globals CLI rejects the new
globalsfield insettings.jsonand shows a one-time, rate-limited “update your CLI” advisory (with install commands) instead of leaving MCP and context silently unavailable. - The advisory fires only on the strict parser’s exact field-rejection signature, so a current CLI that understands
globalsnever triggers a false nudge — even in projects that declare globals. - With a current CLI, a missing declared global degrades to a local-only context summary with a visible warning naming the source, so local documents are never silently dropped.
Misc
- Version bumped to
0.4.10across the Claude Code, Cursor, and Codex CLI plugin manifests. - Added CLI-compatibility invariant tests and unit coverage for the session-start advisory.