Separate resume mode from versioning reset

- Add skip_if_resume parameter to handle_versioning_mode()
- Skip reset prompts when in resume mode
- Update RESUME_MODE.md to clarify distinction between resume and reset
- Resume mode now works independently of versioning.mode

Author: lufftw

tools/ai-markmap-agent/RESUME_MODE.md

@@ -7,6 +7,20 @@ Resume mode allows you to continue execution from a previous pipeline run, suppo
 - Re-running from a specific stage (debug-friendly)
 - Not overwriting original run data (generates new regen run)
 
+## Resume vs Reset
+
+**Important distinction:**
+
+- **`--resume`**: Reuses debug outputs from previous runs to save API calls. This is about **pipeline execution** (whether to run new API calls or reuse existing results).
+
+- **`versioning.mode: reset`**: Deletes old version directories and starts fresh. This is about **version management** (how to organize final output versions).
+
+These two features are **independent**:
+- You can use `--resume` even when `versioning.mode: reset` is set
+- Resume mode reuses debug outputs regardless of versioning mode
+- Versioning reset only affects final output directories, not debug outputs
+- When resuming, versioning reset prompts are skipped (reset applies to final output only)
+
 ## Usage
 
 ### Method 1: Interactive Resume Mode
@@ -95,6 +109,10 @@ All intermediate outputs (including reused and regenerated ones) are saved in th
 2. **API Keys**: Still need to provide API keys (even when reusing stages)
 3. **Configuration consistency**: Resume uses current config, which may differ from original run
 4. **Partial state recovery**: Currently only partial state recovery is supported, some stages may need to be re-run
+5. **Versioning mode**: Resume mode works independently of `versioning.mode`:
+   - If `versioning.mode: reset`, the reset prompt is skipped during resume
+   - Versioning reset only affects final output directories, not debug outputs
+   - You can resume from debug outputs even when versioning is set to reset
 
 ## Future Improvements
 

tools/ai-markmap-agent/main.py

@@ -250,8 +250,11 @@ def main() -> int:
             print("Skipping API key input (--no-openai and/or --no-anthropic specified)\n")
 
         # Step 3: Handle versioning mode (reset prompts here)
+        # Note: In resume mode, versioning is separate - it only affects final output
+        #       Debug outputs are reused regardless of versioning mode
         print("\nChecking versioning mode...")
-        if not handle_versioning_mode(config):
+        is_resume_mode = resume_config is not None
+        if not handle_versioning_mode(config, skip_if_resume=is_resume_mode):
             # User cancelled reset
             return 0
 

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

@@ -156,18 +156,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:
+def handle_versioning_mode(config: dict[str, Any], skip_if_resume: bool = False) -> bool:
     """
     Handle versioning mode before running the pipeline.
     
     For reset mode, prompts user to confirm deletion of old versions.
     
     Args:
         config: Configuration dictionary
+        skip_if_resume: If True and in resume mode, skip versioning checks
+                       (resume mode reuses debug outputs, versioning is separate)
         
     Returns:
         True to continue, False to abort (user cancelled reset)
     """
+    # Check if we're in resume mode
+    if skip_if_resume:
+        # In resume mode, versioning is separate from pipeline execution
+        # We'll still show info but won't prompt for reset
+        versioning = config.get("output", {}).get("versioning", {})
+        versioning_enabled = versioning.get("enabled", False)
+        if versioning_enabled:
+            versioning_mode = versioning.get("mode", "continue")
+            if versioning_mode == "reset":
+                print("  ℹ️  Resume mode: Versioning reset will apply to final output only")
+                print("      (Debug outputs are reused from previous run)")
+            else:
+                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
+    
     versioning = config.get("output", {}).get("versioning", {})
     versioning_enabled = versioning.get("enabled", False)
     versioning_mode = versioning.get("mode", "continue")