v3.1.1 - Context Forge Integration

Release Notes - v3.1.1

🚀 Context Forge Integration - Enable Multi-Hour AI Development Workflows!

We're thrilled to announce the integration with Context Forge, solving one of the biggest challenges in AI-assisted development: context loss during extended coding sessions.

The Problem

When working with Claude Code for extended periods, the context window fills up (typically every 2 hours) and performs "compaction". During this process, Claude forgets:

• Your project-specific rules and conventions
• Current implementation stage and progress
• PRP guidelines and specifications
• Bug tracking history

The Solution

Our new Context Forge hooks provide automatic context recovery:

• PreCompact Hook - Detects Context Forge projects before compaction
• Stop Hook - Forces Claude to re-read critical files after compaction
• Smart Detection - Only activates for Context Forge projects
• Zero Configuration - Works automatically once installed

Benefits

✅ 8+ Hour Development Sessions - Work all day without context loss
✅ Automatic Recovery - No manual reminders needed
✅ Maintained Quality - Consistent standards throughout
✅ PRP Compliance - Continuous adherence to specifications

Quick Setup

1. Install Context Forge:

npm install -g context-forge

2. Create a Context Forge project:

context-forge init

3. Install the Context Forge hooks:

cd ~/.claude/hooks
git clone https://github.com/webdevtodayjason/claude-hooks.git
cd claude-hooks/hooks/context-forge
./install-context-forge-hooks.sh

What's Included

• precompact-context-refresh.py - PreCompact hook
• stop-context-refresh.py - Stop hook
• context-forge-utils.py - Utility functions
• install-context-forge-hooks.sh - Easy installation
• Comprehensive documentation and examples

Documentation

• Context Forge Integration Guide
• Integration Technical Details
• Testing Guide

Other Changes

• Updated README with prominent Context Forge section
• Added "The Perfect AI Development Workflow" guide
• Increased total hook count to 20
• Enhanced documentation structure

---

This release transforms AI-assisted development from short sessions into productive all-day workflows. No more context loss, no more repetitive reminders - just continuous, high-quality development with Claude Code.

Full Changelog: https://github.com/webdevtodayjason/claude-hooks/blob/main/CHANGELOG.md

v3.0.0 - Claude Hooks Manager

🚨 Breaking Change - Project Renamed

This major release renames the project from claude-code-hooks to claude-hooks-manager.

📦 New Package Name

# Old package (deprecated)
npm uninstall -g claude-code-hooks

# New package
npm install -g claude-hooks-manager

What's Changed

• Project Name: claude-code-hooks → claude-hooks-manager
• NPM Package: claude-code-hooks → claude-hooks-manager
• CLI Command: claude-hooks (unchanged for compatibility)
• All "Claude Code" references updated to "Claude"

Why the Rename?

• Better reflects the tool's purpose as a management system for Claude hooks
• Avoids potential trademark concerns with Anthropic's "Claude Code" branding
• Clearer positioning as a community tool

Features Included

• 18 total hooks including the new timestamp-validator
• Complete hook management suite (enable/disable/create/edit/remove)
• Comprehensive documentation for custom hook development
• Interactive CLI with beautiful UI

Migration Guide

1. Uninstall the old package: npm uninstall -g claude-code-hooks
2. Install the new package: npm install -g claude-hooks-manager
3. All your hooks and settings remain unchanged
4. CLI commands stay the same (claude-hooks)

---

Full Changelog: v2.2.2...v3.0.0

v2.2.2 - Documentation & Timestamp Validation

📚 Documentation & Time Accuracy

This release adds comprehensive documentation for custom hook development and a new timestamp validation hook.

🆕 New Hook: timestamp-validator

• Validates dates in documentation and changelogs
• Prevents incorrect dates (e.g., January dates in July)
• Warns about future dates or unreasonable timestamps
• Provides current date/time in multiple formats
• Catches common temporal mistakes in commits

📖 Documentation

• Comprehensive Custom Hook Development Guide
  • Complete tutorial with examples
  • Hook architecture explanation
  • Input/output specifications
  • Best practices and troubleshooting
  • Multiple real-world examples
• Enhanced README with prominent documentation links
• Better documentation organization

