feat: Add local CI/CD automation with pre-commit hooks for AI mind map generation

- Add pre-commit framework configuration (.pre-commit-config.yaml)
- Create pre-commit hook script (tools/hooks/generate_ai_mindmaps_hook.py)
  - Auto-detects changes in ontology/, meta/problems/, tools/generate_mindmaps.py
  - Supports skip mechanisms via commit message tags or environment variables
  - Interactive API key input (not stored)
  - Works on all branches
- Add pre-commit dependency to requirements.txt
- Update tools/README.md with Local CI/CD Automation section
  - Setup instructions
  - Usage guide with skip options
  - Configuration details
  - Features table
- Update README.md
  - Add pre-commit and local-automation to Topics tags
  - Add Automatic Generation (Local CI/CD) section in AI Mind Map Generation

This enables automatic AI mind map generation on commit when relevant files
are modified, improving developer workflow while maintaining security by
not storing API keys.

Author: lufftw

.pre-commit-config.yaml

@@ -0,0 +1,22 @@
+# Pre-commit configuration for NeetCode project
+# Install: pip install pre-commit
+# Setup: pre-commit install
+
+repos:
+  # Custom local hook for AI mind map generation
+  - repo: local
+    hooks:
+      - id: generate-ai-mindmaps
+        name: Generate AI Mind Maps
+        entry: python tools/hooks/generate_ai_mindmaps_hook.py
+        language: system
+        files: |
+          ^ontology/
+          ^meta/problems/
+          ^tools/generate_mindmaps\.py$
+        pass_filenames: false
+        stages: [pre-commit]
+        verbose: true
+        always_run: false
+
+

README.md

@@ -29,7 +29,7 @@ AEO/GEO: A scalable Python framework with knowledge graph-driven learning, AI-po
 
 ---
 
-**Topics:** `knowledge-graph` `ai-powered` `mind-map` `pattern-recognition` `leetcode` `neetcode-150` `blind-75` `stress-testing` `algorithm-engineering` `performance-benchmarking` `data-driven-testing` `random-test-generation` `judge-function` `algorithm-debugging` `competitive-programming` `python` `vscode-integration` `test-automation` `coding-interview`
+**Topics:** `knowledge-graph` `ai-powered` `mind-map` `pattern-recognition` `leetcode` `neetcode-150` `blind-75` `stress-testing` `algorithm-engineering` `performance-benchmarking` `data-driven-testing` `random-test-generation` `judge-function` `algorithm-debugging` `competitive-programming` `python` `vscode-integration` `test-automation` `pre-commit` `local-automation` `coding-interview`
 
 ---
 
