feat(ai-markmap-agent): add versioning mode (continue/reset)

- Add versioning.mode config: "continue" | "reset"
- Continue mode: load from latest version (vN), produce vN+1
- Reset mode: prompt to delete all versions, start fresh from baseline
- Add prompt_on_reset config option
- Update DESIGN_V4.md, README.md, README_zh-TW.md with documentation

Author: lufftw

tools/ai-markmap-agent/README.md

@@ -383,6 +383,26 @@ outputs/versions/
 
 Version numbers auto-increment: `v1`, `v2`, `v3`, ...
 
+### Versioning Modes
+
+Configure in `config/config.yaml`:
+
+```yaml
+output:
+  versioning:
+    enabled: true
+    directory: "outputs/versions"
+    mode: "continue"      # continue | reset
+    prompt_on_reset: true
+```
+
+| Mode | Behavior |
+|------|----------|
+| `continue` | Load from latest version (vN), produce vN+1 |
+| `reset` | Delete all versions, start fresh from `input.baseline.path`, produce v1 |
+
+**Reset mode** prompts for confirmation before deleting existing versions.
+
 ---
 
 ## Module Responsibilities

tools/ai-markmap-agent/README_zh-TW.md

@@ -383,6 +383,26 @@ outputs/versions/
 
 版本號自動遞增：`v1`、`v2`、`v3`...
 
+### 版本控制模式
+
+在 `config/config.yaml` 設定：
+
+```yaml
+output:
+  versioning:
+    enabled: true
+    directory: "outputs/versions"
+    mode: "continue"      # continue | reset
+    prompt_on_reset: true
+```
+
+| 模式 | 行為 |
+|------|------|
+| `continue` | 從最新版本 (vN) 繼續精進，產生 vN+1 |
+| `reset` | 刪除所有版本，從 `input.baseline.path` 重新開始，產生 v1 |
+
+**Reset 模式**會在刪除前詢問確認。
+
 ---
 
 ## 模組職責

tools/ai-markmap-agent/config/config.yaml

@@ -128,7 +128,7 @@ experts:
     architect:
       name: "Top Software Architect"
       emoji: "🏗️"
-      model: "gpt-4o"
+      model: "gpt-5.2"
       persona_prompt: "prompts/experts/architect_persona.md"
       behavior_prompt: "prompts/experts/architect_behavior.md"
       temperature: 0.6
@@ -143,7 +143,7 @@ experts:
     professor:
       name: "Distinguished Algorithm Professor"
       emoji: "📚"
-      model: "gpt-4o"
+      model: "gpt-5.2"
       persona_prompt: "prompts/experts/professor_persona.md"
       behavior_prompt: "prompts/experts/professor_behavior.md"
       temperature: 0.5
@@ -158,7 +158,7 @@ experts:
     engineer:
       name: "Senior Principal Engineer"
       emoji: "⚙️"
-      model: "gpt-4o"
+      model: "gpt-5.2"
       persona_prompt: "prompts/experts/engineer_persona.md"
       behavior_prompt: "prompts/experts/engineer_behavior.md"
       temperature: 0.6
@@ -261,12 +261,12 @@ workflow:
 # Writer Configuration
 # -----------------------------------------------------------------------------
 writer:
-  model: "gpt-4o"  # 128K context for full markmap
+  model: "gpt-5.2"  # 128K context for full markmap
   persona_prompt: "prompts/writer/writer_persona.md"
   behavior_prompt: "prompts/writer/writer_behavior.md"
   format_guide: "prompts/writer/markmap_format_guide.md"
   temperature: 0.4
-  max_tokens: 8192
+  max_tokens: 12000
 
   # Writer behavior settings
   preserve_baseline_quality: true  # Don't degrade existing good content
@@ -313,7 +313,15 @@ output:
   versioning:
     enabled: true
     directory: "outputs/versions"
