feat: Add auto-update support and enhanced version detection (v0.3.4)

## Features
- Added --autoupdate flag to configure install-all command
- Doctor command now detects unpinned eyelet versions
- Enhanced doctor output with clear auto-update instructions

## Fixes
- CRITICAL: Execute command supports both hook_type and hook_event_name
- Fixed pydantic validation errors with Claude Code input

## Documentation
- Added comprehensive version update section to README
- Clear guidance on enabling auto-updates
- Three options for managing eyelet versions

This ensures users are aware of version pinning and can easily enable
auto-updates with uvx eyelet@latest for continuous improvements.

Author: bdmorin

CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.4] - 2025-01-30
+
+### Added
+- **Auto-update support**: New `--autoupdate` flag for `configure install-all` command
+- **Version detection**: Doctor command now detects and warns about unpinned eyelet versions
+- **Update guidance**: Doctor provides clear instructions for enabling auto-updates
+
+### Fixed
+- **CRITICAL**: Execute command now supports both `hook_type` and `hook_event_name` fields
+- Fixed validation error when Claude Code sends hook_event_name
+
+### Changed
+- Enhanced doctor command output with prominent auto-update notifications
+- Improved README with version update documentation
+
 ## [0.3.3] - 2025-01-30
 
 ### Fixed

README.md