@@ -374,6 +374,29 @@ python tools/generate_mindmaps_ai.py --topic dynamic_programming
 # language = ["en", "zh-TW"]
 ```
 
+### 🔄 Automatic Generation (Local CI/CD)
+
+**Auto-generate AI mind maps on commit** using pre-commit hooks:
+
+```bash
+# Install pre-commit hooks
+pip install pre-commit
+pre-commit install
+```
+
+When you commit changes to `ontology/`, `meta/problems/`, or `tools/generate_mindmaps.py`, the hook automatically runs AI mind map generation.
+
+**Skip when needed:**
+```bash
+# Skip with commit message
+git commit -m "Update ontology [skip-ai]"
+
+# Skip with environment variable
+SKIP_AI_MINDMAPS=true git commit -m "Update ontology"
+```
+
+> 📖 See [tools/README.md](tools/README.md#-local-cicd-automation) for complete setup and usage guide.
+
 ### Configuration
 
 Edit `tools/mindmap_ai_config.toml` to customize:

requirements.txt

@@ -24,3 +24,6 @@ mkdocs-include-markdown-plugin>=7.0.0  # Include markdown files
 # anthropic>=0.18.0    # Anthropic API client (for Claude models)
 # requests>=2.31.0     # HTTP library (for Ollama local LLM)
 
+# Pre-commit hooks framework (for local CI/CD automation):
+pre-commit>=3.5.0      # Git hooks framework for pre-commit checks
+

tools/README.md

@@ -13,6 +13,7 @@ Developer tools for checking, validating, and generating project content.
 | **Generation** | [`generate_mindmaps.py`](#generate_mindmapspy) | Rule-based mind map generation |
 | | [`generate_mindmaps_ai.py`](#generate_mindmaps_aipy) | AI-powered mind map generation |
 | | [`generate_pattern_docs.py`](#generate_pattern_docspy) | Pattern documentation generation |
+| **Automation** | [Pre-commit Hooks](#-local-cicd-automation) | Auto-generate AI mind maps on commit |
 | **Utilities** | [`text_to_mindmap.py`](#text_to_mindmappy) | Convert text to mind map format |
 | | [`prepare_llm_input.py`](#prepare_llm_inputpy) | Prepare LLM input data |
 
@@ -56,6 +57,9 @@ tools/
 ├── text_to_mindmap.py             # Text to mind map converter
 ├── prepare_llm_input.py           # LLM input preparation
 │
+├── hooks/                         # Pre-commit hooks
+│   └── generate_ai_mindmaps_hook.py  # AI mind map generation hook
+│
 ├── mindmaps/                      # Mind map generation module
 │   └── README.md                  # 📖 Detailed technical docs
 ├── patterndocs/                   # Pattern docs generation module
@@ -298,6 +302,90 @@ neetcode/
 
 ---
 
+## 🔄 Local CI/CD Automation
+
+### Pre-commit Hooks
+
+The project uses [pre-commit](https://pre-commit.com/) framework to automatically generate AI mind maps when relevant files are modified.
+
+#### Setup
+
+```bash
+# Install pre-commit (if not already installed)
+pip install pre-commit
+
+# Install Git hooks
+pre-commit install
+```
+
+#### How It Works
+
+When you commit changes to:
+- `ontology/` directory
+- `meta/problems/` directory  
+- `tools/generate_mindmaps.py`
+
+The hook automatically runs `tools/generate_mindmaps_ai.py` to generate AI-powered mind maps.
+
+#### Usage
+
+**Normal workflow (automatic):**
+
+```bash
+# Modify relevant files and commit
+git add ontology/some_file.json
+git commit -m "Update ontology"
+# Hook automatically runs, prompts for API key, generates mind maps
+```
+
+**Skip AI generation:**
+
+```bash
+# Method 1: Use commit message tag
+git commit -m "Update ontology [skip-ai]"
+
+# Method 2: Use environment variable
+# PowerShell
+$env:SKIP_AI_MINDMAPS = "true"
+git commit -m "Update ontology"
+
+# CMD
+set SKIP_AI_MINDMAPS=true
+git commit -m "Update ontology"
+
+# Method 3: Skip all hooks
+git commit --no-verify -m "Update ontology"
+```
+
+**Manual testing:**
+
+```bash
+# Test all hooks
+pre-commit run --all-files
+
+# Test specific hook
+pre-commit run generate-ai-mindmaps --all-files
+```
+
+#### Configuration
+
+- **Config file**: `.pre-commit-config.yaml`
+- **Hook script**: `tools/hooks/generate_ai_mindmaps_hook.py`
+- **API Key**: Interactive input (not stored in any file)
+- **Branch support**: Works on all branches
+
+#### Features
+
+| Feature | Description |
+|---------|-------------|
+| **Auto-detection** | Detects changes in `ontology/`, `meta/problems/`, `tools/generate_mindmaps.py` |
+| **API Key** | Interactive input, never stored |
+| **Skip options** | Multiple ways to skip when needed |
+| **Branch support** | Works on all branches |
+| **Docker Act compatible** | Doesn't interfere with local GitHub Actions testing |
+
+---
+
 ## 🔗 Related Documentation
 
 | Document | Description |

tools/hooks/generate_ai_mindmaps_hook.py

@@ -0,0 +1,164 @@
+#!/usr/bin/env python3
+"""
+Pre-commit hook for generating AI mind maps.
+
+Only runs when:
+1. Files in ontology/, meta/problems/, or tools/generate_mindmaps.py are modified
+2. Not skipped via [skip-ai] in commit message or SKIP_AI_MINDMAPS env var
+
+API Key: Interactive input (not stored)
+"""
+
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+# Project root (assuming hook is in tools/hooks/)
+PROJECT_ROOT = Path(__file__).parent.parent.parent
+TOOLS_DIR = PROJECT_ROOT / 'tools'
+
+
+def get_current_branch() -> str:
+    """Get current Git branch name."""
+    result = subprocess.run(
+        ['git', 'branch', '--show-current'],
+        capture_output=True,
+        text=True,
+        cwd=PROJECT_ROOT
+    )
+    if result.returncode != 0:
+        return ''
+    return result.stdout.strip()
+
+
+def check_changed_files() -> bool:
+    """Check if relevant files were changed in staged area."""
+    result = subprocess.run(
+        ['git', 'diff', '--cached', '--name-only', '--diff-filter=ACM'],
+        capture_output=True,
+        text=True,
+        cwd=PROJECT_ROOT
+    )
+    
+    if result.returncode != 0:
+        return False
+    
+    changed_files = [f.strip() for f in result.stdout.strip().split('\n') if f.strip()]
+    
+    # Check if any relevant file was changed
+    relevant_patterns = [
+        'ontology/',
+        'meta/problems/',
+        'tools/generate_mindmaps.py'
+    ]
+    
+    for file in changed_files:
+        for pattern in relevant_patterns:
+            if file.startswith(pattern) or file == pattern:
+                return True
+    
+    return False
+
+
+def should_skip() -> bool:
+    """Check if AI generation should be skipped."""
+    # Check environment variable
+    if os.environ.get('SKIP_AI_MINDMAPS', '').lower() in ('true', '1', 'yes'):
+        return True
+    
+    # Check commit message (from .git/COMMIT_EDITMSG)
+    commit_msg_file = PROJECT_ROOT / '.git' / 'COMMIT_EDITMSG'
+    if commit_msg_file.exists():
+        try:
+            commit_msg = commit_msg_file.read_text(encoding='utf-8')
+            if '[skip-ai]' in commit_msg or '[no-ai]' in commit_msg:
+                return True
+        except Exception:
+            pass
+    
+    return False
+
+
+def main() -> int:
+    """Main hook function."""
+    # Check if should skip
+    if should_skip():
+        print("ℹ️  AI mind map generation skipped (via [skip-ai] or SKIP_AI_MINDMAPS).")
+        return 0
+    
+    # Check if relevant files changed
+    if not check_changed_files():
+        print("ℹ️  No relevant files changed (ontology/, meta/problems/, tools/generate_mindmaps.py).")
+        print("   Skipping AI mind map generation.")
+        return 0
+    
+    # Get current branch for display
+    current_branch = get_current_branch()
+    
+    # Show what triggered the hook
+    print("=" * 70)
+    print("🔍 Pre-commit Hook: AI Mind Map Generation")
+    print("=" * 70)
+    print(f"📍 Branch: {current_branch}")
+    print("📝 Detected changes in:")
+    print("   - ontology/")
+    print("   - meta/problems/")
+    print("   - tools/generate_mindmaps.py")
+    print("")
+    print("🤖 Running AI mind map generation...")
+    print("")
+    
+    # Check for API key
+    if not os.environ.get('OPENAI_API_KEY'):
+        print("⚠️  OPENAI_API_KEY not set in environment")
+        print("💡 The script will prompt you to enter the API key interactively.")
+        print("   (API key will NOT be stored)")
+        print("")
+    
+    # Run the AI mind map generator
+    script_path = TOOLS_DIR / 'generate_mindmaps_ai.py'
+    
+    if not script_path.exists():
+        print(f"❌ Error: Script not found: {script_path}")
+        return 1
+    
+    try:
+        result = subprocess.run(
+            [sys.executable, str(script_path), '--goal', 'creative'],
+            cwd=PROJECT_ROOT,
+            # Don't capture output so user can see progress and enter API key
+        )
+        
+        if result.returncode == 0:
+            print("")
+            print("=" * 70)
+            print("✅ AI mind map generation completed successfully!")
+            print("=" * 70)
+            return 0
+        else:
+            print("")
+            print("=" * 70)
+            print("❌ AI mind map generation failed!")
+            print("=" * 70)
+            print("")
+            print("💡 Options:")
+            print("   1. Fix the error and commit again")
+            print("   2. Skip this hook: git commit --no-verify")
+            print("   3. Skip with message: git commit -m 'message [skip-ai]'")
+            print("   4. Skip with env var: SKIP_AI_MINDMAPS=true git commit")
+            return 1
+            
+    except KeyboardInterrupt:
+        print("")
+        print("⚠️  Interrupted by user")
+        return 1
+    except Exception as e:
+        print(f"❌ Error running AI mind map generator: {e}")
+        return 1
+
+
+if __name__ == '__main__':
+    sys.exit(main())
+
+