mcp-ticketer 0.12.0__py3-none-any.whl → 2.0.1__py3-none-any.whl

mcp_ticketer/cli/configure.py

@@ -1,6 +1,7 @@
 """Interactive configuration wizard for MCP Ticketer."""
 
 import os
+from collections.abc import Callable
 from typing import Any
 
 import typer
@@ -22,6 +23,61 @@ from ..core.project_config import (
 console = Console()
 
 
+def _retry_setting(
+    setting_name: str,
+    prompt_func: Callable[[], Any],
+    validate_func: Callable[[Any], tuple[bool, str | None]],
+    max_retries: int = 3,
+) -> Any:
+    """Retry a configuration setting with validation.
+
+    Args:
+    ----
+        setting_name: Human-readable name of the setting
+        prompt_func: Function that prompts for the setting value
+        validate_func: Function that validates the value (returns tuple of success, error_msg)
+        max_retries: Maximum number of retry attempts
+
+    Returns:
+    -------
+        Validated setting value
+
+    Raises:
+    ------
+        typer.Exit: If max retries exceeded
+
+    """
+    for attempt in range(1, max_retries + 1):
+        try:
+            value = prompt_func()
+            is_valid, error = validate_func(value)
+
+            if is_valid:
+                return value
+            console.print(f"[red]✗ {error}[/red]")
+            if attempt < max_retries:
+                console.print(
+                    f"[yellow]Attempt {attempt}/{max_retries} - Please try again[/yellow]"
+                )
+            else:
+                console.print(f"[red]Failed after {max_retries} attempts[/red]")
+                retry = Confirm.ask("Retry this setting?", default=True)
+                if retry:
+                    # Extend attempts
+                    max_retries += 3
+                    console.print(
+                        f"[yellow]Extending retries (new limit: {max_retries})[/yellow]"
+                    )
+                    continue
+                raise typer.Exit(1) from None
+        except KeyboardInterrupt:
+            console.print("\n[yellow]Configuration cancelled[/yellow]")
+            raise typer.Exit(0) from None
+
+    console.print(f"[red]Could not configure {setting_name}[/red]")
+    raise typer.Exit(1)
+
+
 def configure_wizard() -> None:
     """Run interactive configuration wizard."""
     console.print(
@@ -97,173 +153,853 @@ def _configure_single_adapter() -> TicketerConfig:
     adapter_type = adapter_type_map[adapter_choice]
 
     # Configure the selected adapter
+    default_values: dict[str, str] = {}
     if adapter_type == AdapterType.LINEAR:
-        adapter_config = _configure_linear()
+        adapter_config, default_values = _configure_linear(interactive=True)
     elif adapter_type == AdapterType.JIRA:
-        adapter_config = _configure_jira()
+        adapter_config, default_values = _configure_jira(interactive=True)
     elif adapter_type == AdapterType.GITHUB:
-        adapter_config = _configure_github()
+        adapter_config, default_values = _configure_github(interactive=True)
     else:
-        adapter_config = _configure_aitrackdown()
+        adapter_config, default_values = _configure_aitrackdown(interactive=True)
 
-    # Create config
+    # Create config with default values
     config = TicketerConfig(
         default_adapter=adapter_type.value,
         adapters={adapter_type.value: adapter_config},
+        default_user=default_values.get("default_user"),
+        default_project=default_values.get("default_project"),
+        default_epic=default_values.get("default_epic"),
+        default_tags=default_values.get("default_tags"),
     )
 
     return config
 
 
-def _configure_linear() -> AdapterConfig:
-    """Configure Linear adapter."""
-    console.print("\n[bold]Configure Linear Integration:[/bold]")
+def _configure_linear(
+    existing_config: dict[str, Any] | None = None,
+    interactive: bool = True,
+    api_key: str | None = None,
+    team_id: str | None = None,
+    team_key: str | None = None,
+    **kwargs: Any,
+) -> tuple[AdapterConfig, dict[str, Any]]:
+    """Configure Linear adapter with option to preserve existing settings.
 
-    # API Key
-    api_key = os.getenv("LINEAR_API_KEY") or ""
-    if api_key:
-        console.print("[dim]Found LINEAR_API_KEY in environment[/dim]")
-        use_env = Confirm.ask("Use this API key?", default=True)
-        if not use_env:
-            api_key = ""
+    Supports both interactive (wizard) and programmatic (init command) modes.
 
-    if not api_key:
-        api_key = Prompt.ask("Linear API Key", password=True)
+    Args:
+    ----
+        existing_config: Optional existing configuration to preserve/update
+        interactive: If True, prompt user for missing values (default: True)
+        api_key: Pre-provided API key (optional, for programmatic mode)
+        team_id: Pre-provided team ID (optional, for programmatic mode)
+        team_key: Pre-provided team key (optional, for programmatic mode)
+        **kwargs: Additional configuration parameters
+
+    Returns:
+    -------
+        Tuple of (AdapterConfig, default_values_dict)
+        - AdapterConfig: Configured Linear adapter configuration
+        - default_values_dict: Dictionary containing default_user, default_epic, default_project, default_tags
 
-    # Team ID
-    team_id = Prompt.ask("Team ID (optional, e.g., team-abc)", default="")
+    """
+    if interactive:
+        console.print("\n[bold cyan]Linear Configuration[/bold cyan]")
 
-    # Team Key
-    team_key = Prompt.ask("Team Key (optional, e.g., ENG)", default="")
+    # Check if we have existing config
+    has_existing = (
+        existing_config is not None and existing_config.get("adapter") == "linear"
+    )
 
-    # Project ID
-    project_id = Prompt.ask("Project ID (optional)", default="")
+    config_dict: dict[str, Any] = {"adapter": AdapterType.LINEAR.value}
 
-    config_dict = {
-        "adapter": AdapterType.LINEAR.value,
-        "api_key": api_key,
-    }
+    if has_existing and interactive:
+        preserve = Confirm.ask(
+            "Existing Linear configuration found. Preserve current settings?",
+            default=True,
+        )
+        if preserve:
+            console.print("[green]✓[/green] Keeping existing configuration")
+            config_dict = existing_config.copy()
+
+            # Allow updating specific fields
+            update_fields = Confirm.ask("Update specific fields?", default=False)
+            if not update_fields:
+                # Extract default values before returning
+                default_values = {}
+                if "user_email" in config_dict:
+                    default_values["default_user"] = config_dict.pop("user_email")
+                if "default_epic" in config_dict:
+                    default_values["default_epic"] = config_dict.pop("default_epic")
+                if "default_project" in config_dict:
+                    default_values["default_project"] = config_dict.pop(
+                        "default_project"
+                    )
+                if "default_tags" in config_dict:
+                    default_values["default_tags"] = config_dict.pop("default_tags")
+                return AdapterConfig.from_dict(config_dict), default_values
+
+            console.print(
+                "[yellow]Enter new values or press Enter to keep current[/yellow]"
+            )
 
-    if team_id:
-        config_dict["team_id"] = team_id
-    if team_key:
-        config_dict["team_key"] = team_key
-    if project_id:
-        config_dict["project_id"] = project_id
+    # API Key (programmatic mode: use provided value or env, interactive: prompt)
+    current_key = config_dict.get("api_key", "") if has_existing else ""
+    final_api_key = api_key or os.getenv("LINEAR_API_KEY") or ""
+
+    if interactive:
+        # Interactive mode: prompt with retry
+        if final_api_key and not current_key:
+            console.print("[dim]Found LINEAR_API_KEY in environment[/dim]")
+            use_env = Confirm.ask("Use this API key?", default=True)
+            if use_env:
+                current_key = final_api_key
+
+        def prompt_api_key() -> str:
+            if current_key:
+                api_key_prompt = f"Linear API Key [current: {'*' * 8}...]"
+                return Prompt.ask(api_key_prompt, password=True, default=current_key)
+            return Prompt.ask("Linear API Key", password=True)
+
+        def validate_api_key(key: str) -> tuple[bool, str | None]:
+            if not key or len(key) < 10:
+                return False, "API key must be at least 10 characters"
+            return True, None
+
+        final_api_key = _retry_setting("API Key", prompt_api_key, validate_api_key)
+    elif not final_api_key:
+        raise ValueError(
+            "Linear API key is required (provide api_key parameter or set LINEAR_API_KEY environment variable)"
+        )
 
-    # Validate
+    config_dict["api_key"] = final_api_key
+
+    # Team Key/ID (programmatic mode: use provided values, interactive: prompt)
+    current_team_key = config_dict.get("team_key", "") if has_existing else ""
+    config_dict.get("team_id", "") if has_existing else ""
+    final_team_key = team_key or os.getenv("LINEAR_TEAM_KEY") or ""
+    final_team_id = team_id or os.getenv("LINEAR_TEAM_ID") or ""
+
+    if interactive:
+        # Interactive mode: prompt for team key (preferred over team_id)
+        def prompt_team_key() -> str:
+            if current_team_key:
+                team_key_prompt = f"Linear Team Key [current: {current_team_key}]"
+                return Prompt.ask(team_key_prompt, default=current_team_key)
+            return Prompt.ask("Linear Team Key (e.g., 'ENG', 'BTA')")
+
+        def validate_team_key(key: str) -> tuple[bool, str | None]:
+            if not key or len(key) < 2:
+                return False, "Team key must be at least 2 characters"
+            return True, None
+
+        final_team_key = _retry_setting("Team Key", prompt_team_key, validate_team_key)
+        config_dict["team_key"] = final_team_key
+
+        # Remove team_id if present (will be resolved from team_key)
+        if "team_id" in config_dict:
+            del config_dict["team_id"]
+    else:
+        # Programmatic mode: use whichever was provided
+        if final_team_key:
+            config_dict["team_key"] = final_team_key
+        if final_team_id:
+            config_dict["team_id"] = final_team_id
+        if not final_team_key and not final_team_id:
+            raise ValueError(
+                "Linear requires either team_key or team_id (provide parameter or set LINEAR_TEAM_KEY/LINEAR_TEAM_ID environment variable)"
+            )
+
+    # User email configuration (optional, for default assignee) - only in interactive mode
+    if interactive:
+        current_user_email = config_dict.get("user_email", "") if has_existing else ""
+
+        def prompt_user_email() -> str:
+            if current_user_email:
+                user_email_prompt = (
+                    f"Your Linear email (optional, for auto-assignment) "
+                    f"[current: {current_user_email}]"
+                )
+                return Prompt.ask(user_email_prompt, default=current_user_email)
+            return Prompt.ask(
+                "Your Linear email (optional, for auto-assignment)", default=""
+            )
+
+        def validate_user_email(email: str) -> tuple[bool, str | None]:
+            if not email:  # Optional field
+                return True, None
+            import re
+
+            email_pattern = re.compile(
+                r"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$"
+            )
+            if not email_pattern.match(email):
+                return False, f"Invalid email format: {email}"
+            return True, None
+
+        user_email = _retry_setting(
+            "User Email", prompt_user_email, validate_user_email
+        )
+        if user_email:
+            config_dict["user_email"] = user_email
+            console.print(f"[green]✓[/green] Will use {user_email} as default assignee")
+
+        # ============================================================
+        # DEFAULT VALUES SECTION (for ticket creation)
+        # ============================================================
+
+        console.print("\n[bold cyan]Default Values (Optional)[/bold cyan]")
+        console.print("Configure default values for ticket creation:")
+
+        # Default epic/project
+        current_default_epic = (
+            config_dict.get("default_epic", "") if has_existing else ""
+        )
+
+        def prompt_default_epic() -> str:
+            if current_default_epic:
+                return Prompt.ask(
+                    f"Default epic/project ID (optional) [current: {current_default_epic}]",
+                    default=current_default_epic,
+                )
+            return Prompt.ask(
+                "Default epic/project ID (optional, accepts project URLs or IDs like 'PROJ-123')",
+                default="",
+            )
+
+        def validate_default_epic(epic_id: str) -> tuple[bool, str | None]:
+            if not epic_id:  # Optional field
+                return True, None
+            # Basic validation - just check it's not empty when provided
+            if len(epic_id.strip()) < 2:
+                return False, "Epic/project ID must be at least 2 characters"
+            return True, None
+
+        default_epic = _retry_setting(
+            "Default Epic/Project", prompt_default_epic, validate_default_epic
+        )
+        if default_epic:
+            config_dict["default_epic"] = default_epic
+            config_dict["default_project"] = default_epic  # Set both for compatibility
+            console.print(
+                f"[green]✓[/green] Will use '{default_epic}' as default epic/project"
+            )
+
+        # Default tags
+        current_default_tags = (
+            config_dict.get("default_tags", []) if has_existing else []
+        )
+
+        def prompt_default_tags() -> str:
+            if current_default_tags:
+                tags_str = ", ".join(current_default_tags)
+                return Prompt.ask(
+                    f"Default tags (optional, comma-separated) [current: {tags_str}]",
+                    default=tags_str,
+                )
+            return Prompt.ask(
+                "Default tags (optional, comma-separated, e.g., 'bug,urgent')",
+                default="",
+            )
+
+        def validate_default_tags(tags_input: str) -> tuple[bool, str | None]:
+            if not tags_input:  # Optional field
+                return True, None
+            # Parse and validate tags
+            tags = [tag.strip() for tag in tags_input.split(",") if tag.strip()]
+            if not tags:
+                return False, "Please provide at least one tag or leave empty"
+            # Check each tag is reasonable
+            for tag in tags:
+                if len(tag) < 2:
+                    return False, f"Tag '{tag}' must be at least 2 characters"
+                if len(tag) > 50:
+                    return False, f"Tag '{tag}' is too long (max 50 characters)"
+            return True, None
+
+        default_tags_input = _retry_setting(
+            "Default Tags", prompt_default_tags, validate_default_tags
+        )
+        if default_tags_input:
+            default_tags = [
+                tag.strip() for tag in default_tags_input.split(",") if tag.strip()
+            ]
+            config_dict["default_tags"] = default_tags
+            console.print(f"[green]✓[/green] Will use tags: {', '.join(default_tags)}")
+
+    # Validate with detailed error reporting
     is_valid, error = ConfigValidator.validate_linear_config(config_dict)
+
     if not is_valid:
-        console.print(f"[red]Configuration error: {error}[/red]")
+        console.print("\n[red]❌ Configuration Validation Failed[/red]")
+        console.print(f"[red]Error: {error}[/red]\n")
+
+        # Show which settings were problematic
+        console.print("[yellow]Problematic settings:[/yellow]")
+        if "api_key" not in config_dict or not config_dict["api_key"]:
+            console.print("  • [red]API Key[/red] - Missing or empty")
+        if "team_key" not in config_dict and "team_id" not in config_dict:
+            console.print(
+                "  • [red]Team Key/ID[/red] - Neither team_key nor team_id provided"
+            )
+        if "user_email" in config_dict:
+            email = config_dict["user_email"]
+            import re
+
+            if not re.match(r"^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$", email):
+                console.print(f"  • [red]User Email[/red] - Invalid format: {email}")
+
+        # Offer to retry specific settings
+        console.print("\n[cyan]Options:[/cyan]")
+        console.print("  1. Retry configuration from scratch")
+        console.print("  2. Fix specific settings")
+        console.print("  3. Exit")
+
+        choice = Prompt.ask("Choose an option", choices=["1", "2", "3"], default="2")
+
+        if choice == "1":
+            # Recursive retry
+            return _configure_linear(existing_config=None)
+        if choice == "2":
+            # Fix specific settings
+            return _configure_linear(existing_config=config_dict)
         raise typer.Exit(1) from None
 
-    return AdapterConfig.from_dict(config_dict)
+    console.print("[green]✓ Configuration validated successfully[/green]")
+
+    # Extract default values to return separately (not part of AdapterConfig)
+    default_values = {}
+    if "user_email" in config_dict:
+        default_values["default_user"] = config_dict.pop("user_email")
+    if "default_epic" in config_dict:
+        default_values["default_epic"] = config_dict.pop("default_epic")
+    if "default_project" in config_dict:
+        default_values["default_project"] = config_dict.pop("default_project")
+    if "default_tags" in config_dict:
+        default_values["default_tags"] = config_dict.pop("default_tags")
 
+    return AdapterConfig.from_dict(config_dict), default_values
 
-def _configure_jira() -> AdapterConfig:
-    """Configure JIRA adapter."""
-    console.print("\n[bold]Configure JIRA Integration:[/bold]")
 
-    # Server URL
-    server = os.getenv("JIRA_SERVER") or ""
-    if not server:
-        server = Prompt.ask("JIRA Server URL (e.g., https://company.atlassian.net)")
+def _configure_jira(
+    interactive: bool = True,
+    server: str | None = None,
+    email: str | None = None,
+    api_token: str | None = None,
+    project_key: str | None = None,
+    **kwargs: Any,
+) -> tuple[AdapterConfig, dict[str, Any]]:
+    """Configure JIRA adapter.
+
+    Supports both interactive (wizard) and programmatic (init command) modes.
+
+    Args:
+    ----
+        interactive: If True, prompt user for missing values (default: True)
+        server: Pre-provided JIRA server URL (optional)
+        email: Pre-provided JIRA user email (optional)
+        api_token: Pre-provided JIRA API token (optional)
+        project_key: Pre-provided default project key (optional)
+        **kwargs: Additional configuration parameters
+
+    Returns:
+    -------
+        Tuple of (AdapterConfig, default_values_dict)
+        - AdapterConfig: Configured JIRA adapter configuration
+        - default_values_dict: Dictionary containing default_user, default_epic, default_project, default_tags
+
+    """
+    if interactive:
+        console.print("\n[bold]Configure JIRA Integration:[/bold]")
+
+    # Server URL (programmatic mode: use provided value or env, interactive: prompt)
+    final_server = server or os.getenv("JIRA_SERVER") or ""
+    if interactive and not final_server:
+        final_server = Prompt.ask(
+            "JIRA Server URL (e.g., https://company.atlassian.net)"
+        )
+    elif not interactive and not final_server:
+        raise ValueError(
+            "JIRA server URL is required (provide server parameter or set JIRA_SERVER environment variable)"
+        )
 
-    # Email
-    email = os.getenv("JIRA_EMAIL") or ""
-    if not email:
-        email = Prompt.ask("JIRA User Email")
+    # Email (programmatic mode: use provided value or env, interactive: prompt)
+    final_email = email or os.getenv("JIRA_EMAIL") or ""
+    if interactive and not final_email:
+        final_email = Prompt.ask("JIRA User Email")
+    elif not interactive and not final_email:
+        raise ValueError(
+            "JIRA email is required (provide email parameter or set JIRA_EMAIL environment variable)"
+        )
 
-    # API Token
-    api_token = os.getenv("JIRA_API_TOKEN") or ""
-    if not api_token:
+    # API Token (programmatic mode: use provided value or env, interactive: prompt)
+    final_api_token = api_token or os.getenv("JIRA_API_TOKEN") or ""
+    if interactive and not final_api_token:
         console.print(
             "[dim]Generate token at: https://id.atlassian.com/manage/api-tokens[/dim]"
         )
-        api_token = Prompt.ask("JIRA API Token", password=True)
+        final_api_token = Prompt.ask("JIRA API Token", password=True)
+    elif not interactive and not final_api_token:
+        raise ValueError(
+            "JIRA API token is required (provide api_token parameter or set JIRA_API_TOKEN environment variable)"
+        )
 
-    # Project Key
-    project_key = Prompt.ask("Default Project Key (optional, e.g., PROJ)", default="")
+    # Project Key (optional)
+    final_project_key = project_key or os.getenv("JIRA_PROJECT_KEY") or ""
+    if interactive and not final_project_key:
+        final_project_key = Prompt.ask(
+            "Default Project Key (optional, e.g., PROJ)", default=""
+        )
 
     config_dict = {
         "adapter": AdapterType.JIRA.value,
-        "server": server.rstrip("/"),
-        "email": email,
-        "api_token": api_token,
+        "server": final_server.rstrip("/"),
+        "email": final_email,
+        "api_token": final_api_token,
     }
 
-    if project_key:
-        config_dict["project_key"] = project_key
+    if final_project_key:
+        config_dict["project_key"] = final_project_key
 
     # Validate
     is_valid, error = ConfigValidator.validate_jira_config(config_dict)
     if not is_valid:
-        console.print(f"[red]Configuration error: {error}[/red]")
-        raise typer.Exit(1) from None
+        if interactive:
+            console.print(f"[red]Configuration error: {error}[/red]")
+            raise typer.Exit(1) from None
+        raise ValueError(f"JIRA configuration validation failed: {error}")
+
+    # ============================================================
+    # DEFAULT VALUES SECTION (for ticket creation)
+    # ============================================================
+    default_values = {}
+
+    if interactive:
+        console.print("\n[bold cyan]Default Values (Optional)[/bold cyan]")
+        console.print("Configure default values for ticket creation:")
+
+        # Default user/assignee
+        user_input = Prompt.ask(
+            "Default assignee/user (optional, JIRA username or email)",
+            default="",
+            show_default=False,
+        )
+        if user_input:
+            default_values["default_user"] = user_input
+            console.print(
+                f"[green]✓[/green] Will use '{user_input}' as default assignee"
+            )
 
-    return AdapterConfig.from_dict(config_dict)
+        # Default epic/project
+        epic_input = Prompt.ask(
+            "Default epic/project ID (optional, e.g., 'PROJ-123')",
+            default="",
+            show_default=False,
+        )
+        if epic_input:
+            default_values["default_epic"] = epic_input
+            default_values["default_project"] = epic_input  # Compatibility
+            console.print(
+                f"[green]✓[/green] Will use '{epic_input}' as default epic/project"
+            )
 
+        # Default tags
+        tags_input = Prompt.ask(
+            "Default tags/labels (optional, comma-separated, e.g., 'bug,urgent')",
+            default="",
+            show_default=False,
+        )
+        if tags_input:
+            tags_list = [t.strip() for t in tags_input.split(",") if t.strip()]
+            if tags_list:
+                default_values["default_tags"] = tags_list
+                console.print(f"[green]✓[/green] Will use tags: {', '.join(tags_list)}")
 
-def _configure_github() -> AdapterConfig:
-    """Configure GitHub adapter."""
-    console.print("\n[bold]Configure GitHub Integration:[/bold]")
+    return AdapterConfig.from_dict(config_dict), default_values
 
-    # Token
-    token = os.getenv("GITHUB_TOKEN") or ""
-    if token:
-        console.print("[dim]Found GITHUB_TOKEN in environment[/dim]")
-        use_env = Confirm.ask("Use this token?", default=True)
-        if not use_env:
-            token = ""
 
-    if not token:
-        console.print(
-            "[dim]Create token at: https://github.com/settings/tokens/new[/dim]"
+def _configure_github(
+    interactive: bool = True,
+    token: str | None = None,
+    repo_url: str | None = None,
+    owner: str | None = None,
+    repo: str | None = None,
+    **kwargs: Any,
+) -> tuple[AdapterConfig, dict[str, Any]]:
+    """Configure GitHub adapter.
+
+    Supports both interactive (wizard) and programmatic (init command) modes.
+
+    Args:
+    ----
+        interactive: If True, prompt user for missing values (default: True)
+        token: Pre-provided GitHub Personal Access Token (optional)
+        repo_url: Pre-provided GitHub repository URL (optional, preferred)
+        owner: Pre-provided repository owner (optional, fallback)
+        repo: Pre-provided repository name (optional, fallback)
+        **kwargs: Additional configuration parameters
+
+    Returns:
+    -------
+        Tuple of (AdapterConfig, default_values_dict)
+        - AdapterConfig: Configured GitHub adapter configuration
+        - default_values_dict: Dictionary containing default_user, default_epic, default_project, default_tags
+
+    """
+    if interactive:
+        console.print("\n[bold]Configure GitHub Integration:[/bold]")
+
+    # Token (programmatic mode: use provided value or env, interactive: prompt)
+    final_token = token or os.getenv("GITHUB_TOKEN") or ""
+    if interactive:
+        if final_token:
+            console.print("[dim]Found GITHUB_TOKEN in environment[/dim]")
+            use_env = Confirm.ask("Use this token?", default=True)
+            if not use_env:
+                final_token = ""
+
+        if not final_token:
+            console.print(
+                "[dim]Create token at: https://github.com/settings/tokens/new[/dim]"
+            )
+            console.print(
+                "[dim]Required scopes: repo (or public_repo for public repos)[/dim]"
+            )
+            final_token = Prompt.ask("GitHub Personal Access Token", password=True)
+    elif not final_token:
+        raise ValueError(
+            "GitHub token is required (provide token parameter or set GITHUB_TOKEN environment variable)"
         )
+
+    # Repository URL/Owner/Repo - Prioritize repo_url, fallback to owner/repo
+    # Programmatic mode: use repo_url or GITHUB_REPO_URL env, fallback to owner/repo
+    final_owner = ""
+    final_repo = ""
+
+    # Step 1: Try to get URL from parameter or environment
+    url_input = repo_url or os.getenv("GITHUB_REPO_URL") or ""
+
+    # Step 2: Parse URL if provided
+    if url_input:
+        from ..core.url_parser import parse_github_repo_url
+
+        parsed_owner, parsed_repo, error = parse_github_repo_url(url_input)
+        if parsed_owner and parsed_repo:
+            final_owner = parsed_owner
+            final_repo = parsed_repo
+            if interactive:
+                console.print(
+                    f"[dim]✓ Extracted repository: {final_owner}/{final_repo}[/dim]"
+                )
+        else:
+            # URL parsing failed
+            if interactive:
+                console.print(f"[yellow]Warning: {error}[/yellow]")
+            else:
+                raise ValueError(f"Failed to parse GitHub repository URL: {error}")
+
+    # Step 3: Interactive mode - prompt for URL if not provided
+    if interactive and not final_owner and not final_repo:
         console.print(
-            "[dim]Required scopes: repo (or public_repo for public repos)[/dim]"
+            "[dim]Enter your GitHub repository URL (e.g., https://github.com/owner/repo)[/dim]"
         )
-        token = Prompt.ask("GitHub Personal Access Token", password=True)
 
-    # Repository Owner
-    owner = os.getenv("GITHUB_OWNER") or ""
-    if not owner:
-        owner = Prompt.ask("Repository Owner (username or org)")
+        # Keep prompting until we get a valid URL
+        while not final_owner or not final_repo:
+            from ..core.url_parser import parse_github_repo_url
+
+            url_prompt = Prompt.ask(
+                "GitHub Repository URL",
+                default="https://github.com/",
+            )
+
+            parsed_owner, parsed_repo, error = parse_github_repo_url(url_prompt)
+            if parsed_owner and parsed_repo:
+                final_owner = parsed_owner
+                final_repo = parsed_repo
+                console.print(f"[dim]✓ Repository: {final_owner}/{final_repo}[/dim]")
+                break
+            else:
+                console.print(f"[red]Error: {error}[/red]")
+                console.print(
+                    "[yellow]Please enter a valid GitHub repository URL[/yellow]"
+                )
 
-    # Repository Name
-    repo = os.getenv("GITHUB_REPO") or ""
-    if not repo:
-        repo = Prompt.ask("Repository Name")
+    # Step 4: Non-interactive fallback - use individual owner/repo parameters
+    if not final_owner or not final_repo:
+        fallback_owner = owner or os.getenv("GITHUB_OWNER") or ""
+        fallback_repo = repo or os.getenv("GITHUB_REPO") or ""
+
+        # In non-interactive mode, both must be provided if URL wasn't
+        if not interactive:
+            if not fallback_owner or not fallback_repo:
+                raise ValueError(
+                    "GitHub repository is required. Provide either:\n"
+                    "  - repo_url parameter or GITHUB_REPO_URL environment variable, OR\n"
+                    "  - Both owner and repo parameters (or GITHUB_OWNER/GITHUB_REPO environment variables)"
+                )
+            final_owner = fallback_owner
+            final_repo = fallback_repo
+        else:
+            # Interactive mode with fallback values
+            if fallback_owner:
+                final_owner = fallback_owner
+            if fallback_repo:
+                final_repo = fallback_repo
 
     config_dict = {
         "adapter": AdapterType.GITHUB.value,
-        "token": token,
-        "owner": owner,
-        "repo": repo,
-        "project_id": f"{owner}/{repo}",  # Convenience field
+        "token": final_token,
+        "owner": final_owner,
+        "repo": final_repo,
+        "project_id": f"{final_owner}/{final_repo}",  # Convenience field
     }
 
     # Validate
     is_valid, error = ConfigValidator.validate_github_config(config_dict)
     if not is_valid:
-        console.print(f"[red]Configuration error: {error}[/red]")
-        raise typer.Exit(1) from None
+        if interactive:
+            console.print(f"[red]Configuration error: {error}[/red]")
+            raise typer.Exit(1) from None
+        raise ValueError(f"GitHub configuration validation failed: {error}")
+
+    # ============================================================
+    # DEFAULT VALUES SECTION (for ticket creation)
+    # ============================================================
+    default_values = {}
+
+    if interactive:
+        console.print("\n[bold cyan]Default Values (Optional)[/bold cyan]")
+        console.print("Configure default values for ticket creation:")
+
+        # Default user/assignee
+        user_input = Prompt.ask(
+            "Default assignee/user (optional, GitHub username)",
+            default="",
+            show_default=False,
+        )
+        if user_input:
+            default_values["default_user"] = user_input
+            console.print(
+                f"[green]✓[/green] Will use '{user_input}' as default assignee"
+            )
 
-    return AdapterConfig.from_dict(config_dict)
+        # Default epic/project (milestone for GitHub)
+        epic_input = Prompt.ask(
+            "Default milestone/project (optional, e.g., 'v1.0' or milestone number)",
+            default="",
+            show_default=False,
+        )
+        if epic_input:
+            default_values["default_epic"] = epic_input
+            default_values["default_project"] = epic_input  # Compatibility
+            console.print(
+                f"[green]✓[/green] Will use '{epic_input}' as default milestone/project"
+            )
 
+        # Default tags (labels for GitHub)
+        tags_input = Prompt.ask(
+            "Default labels (optional, comma-separated, e.g., 'bug,enhancement')",
+            default="",
+            show_default=False,
+        )
+        if tags_input:
+            tags_list = [t.strip() for t in tags_input.split(",") if t.strip()]
+            if tags_list:
+                default_values["default_tags"] = tags_list
+                console.print(
+                    f"[green]✓[/green] Will use labels: {', '.join(tags_list)}"
+                )
 
-def _configure_aitrackdown() -> AdapterConfig:
-    """Configure AITrackdown adapter."""
-    console.print("\n[bold]Configure AITrackdown (File-based):[/bold]")
+    return AdapterConfig.from_dict(config_dict), default_values
 
-    base_path = Prompt.ask("Base path for ticket storage", default=".aitrackdown")
+
+def _configure_aitrackdown(
+    interactive: bool = True, base_path: str | None = None, **kwargs: Any
+) -> tuple[AdapterConfig, dict[str, Any]]:
+    """Configure AITrackdown adapter.
+
+    Supports both interactive (wizard) and programmatic (init command) modes.
+
+    Args:
+    ----
+        interactive: If True, prompt user for missing values (default: True)
+        base_path: Pre-provided base path for ticket storage (optional)
+        **kwargs: Additional configuration parameters
+
+    Returns:
+    -------
+        Tuple of (AdapterConfig, default_values_dict)
+        - AdapterConfig: Configured AITrackdown adapter configuration
+        - default_values_dict: Dictionary containing default_user, default_epic, default_project, default_tags
+
+    """
+    if interactive:
+        console.print("\n[bold]Configure AITrackdown (File-based):[/bold]")
+
+    # Base path (programmatic mode: use provided value or default, interactive: prompt)
+    final_base_path = base_path or ".aitrackdown"
+    if interactive:
+        final_base_path = Prompt.ask(
+            "Base path for ticket storage", default=".aitrackdown"
+        )
 
     config_dict = {
         "adapter": AdapterType.AITRACKDOWN.value,
-        "base_path": base_path,
+        "base_path": final_base_path,
     }
 
-    return AdapterConfig.from_dict(config_dict)
+    # ============================================================
+    # DEFAULT VALUES SECTION (for ticket creation)
+    # ============================================================
+    default_values = {}
+
+    if interactive:
+        console.print("\n[bold cyan]Default Values (Optional)[/bold cyan]")
+        console.print("Configure default values for ticket creation:")
+
+        # Default user/assignee
+        user_input = Prompt.ask(
+            "Default assignee/user (optional)", default="", show_default=False
+        )
+        if user_input:
+            default_values["default_user"] = user_input
+            console.print(
+                f"[green]✓[/green] Will use '{user_input}' as default assignee"
+            )
+
+        # Default epic/project
+        epic_input = Prompt.ask(
+            "Default epic/project ID (optional)", default="", show_default=False
+        )
+        if epic_input:
+            default_values["default_epic"] = epic_input
+            default_values["default_project"] = epic_input  # Compatibility
+            console.print(
+                f"[green]✓[/green] Will use '{epic_input}' as default epic/project"
+            )
+
+        # Default tags
+        tags_input = Prompt.ask(
+            "Default tags (optional, comma-separated)", default="", show_default=False
+        )
+        if tags_input:
+            tags_list = [t.strip() for t in tags_input.split(",") if t.strip()]
+            if tags_list:
+                default_values["default_tags"] = tags_list
+                console.print(f"[green]✓[/green] Will use tags: {', '.join(tags_list)}")
+
+    return AdapterConfig.from_dict(config_dict), default_values
+
+
+def prompt_default_values(
+    adapter_type: str,
+    existing_values: dict[str, Any] | None = None,
+) -> dict[str, Any]:
+    """Prompt user for default values (for ticket creation).
+
+    This is a standalone function that can be called independently of adapter configuration.
+    Used when adapter credentials exist but default values need to be set or updated.
+
+    Args:
+    ----
+        adapter_type: Type of adapter (linear, jira, github, aitrackdown)
+        existing_values: Optional existing default values to show as current values
+
+    Returns:
+    -------
+        Dictionary containing default_user, default_epic, default_project, default_tags
+        (only includes keys that were provided by the user)
+
+    """
+    console.print("\n[bold cyan]Default Values (Optional)[/bold cyan]")
+    console.print("Configure default values for ticket creation:")
+
+    default_values = {}
+    existing_values = existing_values or {}
+
+    # Default user/assignee
+    current_user = existing_values.get("default_user", "")
+    if current_user:
+        user_input = Prompt.ask(
+            f"Default assignee/user (optional) [current: {current_user}]",
+            default=current_user,
+            show_default=False,
+        )
+    else:
+        user_input = Prompt.ask(
+            "Default assignee/user (optional)",
+            default="",
+            show_default=False,
+        )
+    if user_input:
+        default_values["default_user"] = user_input
+        console.print(f"[green]✓[/green] Will use '{user_input}' as default assignee")
+
+    # Default epic/project
+    current_epic = existing_values.get("default_epic") or existing_values.get(
+        "default_project", ""
+    )
+
+    # Adapter-specific messaging
+    if adapter_type == "github":
+        epic_label = "milestone/project"
+        epic_example = "e.g., 'v1.0' or milestone number"
+    elif adapter_type == "linear":
+        epic_label = "epic/project ID"
+        epic_example = "e.g., 'PROJ-123' or UUID"
+    else:
+        epic_label = "epic/project ID"
+        epic_example = "e.g., 'PROJ-123'"
+
+    if current_epic:
+        epic_input = Prompt.ask(
+            f"Default {epic_label} (optional) [current: {current_epic}]",
+            default=current_epic,
+            show_default=False,
+        )
+    else:
+        epic_input = Prompt.ask(
+            f"Default {epic_label} (optional, {epic_example})",
+            default="",
+            show_default=False,
+        )
+    if epic_input:
+        default_values["default_epic"] = epic_input
+        default_values["default_project"] = epic_input  # Compatibility
+        console.print(
+            f"[green]✓[/green] Will use '{epic_input}' as default {epic_label}"
+        )
+
+    # Default tags
+    current_tags = existing_values.get("default_tags", [])
+    current_tags_str = ", ".join(current_tags) if current_tags else ""
+
+    # Adapter-specific messaging
+    tags_label = "labels" if adapter_type == "github" else "tags/labels"
+
+    if current_tags_str:
+        tags_input = Prompt.ask(
+            f"Default {tags_label} (optional, comma-separated) [current: {current_tags_str}]",
+            default=current_tags_str,
+            show_default=False,
+        )
+    else:
+        tags_input = Prompt.ask(
+            f"Default {tags_label} (optional, comma-separated, e.g., 'bug,urgent')",
+            default="",
+            show_default=False,
+        )
+    if tags_input:
+        tags_list = [t.strip() for t in tags_input.split(",") if t.strip()]
+        if tags_list:
+            default_values["default_tags"] = tags_list
+            console.print(
+                f"[green]✓[/green] Will use {tags_label}: {', '.join(tags_list)}"
+            )
+
+    return default_values
 
 
 def _configure_hybrid_mode() -> TicketerConfig:
@@ -301,20 +1037,25 @@ def _configure_hybrid_mode() -> TicketerConfig:
 
     # Configure each adapter
     adapters = {}
+    default_values: dict[str, str] = {}
     for adapter_type in selected_adapters:
         console.print(f"\n[cyan]Configuring {adapter_type.value}...[/cyan]")
 
         if adapter_type == AdapterType.LINEAR:
-            adapter_config = _configure_linear()
+            adapter_config, adapter_defaults = _configure_linear(interactive=True)
         elif adapter_type == AdapterType.JIRA:
-            adapter_config = _configure_jira()
+            adapter_config, adapter_defaults = _configure_jira(interactive=True)
         elif adapter_type == AdapterType.GITHUB:
-            adapter_config = _configure_github()
+            adapter_config, adapter_defaults = _configure_github(interactive=True)
         else:
-            adapter_config = _configure_aitrackdown()
+            adapter_config, adapter_defaults = _configure_aitrackdown(interactive=True)
 
         adapters[adapter_type.value] = adapter_config
 
+        # Only save defaults from the first/primary adapter
+        if not default_values:
+            default_values = adapter_defaults
+
     # Select primary adapter
     console.print("\n[bold]Select primary adapter (source of truth):[/bold]")
     for idx, adapter_type in enumerate(selected_adapters, 1):
@@ -354,9 +1095,15 @@ def _configure_hybrid_mode() -> TicketerConfig:
         sync_strategy=sync_strategy,
     )
 
-    # Create full config
+    # Create full config with default values
     config = TicketerConfig(
-        default_adapter=primary_adapter, adapters=adapters, hybrid_mode=hybrid_config
+        default_adapter=primary_adapter,
+        adapters=adapters,
+        hybrid_mode=hybrid_config,
+        default_user=default_values.get("default_user"),
+        default_project=default_values.get("default_project"),
+        default_epic=default_values.get("default_epic"),
+        default_tags=default_values.get("default_tags"),
     )
 
     return config
@@ -437,6 +1184,7 @@ def set_adapter_config(
     """Set specific adapter configuration values.
 
     Args:
+    ----
         adapter: Adapter type to set as default
         api_key: API key/token
         project_id: Project ID