-    # Auto-increment: v1, v2, v3, ...
+    
+    # Execution mode:
+    #   continue - Read from latest version (vN), produce vN+1
+    #   reset    - Delete all versions, start fresh from input.baseline.path, produce v1
+    mode: "reset"
+    
+    # When mode=reset, prompt before deleting old versions
+    # Set to false to auto-delete without confirmation
+    prompt_on_reset: true
 
   final_dirs:
     markdown: "../../docs/mindmaps"

tools/ai-markmap-agent/docs/DESIGN_V4.md

@@ -497,6 +497,19 @@ output:
   naming:
     template: "neetcode_ontology_agent_evolved_{lang}"
     # Produces: neetcode_ontology_agent_evolved_en.md
+  
+  # Version history
+  versioning:
+    enabled: true
+    directory: "outputs/versions"
+    
+    # Execution mode:
+    #   continue - Load from latest version (vN), produce vN+1
+    #   reset    - Delete all versions, start from baseline.path, produce v1
+    mode: "continue"
+    
+    # When mode=reset, prompt before deleting
+    prompt_on_reset: true
 
 # -----------------------------------------------------------------------------
 # Expert Configuration (Scalable)
@@ -842,6 +855,56 @@ Version history:
 
 ---
 
+## Versioning Modes
+
+### Continue Mode (預設)
+
+持續精進，從最新版本繼續：
+
+```yaml
+versioning:
+  mode: "continue"
+```
+
+```
+現有版本: v1, v2, v3
+
+執行流程:
+1. 讀取 v3 的輸出作為 baseline
+2. 專家精進
+3. 產生 v4
+```
+
+### Reset Mode
+
+重新開始，從原始 baseline 出發：
+
+```yaml
+versioning:
+  mode: "reset"
+```
+
+```
+現有版本: v1, v2, v3
+
+執行流程:
+1. 程式詢問：「確定要刪除 v1, v2, v3 嗎？[Y/N]」
+2. Y → 刪除所有版本，從 input.baseline.path 重新開始
+3. N → 程式結束，不做任何事
+4. 產生新的 v1
+```
+
+### 使用場景
+
+| 場景 | 使用模式 |
+|------|---------|
+| 日常迭代精進 | `continue` |
+| 切換新的 baseline 來源 | `reset` |
+| 版本歷史太亂想重來 | `reset` |
+| 測試新的專家配置 | `reset` |
+
+---
+
 ## Summary
 
 ### V4 核心設計

tools/ai-markmap-agent/main.py

@@ -31,7 +31,7 @@
     request_api_keys,
 )
 from src.data_sources import DataSourcesLoader
-from src.graph import run_pipeline, load_baseline_markmap
+from src.graph import run_pipeline, load_baseline_markmap, handle_versioning_mode
 
 
 def print_banner() -> None:
@@ -178,7 +178,13 @@ def main() -> int:
         else:
             print("Skipping API key input (--no-openai and/or --no-anthropic specified)\n")
 
-        # Step 3: Load baseline Markmap
+        # Step 3: Handle versioning mode (reset prompts here)
+        print("\nChecking versioning mode...")
+        if not handle_versioning_mode(config):
+            # User cancelled reset
+            return 0
+        
+        # Step 4: Load baseline Markmap
         print("\nLoading baseline Markmap...")
         if args.baseline:
             baseline_path = Path(args.baseline)
@@ -201,7 +207,7 @@ def main() -> int:
                 print(f"  ⚠ {e}")
                 baseline_markmap = ""
 
-        # Step 4: Load data sources
+        # Step 5: Load data sources
         print("\nLoading reference data...")
         loader = DataSourcesLoader(config)
         data = loader.load_all()
@@ -212,18 +218,18 @@ def main() -> int:
         # Print summary
         print_data_summary(loader.get_summary())
 
-        # Step 5: If dry-run, stop here
+        # Step 6: If dry-run, stop here
         if args.dry_run:
             print("\n[DRY RUN] Data sources loaded successfully. Exiting.")
             return 0
 
-        # Step 6: Check required API keys
+        # Step 7: Check required API keys
         if not args.no_openai and not ConfigLoader.has_api_key("openai"):
             print("\n❌ Error: OpenAI API key is required but not provided.")
             print("   Use --no-openai to skip if not needed.")
             return 1
 
