fix(hooks): warn at session start when VGV CLI is missing or outdated (#55)

Author: jorgecoca

CLAUDE.md

@@ -20,6 +20,7 @@ hooks/
     check-vgv-cli.sh   # Validates VGV CLI installed and >= 1.1.0
     format.sh          # Runs dart format on modified .dart files
     vgv-cli-common.sh  # Shared utilities for VGV CLI hook scripts
+    warn-missing-mcp.sh  # Warns at session start if VGV CLI is missing/outdated
 skills/
   accessibility/SKILL.md
   accessibility/reference.md
@@ -69,7 +70,13 @@ Every `SKILL.md` follows this structure:
 
 ## Hooks
 
-The `hooks/` directory contains PreToolUse and PostToolUse hooks defined in `hooks.json`.
+The `hooks/` directory contains SessionStart, PreToolUse, and PostToolUse hooks defined in `hooks.json`.
+
+### SessionStart Hooks
+
+These run **when a session begins**:
+
+- `warn-missing-mcp.sh` — checks if Very Good CLI is installed and >= 1.1.0; outputs a warning to Claude's context if missing or outdated (non-blocking)
 
 ### PreToolUse Hooks
 

hooks/hooks.json

@@ -1,6 +1,17 @@
 {
   "description": "Very Good AI Flutter Plugin hooks for Dart and Flutter development",
   "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/scripts/warn-missing-mcp.sh",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
     "PreToolUse": [
       {
         "matcher": "mcp__very-good-cli__.*",

hooks/scripts/warn-missing-mcp.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# SessionStart hook: warn when Very Good CLI is missing or outdated.
+# Output is injected into Claude's context (not displayed in the terminal).
+# Non-blocking — always exits 0.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/vgv-cli-common.sh"
+
+cli_status=$(check_vgv_cli)
+case "$cli_status" in
+  not_installed)
+    echo "⚠️ Very Good CLI is not installed. The Very Good CLI MCP server will not work without Very Good CLI >= ${MIN_VERSION}. Install with: dart pub global activate very_good_cli"
+    ;;
+  outdated:*)
+    version="${cli_status#outdated:}"
+    echo "⚠️ Very Good CLI ${version} is too old. The Very Good CLI MCP server requires >= ${MIN_VERSION}. Update with: dart pub global activate very_good_cli"
+    ;;
+esac
+
+exit 0