feat: Add update-config, interactive mode, and project detection

Patrick Roebuck · claude · Patrick Roebuck · commit 12340d75ad70 · 2025-11-09T17:01:28.000-05:00
Three optional improvements to enhance user experience: 1. New 'memdocs update-config' command - Update MCP configuration without reinitializing - Useful when templates have been improved - Prompts before overwriting (unless --force) - Shows what was updated with clear messaging Usage: memdocs update-config --mcp memdocs update-config --mcp --force 2. Interactive mode for init - Auto-detects TTY environment - Asks user about MCP setup - Shows helpful context about MCP benefits - Falls back to defaults on Ctrl+C - Can be explicitly enabled/disabled Usage: memdocs init # Auto-detects TTY memdocs init --interactive # Force interactive memdocs init --no-interactive # Force non-interactive 3. Enhanced project detection - Detects project language (Python, JavaScript, Go, Rust, Java, Ruby) - Detects version control (.git) - Detects IDEs (VS Code, JetBrains) - Shows detected language during init - Foundation for future IDE-specific setup Detection logic: Python: setup.py, pyproject.toml JavaScript: package.json Go: go.mod Rust: Cargo.toml Java: pom.xml, build.gradle Ruby: Gemfile Changes: - memdocs/cli_modules/commands/update_config_cmd.py (NEW): - Full update-config command implementation - Interactive confirmation prompts - Clear success messaging - memdocs/cli_modules/commands/init_cmd.py: - Added _detect_project_type() function - Interactive mode with --interactive flag - TTY auto-detection - Shows detected project language - Asks about MCP setup in interactive mode - memdocs/cli.py: - Registered update-config command - memdocs/cli_modules/commands/__init__.py: - Exported update-config command Benefits: - Easier to update configuration after MemDocs upgrades - More guided experience for new users (interactive) - Better understanding of project context - Foundation for future IDE-specific features 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/memdocs/cli.py b/memdocs/cli.py
@@ -20,6 +20,7 @@
     review,
     serve,
     stats,
+    update_config,
 )
 
 # Import classes that tests need to patch (for backward compatibility)
@@ -43,6 +44,7 @@
     "serve",
     "stats",
     "Summarizer",
+    "update_config",
 ]
 
 
@@ -62,6 +64,7 @@ def main(ctx: click.Context) -> None:
 main.add_command(serve)
 main.add_command(doctor)
 main.add_command(stats)
+main.add_command(update_config)
 main.add_command(cleanup)
 
 
diff --git a/memdocs/cli_modules/commands/__init__.py b/memdocs/cli_modules/commands/__init__.py
@@ -10,5 +10,16 @@
 from memdocs.cli_modules.commands.review_cmd import review
 from memdocs.cli_modules.commands.serve_cmd import serve
 from memdocs.cli_modules.commands.stats_cmd import stats
+from memdocs.cli_modules.commands.update_config_cmd import update_config
 
-__all__ = ["cleanup", "doctor", "export", "init", "query", "review", "serve", "stats"]
+__all__ = [
+    "cleanup",
+    "doctor",
+    "export",
+    "init",
+    "query",
+    "review",
+    "serve",
+    "stats",
+    "update_config",
+]
diff --git a/memdocs/cli_modules/commands/init_cmd.py b/memdocs/cli_modules/commands/init_cmd.py
@@ -6,13 +6,55 @@
 import os
 import sys
 from pathlib import Path
+from typing import Optional
 
 import click
 
 from memdocs import cli_output as out
 from memdocs.security import PathValidator
 
 
+def _detect_project_type(cwd: Path) -> dict[str, any]:
+    """Detect project type and return metadata."""
+    project_info: dict[str, any] = {
+        "type": "unknown",
+        "language": None,
+        "source_dir": None,
+        "has_git": False,
+        "has_vscode": False,
+        "has_jetbrains": False,
+    }
+
+    # Check version control
+    project_info["has_git"] = (cwd / ".git").exists()
+
+    # Check IDEs
+    project_info["has_vscode"] = (cwd / ".vscode").exists()
+    project_info["has_jetbrains"] = (cwd / ".idea").exists()
+
+    # Detect language and type
+    if (cwd / "setup.py").exists() or (cwd / "pyproject.toml").exists():
+        project_info["type"] = "python"
+        project_info["language"] = "Python"
+    elif (cwd / "package.json").exists():
+        project_info["type"] = "javascript"
+        project_info["language"] = "JavaScript/TypeScript"
+    elif (cwd / "go.mod").exists():
+        project_info["type"] = "go"
+        project_info["language"] = "Go"
+    elif (cwd / "Cargo.toml").exists():
+        project_info["type"] = "rust"
+        project_info["language"] = "Rust"
+    elif (cwd / "pom.xml").exists() or (cwd / "build.gradle").exists():
+        project_info["type"] = "java"
+        project_info["language"] = "Java"
+    elif (cwd / "Gemfile").exists():
+        project_info["type"] = "ruby"
+        project_info["language"] = "Ruby"
+
+    return project_info
+
+
 def _detect_source_directory(cwd: Path) -> str:
     """Detect the main source directory for the project."""
     common_dirs = ["src", "lib", "app", "pkg", cwd.name]
@@ -135,16 +177,23 @@ def _setup_mcp_infrastructure(cwd: Path) -> None:
     is_flag=True,
     help="Skip VS Code MCP auto-start setup",
 )
