feat: add interactive AI mind map generation to build scripts

- Add optional step to generate AI-powered mind maps in build_docs.bat/sh
- Prompt user whether to generate AI mind maps (requires OPENAI_API_KEY)
- Continue build even if AI generation fails
- Update scripts/README.md with AI mind map feature documentation

Author: lufftw

scripts/README.md

@@ -33,6 +33,7 @@ This directory contains utility scripts for project maintenance and development.
 - ✅ No external tools required
 - ✅ Simple one-command build
 - ✅ Fast execution
+- ✅ Interactive prompt for AI mind map generation (optional, requires OPENAI_API_KEY)
 
 📖 **[Full Documentation →](../docs/BUILD_DOCS_MANUAL.md)**
 
@@ -72,6 +73,13 @@ scripts\run_case.bat 0001_two_sum 1
 
 ### Build Documentation
 
+The build script will:
+1. Generate standard mind maps (Markdown)
+2. Generate mind maps (HTML)
+3. **Ask if you want to generate AI-powered mind maps** (requires OPENAI_API_KEY)
+4. Build MkDocs site
+5. Copy mind map files
+
 ```bash
 # Windows
 scripts\build_docs.bat
@@ -80,6 +88,8 @@ scripts\build_docs.bat
 ./scripts/build_docs.sh
 ```
 
+> **Note:** AI mind map generation is optional. The script will prompt you during the build process. You can skip it if you don't have an OpenAI API key configured.
+
 ### Build and Preview Locally
 
 ```bash

scripts/build_docs.bat

@@ -54,31 +54,50 @@ echo ============================================
 echo.
 
 REM Step 1: Generate Mind Maps (Markdown)
-echo [1/4] Generating mind maps (Markdown)...
+echo [1/5] Generating mind maps (Markdown)...
 "%VENV_PYTHON%" tools/generate_mindmaps.py
 if errorlevel 1 (
     echo Error: Failed to generate mind maps
     exit /b 1
 )
 
 REM Step 2: Generate Mind Maps (HTML)
-echo [2/4] Generating mind maps (HTML)...
+echo [2/5] Generating mind maps (HTML)...
 "%VENV_PYTHON%" tools/generate_mindmaps.py --html
 if errorlevel 1 (
     echo Error: Failed to generate HTML mind maps
     exit /b 1
 )
 
-REM Step 3: Build MkDocs site
-echo [3/4] Building MkDocs site...
+REM Step 3: Ask if user wants to generate AI mind maps
+echo.
+echo [3/5] Generate AI-powered mind maps?
+echo Note: This requires OPENAI_API_KEY environment variable
+echo.
+set /p GENERATE_AI="Generate AI mind maps? (Y/N): "
+if /i "%GENERATE_AI%"=="Y" (
+    echo Generating AI mind maps...
+    "%VENV_PYTHON%" tools/generate_mindmaps_ai.py
+    if errorlevel 1 (
+        echo Warning: Failed to generate AI mind maps (may need OPENAI_API_KEY)
+        echo Continuing with build...
+    ) else (
+        echo AI mind maps generated successfully.
+    )
+) else (
+    echo Skipping AI mind map generation.
+)
+
+REM Step 4: Build MkDocs site
+echo [4/5] Building MkDocs site...
 "%VENV_PYTHON%" -m mkdocs build
 if errorlevel 1 (
     echo Error: Failed to build MkDocs site
     exit /b 1
 )
 
-REM Step 4: Copy mind map HTML files
-echo [4/4] Copying mind map HTML files...
+REM Step 5: Copy mind map HTML files
+echo [5/5] Copying mind map HTML files...
 if exist "%PROJECT_ROOT%\docs\pages\mindmaps" (
     xcopy /E /I /Y "%PROJECT_ROOT%\docs\pages\mindmaps" "%PROJECT_ROOT%\site\pages\mindmaps" >nul
 )

scripts/build_docs.sh

@@ -50,31 +50,50 @@ echo "============================================"
 echo ""
 
 # Step 1: Generate Mind Maps (Markdown)
-echo "[1/4] Generating mind maps (Markdown)..."
+echo "[1/5] Generating mind maps (Markdown)..."
 "$VENV_PYTHON" tools/generate_mindmaps.py
 if [ $? -ne 0 ]; then
     echo "Error: Failed to generate mind maps"
     exit 1
 fi
 
 # Step 2: Generate Mind Maps (HTML)
-echo "[2/4] Generating mind maps (HTML)..."
+echo "[2/5] Generating mind maps (HTML)..."
 "$VENV_PYTHON" tools/generate_mindmaps.py --html
 if [ $? -ne 0 ]; then
     echo "Error: Failed to generate HTML mind maps"
     exit 1
 fi
 
-# Step 3: Build MkDocs site
-echo "[3/4] Building MkDocs site..."
+# Step 3: Ask if user wants to generate AI mind maps
+echo ""
+echo "[3/5] Generate AI-powered mind maps?"
+echo "Note: This requires OPENAI_API_KEY environment variable"
+echo ""
+read -p "Generate AI mind maps? (y/N): " GENERATE_AI
+if [ "$GENERATE_AI" = "y" ] || [ "$GENERATE_AI" = "Y" ]; then
+    echo "Generating AI mind maps..."
+    "$VENV_PYTHON" tools/generate_mindmaps_ai.py
+    if [ $? -ne 0 ]; then
+        echo "Warning: Failed to generate AI mind maps (may need OPENAI_API_KEY)"
+        echo "Continuing with build..."
+    else
+        echo "AI mind maps generated successfully."
+    fi
+else
+    echo "Skipping AI mind map generation."
+fi
+
+# Step 4: Build MkDocs site
+echo "[4/5] Building MkDocs site..."
 "$VENV_PYTHON" -m mkdocs build
 if [ $? -ne 0 ]; then
     echo "Error: Failed to build MkDocs site"
     exit 1
 fi
 
-# Step 4: Copy mind map HTML files
-echo "[4/4] Copying mind map HTML files..."
+# Step 5: Copy mind map HTML files
+echo "[5/5] Copying mind map HTML files..."
 if [ -d "$PROJECT_ROOT/docs/pages/mindmaps" ]; then
     cp -r "$PROJECT_ROOT/docs/pages/mindmaps" "$PROJECT_ROOT/site/pages/" 2>/dev/null || true
 fi