-        # Step 7: Build and run the LangGraph pipeline
+        # Step 8: Build and run the LangGraph pipeline
         print("\n" + "=" * 60)
         print("Starting Markmap Refinement Pipeline")
         print("=" * 60)

tools/ai-markmap-agent/src/graph.py

@@ -31,7 +31,15 @@
     get_adopted_suggestions,
     ConsensusResult,
 )
-from .output.html_converter import save_all_markmaps
+from .output.html_converter import save_all_markmaps, MarkMapHTMLConverter
+
+__all__ = [
+    "run_pipeline",
+    "run_pipeline_async",
+    "build_markmap_graph",
+    "load_baseline_markmap",
+    "handle_versioning_mode",
+]
 from .post_processing import PostProcessor
 from .debug_output import get_debug_manager, reset_debug_manager
 from .config_loader import ConfigLoader
@@ -80,6 +88,10 @@ def load_baseline_markmap(config: dict[str, Any]) -> str:
     """
     Load the baseline Markmap from file.
     
+    Behavior depends on versioning mode:
+    - continue: Load from latest version (vN) if exists, else fall back to baseline.path
+    - reset: Load from baseline.path (original source)
+    
     Args:
         config: Configuration dictionary
         
@@ -90,8 +102,25 @@ def load_baseline_markmap(config: dict[str, Any]) -> str:
     baseline_config = input_config.get("baseline", {})
     baseline_path = baseline_config.get("path", "neetcode_ontology_ai_en.md")
 
-    # Resolve path relative to docs/mindmaps/
+    # Check versioning mode
+    versioning = config.get("output", {}).get("versioning", {})
+    versioning_enabled = versioning.get("enabled", False)
+    versioning_mode = versioning.get("mode", "continue")
+    
     base_dir = Path(__file__).parent.parent.parent.parent  # Go to neetcode root
+    
+    # For continue mode, try to load from latest version first
+    if versioning_enabled and versioning_mode == "continue":
+        converter = MarkMapHTMLConverter(config)
+        latest_path = converter._get_latest_version_path("en")
+        
+        if latest_path and latest_path.exists():
+            print(f"  📂 Continue mode: Loading from {latest_path.parent.name}/{latest_path.name}")
+            return latest_path.read_text(encoding="utf-8")
+        else:
+            print("  📂 Continue mode: No previous version found, using baseline")
+    
+    # Load from configured baseline path
     full_path = base_dir / "docs" / "mindmaps" / baseline_path
 
     if full_path.exists():
@@ -116,6 +145,39 @@ def load_baseline_markmap(config: dict[str, Any]) -> str:
     raise FileNotFoundError(f"Baseline Markmap not found: {full_path}")
 
 
+def handle_versioning_mode(config: dict[str, Any]) -> bool:
+    """
+    Handle versioning mode before running the pipeline.
+    
+    For reset mode, prompts user to confirm deletion of old versions.
+    
+    Args:
+        config: Configuration dictionary
+        
+    Returns:
+        True to continue, False to abort (user cancelled reset)
+    """
+    versioning = config.get("output", {}).get("versioning", {})
+    versioning_enabled = versioning.get("enabled", False)
+    versioning_mode = versioning.get("mode", "continue")
+    
+    if not versioning_enabled:
+        return True
+    
+    if versioning_mode == "reset":
+        converter = MarkMapHTMLConverter(config)
+        return converter.handle_reset_mode()
+    
+    # Continue mode - just show info
+    converter = MarkMapHTMLConverter(config)
+    existing = converter._get_existing_versions()
+    if existing:
+        print(f"  📂 Continue mode: {len(existing)} existing version(s)")
+        print(f"      Latest: {existing[-1].name}")
+    
+    return True
+
+
 def build_markmap_graph(config: dict[str, Any] | None = None) -> StateGraph:
     """
     Build the LangGraph workflow for Markmap refinement.