-def init(force: bool, no_mcp: bool) -> None:
+@click.option(
+    "--interactive/--no-interactive",
+    default=None,
+    help="Interactive mode (auto-detects TTY if not specified)",
+)
+def init(force: bool, no_mcp: bool, interactive: Optional[bool]) -> None:
     """Initialize MemDocs in the current project.
 
     MCP auto-start is enabled by default for VS Code/Cursor integration.
+    Interactive mode will ask questions if TTY is available.
 
     Examples:
 
-        memdocs init              # With MCP (default)
-        memdocs init --no-mcp     # Skip MCP setup
-        memdocs init --force      # Reinitialize
+        memdocs init                  # With MCP (default)
+        memdocs init --no-mcp         # Skip MCP setup
+        memdocs init --force          # Reinitialize
+        memdocs init --interactive    # Ask questions
     """
     try:
         out.print_header("MemDocs Initialization")
@@ -155,6 +204,39 @@ def init(force: bool, no_mcp: bool) -> None:
             out.error("Current directory is not writable")
             sys.exit(1)
 
+        # Detect project info
+        project_info = _detect_project_type(cwd)
+
+        # Show project detection
+        if project_info["language"]:
+            out.info(f"Detected: {project_info['language']} project")
+
+        # Auto-detect interactive mode based on TTY
+        if interactive is None:
+            interactive = sys.stdin.isatty() and sys.stdout.isatty()
+
+        # Interactive prompts (only if not already set via flags)
+        if interactive and not no_mcp:
+            out.console.print()
+            out.info("[bold]MCP Integration Setup[/bold]")
+            out.console.print(
+                "MCP enables instant AI context in VS Code/Cursor.\n"
+                "The server auto-starts when you open the project."
+            )
+
+            try:
+                # Ask about MCP unless --no-mcp was explicitly passed
+                setup_mcp = click.confirm(
+                    "\nSet up MCP auto-start for VS Code/Cursor?",
+                    default=True,
+                )
+                if not setup_mcp:
+                    no_mcp = True
+            except click.Abort:
+                out.console.print()
+                out.info("Using default: MCP enabled")
+                no_mcp = False
+
         config_path = Path(".memdocs.yml")
         docs_dir = Path(".memdocs/docs")
         memory_dir = Path(".memdocs/memory")
diff --git a/memdocs/cli_modules/commands/update_config_cmd.py b/memdocs/cli_modules/commands/update_config_cmd.py
@@ -0,0 +1,112 @@
+"""
+Update-config command - Update MCP configuration without reinitializing.
+"""
+
+import sys
+from pathlib import Path
+
+import click
+
+from memdocs import cli_output as out
+from memdocs.cli_modules.commands.init_cmd import _setup_mcp_infrastructure
+
+
+@click.command()
+@click.option(
+    "--mcp",
+    is_flag=True,
+    help="Update MCP integration (VS Code tasks/settings)",
+)
+@click.option(
+    "--force",
+    is_flag=True,
+    help="Overwrite existing configuration files",
+)
+def update_config(mcp: bool, force: bool) -> None:
+    """Update MemDocs configuration files.
+
+    Useful for updating VS Code tasks, settings, or MCP configuration
+    when MemDocs templates have been improved or you want to refresh
+    your setup without reinitializing.
+
+    Examples:
+
+        memdocs update-config --mcp         # Update MCP setup
+        memdocs update-config --mcp --force # Overwrite existing
+    """
+    try:
+        out.print_header("MemDocs Configuration Update")
+
+        cwd = Path.cwd()
+
+        # Check if MemDocs is initialized
+        config_path = Path(".memdocs.yml")
+        if not config_path.exists():
+            out.error("MemDocs not initialized in this directory")
+            out.info("Run: [cyan]memdocs init[/cyan]")
+            sys.exit(1)
+
+        if not mcp:
+            out.warning("No update target specified")
+            out.info("Use [cyan]--mcp[/cyan] to update MCP integration")
+            out.info("Example: [cyan]memdocs update-config --mcp[/cyan]")
+            sys.exit(1)
+
+        # Update MCP configuration
+        if mcp:
+            vscode_dir = cwd / ".vscode"
+            tasks_file = vscode_dir / "tasks.json"
+            settings_file = vscode_dir / "settings.json"
+
+            # Check if files exist and warn if not forcing
+            if not force:
+                if tasks_file.exists() or settings_file.exists():
+                    out.warning("MCP configuration files already exist")
+                    out.info("Use [cyan]--force[/cyan] to overwrite")
+                    out.console.print()
+
+                    if tasks_file.exists():
+                        out.info(f"Existing: [cyan]{tasks_file}[/cyan]")
+                    if settings_file.exists():
+                        out.info(f"Existing: [cyan]{settings_file}[/cyan]")
+
+                    try:
+                        response = click.confirm("Overwrite existing files?", default=False)
+                        if not response:
+                            out.info("Update cancelled")
+                            sys.exit(0)
+                    except click.Abort:
+                        out.info("Update cancelled")
+                        sys.exit(0)
+
+            # Update MCP infrastructure
+            out.console.print()
+            _setup_mcp_infrastructure(cwd)
+
+            # Show success message
+            out.console.print()
+            out.print_rule("Update Complete", style="green")
+            out.console.print()
+
+            out.panel(
+                """[bold green]✓ MCP configuration updated![/bold green]
+
+Your VS Code/Cursor setup has been refreshed with the latest
+MemDocs MCP integration templates.
+
+[bold]What's updated:[/bold]
+• .vscode/tasks.json - MCP server auto-start task
+• .vscode/settings.json - Auto-task execution settings
+
+[bold]Next steps:[/bold]
+• Reload VS Code/Cursor: [cyan]Cmd+Shift+P → "Reload Window"[/cyan]
+• Verify setup: [cyan]memdocs doctor[/cyan]
+• Start server: [cyan]memdocs serve --mcp[/cyan]""",
+                title="All Set!",
+                style="green",
+            )
+
+    except Exception as e:
+        out.console.print()
+        out.error(f"Configuration update failed: {e}")
+        sys.exit(1)