🎯 Why timestamp-validator?

This hook was created after experiencing date confusion in our own development. It ensures your documentation always has accurate temporal information by validating against system time.

📦 Installation

npm install -g claude-code-hooks@latest

🚀 Quick Start

# Install/update hooks
claude-hooks install

# Create your own custom hook
claude-hooks create my-custom-hook

---

Full Changelog: v2.2.1...v2.2.2

v2.2.1 - Visual Status Indicators

🎨 UI Enhancements

This patch release adds visual status indicators to improve hook management visibility.

What's New

• Visual Status Indicators in list command
  • 🟢 Green dot for enabled hooks
  • 🔴 Red dot for disabled hooks
  • ⚪ Gray circle for not installed hooks
• Enhanced Status Command with detailed hook counts by state
• Status Indicators in Menus for better visual feedback

Example Output

Available Claude Code Hooks:

  ● pre-commit-validator.py           Enforces coding standards before commits
  ● validate-git-commit.py            Validates commit message format
  ● database-extension-check.py       Validates database migration files
  
  ● Enabled  ● Disabled  ○ Not Installed

Installation

npm install -g claude-code-hooks@latest

---

Full Changelog: v2.2.0...v2.2.1

v2.2.0 - Complete Hook Management Suite

🛠️ Complete Hook Management Suite

This release adds comprehensive hook management capabilities to the Claude Code Hooks CLI.

🎯 New Hook Management Commands

• Enable/Disable - claude-hooks enable/disable <hook> toggles hooks on/off
• Create - claude-hooks create <name> generates new custom hooks with templates
• Edit - claude-hooks edit <hook> opens hooks in your preferred editor
• Remove - claude-hooks remove <hook> permanently deletes hooks
• Config - claude-hooks config edits Claude Code settings.json

🎨 Enhanced Interactive Menu

• Added "Hook Management" section with all new commands
• Added "Configuration" section for settings and project setup
• Better organization with separators
• Beautiful UI with colors and loading spinners

🧹 Repository Improvements

• Fixed node_modules being tracked in git
• Added proper .gitignore configuration
• Cleaned up repository structure

📦 Installation

```bash
npm install -g claude-code-hooks
```

🚀 Quick Start

Run claude-hooks to launch the interactive menu and explore all the new features!

---

Full Changelog: v2.1.0...v2.2.0

v2.0.0 - Comprehensive Hook Collection

🎉 Claude Code Hooks v2.0.0

This is the first official release of Claude Code Hooks - a comprehensive collection of 16 production-ready hooks designed to enforce coding standards, maintain consistency, and automate workflow tasks.

✨ Highlights

• 16 Production-Ready Hooks - Complete set for quality, security, and workflow automation
• 6 New Advanced Hooks - Added in this release for enhanced capabilities
• Comprehensive Test Suite - All hooks are tested and verified
• Beautiful Documentation - Enhanced README with badges and detailed explanations
• Community Ready - Added LICENSE, CODE_OF_CONDUCT, and CONTRIBUTING guides

🆕 New Hooks in v2.0.0

🔒 Security & Quality

• api-docs-enforcer.py - Ensures API documentation with Swagger/OpenAPI
• no-mock-code.py - Prevents placeholder/mock code in production
• secret-scanner.py - Detects and blocks secrets from being committed
• env-sync-validator.py - Keeps .env and .env.example synchronized
• gitignore-enforcer.py - Ensures proper .gitignore configuration
• readme-update-validator.py - Reminds to update docs when features change

📦 Installation

# Clone the repository
git clone https://github.com/webdevtodayjason/claude-hooks.git
cd claude-hooks

# Run the install script
chmod +x install.sh
./install.sh

🧪 Testing

# Run tests
npm test

# Or run detailed tests
python3 test_hooks.py

📚 Documentation

• Comprehensive README with accordion sections for each hook
• User-friendly explanations in plain English
• Practical examples for every hook
• Contributing guidelines

🙏 Thanks

Thank you to everyone who will use and contribute to this project! Together we can make Claude Code development more efficient and enjoyable.

---

Full Changelog: https://github.com/webdevtodayjason/claude-hooks/blob/main/CHANGELOG.md