@@ -9,7 +9,13 @@
 [![CI](https://github.com/bdmorin/eyelet/actions/workflows/ci.yml/badge.svg)](https://github.com/bdmorin/eyelet/actions/workflows/ci.yml)
 [![Status](https://img.shields.io/badge/status-alpha-yellow)](https://github.com/bdmorin/eyelet)
 
-## 🎉 New in v0.3.3: Recall Feature & TUI Framework!
+## 🎉 New in v0.3.4: Auto-update Support & Critical Fixes!
+
+### v0.3.4 Updates
+- **Auto-update support**: `--autoupdate` flag for install-all command
+- **Version detection**: Doctor command warns about unpinned versions
+- **Critical fix**: Execute command now supports both hook_type and hook_event_name
+- **Enhanced doctor**: Clear guidance on enabling auto-updates
 
 ### v0.3.3 Updates (Hotfix)
 - Fixed missing TUI module in PyPI package
@@ -53,13 +59,16 @@ Eyelet provides comprehensive management, templating, and execution handling for
 ## 🚀 Quick Start
 
 ```bash
-# Install universal logging for ALL hooks (one command!)
+# Install universal logging for ALL hooks with auto-updates
+uvx eyelet configure install-all --autoupdate
+
+# Or install without auto-updates (manual updates required)
 uvx eyelet configure install-all
 
 # Enable SQLite logging for better performance
 uvx eyelet configure logging --format sqlite
 
-# Check your configuration health
+# Check your configuration health (detects unpinned versions)
 uvx eyelet doctor
 
 # Query your hook data
@@ -68,6 +77,29 @@ uvx eyelet query search --help    # Search options
 uvx eyelet query errors           # Debug issues
 ```
 
+### ⚠️ Important: Version Updates
+
+By default, `uvx eyelet` caches the package and won't auto-update. You have three options:
+
+1. **Enable auto-updates** (recommended):
+   ```bash
+   uvx eyelet configure install-all --autoupdate
+   ```
+   This uses `uvx eyelet@latest` which always fetches the latest version.
+
+2. **Manual update** when needed:
+   ```bash
+   uvx --reinstall eyelet@latest execute --log-only
+   ```
+
+3. **Use pipx** for global installation:
+   ```bash
+   pipx install eyelet
+   pipx upgrade eyelet  # When updates are available
+   ```
+
+Run `eyelet doctor` to check if your hooks are configured for auto-updates.
+
 ## 🎯 Universal Hook Handler
 
 Eyelet includes a powerful universal hook handler that logs EVERY Claude Code hook to a structured directory:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "eyelet"
-version = "0.3.3"
+version = "0.3.4"
 description = "Hook orchestration system for AI agents with SQLite logging and powerful analytics"
 readme = "README.md"
 authors = [{name = "Brian Morin"}]

src/eyelet/__init__.py

@@ -4,7 +4,7 @@
 Thread through the eyelet!
 """
 
-__version__ = "0.3.3"
+__version__ = "0.3.4"
 __author__ = "Brian Morin"
 
 # Defer imports to avoid circular dependencies

src/eyelet/cli/configure.py

@@ -304,8 +304,11 @@ def clear(ctx, scope, force):
 @click.option(
     "--dev", is_flag=True, help="Use local development wheel instead of public uvx"
 )
+@click.option(
+    "--autoupdate", is_flag=True, help="Pin to @latest for automatic updates"
+)
 @click.pass_context
-def install_all(ctx, scope, force, dev):
+def install_all(ctx, scope, force, dev, autoupdate):
     """
     Install universal logging for ALL hooks - Full broadside!
 
@@ -369,10 +372,16 @@ def install_all(ctx, scope, force, dev):
             )
         else:
             # Use public uvx (requires package to be published to PyPI)
-            eyelet_cmd = "uvx eyelet execute --log-only"
-            console.print(
-                "[cyan]Using public uvx command (requires PyPI package)[/cyan]"
-            )
+            if autoupdate:
+                eyelet_cmd = "uvx eyelet@latest execute --log-only"
+                console.print(
+                    "[cyan]Using public uvx command with @latest (auto-updates enabled)[/cyan]"
+                )
+            else:
+                eyelet_cmd = "uvx eyelet execute --log-only"
+                console.print(
+                    "[cyan]Using public uvx command (requires PyPI package)[/cyan]"
+                )
 
         # PreToolUse and PostToolUse for all tools
 

src/eyelet/cli/doctor.py

@@ -66,6 +66,9 @@ def doctor(ctx, fix, verbose):
     issues.extend(dep_issues[0])
     warnings.extend(dep_issues[1])
 
+    # Check for version pinning warning specifically
+    has_unpinned_warning = any("unpinned eyelet command" in w for w in warnings)
+    
     # Summary
     console.print("\n" + "=" * 50 + "\n")
 
@@ -95,6 +98,19 @@ def doctor(ctx, fix, verbose):
             console.print(
                 "\n💡 Run with [bold]--fix[/bold] to automatically fix issues where possible."
             )
+    
+    # Special notification for unpinned versions
+    if has_unpinned_warning:
+        console.print("\n" + "=" * 50)
+        console.print("\n🔔 [bold yellow]IMPORTANT: Auto-updates not enabled[/bold yellow]")
+        console.print("\nYour eyelet hooks won't automatically get updates.")
+        console.print("To enable auto-updates, choose one option:\n")
+        console.print("  1. [cyan]eyelet configure install-all --autoupdate[/cyan]")
+        console.print("     Reinstalls all hooks with @latest pinning\n")
+        console.print("  2. [cyan]uvx --reinstall eyelet@latest execute --log-only[/cyan]")
+        console.print("     Manually update individual hooks in settings.json\n")
+        console.print("  3. [cyan]pipx upgrade eyelet[/cyan] (if using pipx)")
+        console.print("     Updates globally installed version")
 
 
 def check_claude_integration(
@@ -125,18 +141,36 @@ def check_claude_integration(
 
                 # Check hook configuration
                 hooks = settings.get("hooks", {})
+                unpinned_commands = []
                 for _hook_type, hook_list in hooks.items():
                     if isinstance(hook_list, list):
                         for entry in hook_list:
                             if "hooks" in entry:
                                 for hook in entry["hooks"]:
                                     total_hooks += 1
-                                    if "eyelet" in hook.get("command", ""):
+                                    command = hook.get("command", "")
+                                    if "eyelet" in command:
                                         eyelet_hooks += 1
+                                        # Check if version is pinned
+                                        if "uvx eyelet" in command and "@" not in command:
+                                            unpinned_commands.append(command[:50] + "..." if len(command) > 50 else command)
 
                 if verbose:
                     console.print(f"   📊 Total hooks: {total_hooks}")
                     console.print(f"   📊 Eyelet hooks: {eyelet_hooks}")
+                
+                # Warn about unpinned versions
+                if unpinned_commands:
+                    warnings.append(
+                        f"Found {len(unpinned_commands)} unpinned eyelet command(s). "
+                        "These won't auto-update. Use 'eyelet configure install-all --autoupdate' "
+                        "or add '@latest' to commands manually."
+                    )
+                    if verbose:
+                        for cmd in unpinned_commands[:3]:  # Show first 3
+                            console.print(f"      • {cmd}")
+                        if len(unpinned_commands) > 3:
+                            console.print(f"      • ... and {len(unpinned_commands) - 3} more")
 
             except Exception as e:
                 issues.append(f"Failed to parse {settings_path}: {e}")