Add version upgrade notification at session start

[calreynolds]

Summary

• Adds a non-blocking version check that runs via Claude Code SessionStart hook
• Compares local installed version against latest on GitHub, notifies user if an update is available
• Results cached for 24 hours to avoid repeated network requests
• Silent on any failure (offline, timeout, missing files)

How it works

check_update.sh runs at session start. Its stdout is injected as context Claude sees, so it naturally relays the upgrade notice to the user before proceeding with their request.

Supports all install paths:

• Plugin mode: reads $CLAUDE_PLUGIN_ROOT/VERSION
• Project-scoped install: reads .ai-dev-kit/version in project dir
• Global install: reads ~/.ai-dev-kit/version

What users see

When outdated (once per new session, max once per 24h network check):

╔══════════════════════════════════════════════════════════════╗
║                                                             ║
║   Databricks AI Dev Kit — update available!                 ║
║                                                             ║
║   Installed:  v0.1.2                                        ║
║   Available:  v0.1.3                                        ║
║                                                             ║
║   To upgrade, run:                                          ║
║   bash <(curl -sL https://raw.githubusercontent.com/        ║
║     databricks-solutions/ai-dev-kit/main/install.sh)        ║
║                                                             ║
╚══════════════════════════════════════════════════════════════╝

When up to date or offline: nothing.

Files changed

• .claude-plugin/check_update.sh (new) — version check script with 24h cache
• hooks/hooks.json (modified) — added check_update hook to SessionStart

Test plan

• Install v0.1.2 in a temp folder, start Claude Code session — should see upgrade banner
• Start another session — should still see banner (cached, versions still differ)
• Update to v0.1.3, clear cache, start session — should see nothing
• Disconnect from network, clear cache, start session — should see nothing (silent fail)
• For install.sh users: add hook to .claude/settings.json pointing to check_update.sh

🤖 Generated with Claude Code