devsync 0.12.0__tar.gz → 0.14.0__tar.gz

{devsync-0.12.0 → devsync-0.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: devsync
-Version: 0.12.0
+Version: 0.14.0
 Summary: Distribute and sync dev tool configurations across teams
 Author-email: Troy Larson <troy@calvinware.com>
 License: MIT License
@@ -86,6 +86,7 @@ No API key? DevSync works without one -- it falls back to file-copy mode. Add `-
 - **AI-powered extraction** -- LLM reads your project's rules, MCP configs, and commands to produce abstract practice declarations
 - **AI-powered installation** -- LLM adapts incoming practices to your existing setup with intelligent merging
 - **23+ AI tool integrations** -- Claude Code, Cursor, Windsurf, GitHub Copilot, Kiro, Roo Code, Cline, Codex, and more
+- **MCP server dependencies** -- auto-detects pip-installable MCP servers and prompts to install them (`--skip-pip` to skip)
 - **MCP credential handling** -- prompts for credentials at install time, never stores them in repos
 - **v1 backward compatibility** -- old `ai-config-kit-package.yaml` packages still install via file-copy
 - **Graceful degradation** -- works without an API key, `--no-ai` flag for explicit file-copy mode

{devsync-0.12.0 → devsync-0.14.0}/README.md

@@ -47,6 +47,7 @@ No API key? DevSync works without one -- it falls back to file-copy mode. Add `-
 - **AI-powered extraction** -- LLM reads your project's rules, MCP configs, and commands to produce abstract practice declarations
 - **AI-powered installation** -- LLM adapts incoming practices to your existing setup with intelligent merging
 - **23+ AI tool integrations** -- Claude Code, Cursor, Windsurf, GitHub Copilot, Kiro, Roo Code, Cline, Codex, and more
+- **MCP server dependencies** -- auto-detects pip-installable MCP servers and prompts to install them (`--skip-pip` to skip)
 - **MCP credential handling** -- prompts for credentials at install time, never stores them in repos
 - **v1 backward compatibility** -- old `ai-config-kit-package.yaml` packages still install via file-copy
 - **Graceful degradation** -- works without an API key, `--no-ai` flag for explicit file-copy mode

{devsync-0.12.0 → devsync-0.14.0}/devsync/ai_tools/capability_registry.py

@@ -28,6 +28,7 @@ class IDECapability:
     skills_directory: str | None = None  # Claude skills
     workflows_directory: str | None = None  # Windsurf workflows
     memory_file_name: str | None = None  # CLAUDE.md
+    mcp_servers_json_key: str = "mcpServers"  # JSON key for MCP servers in config files
     notes: str = ""
 
     def supports_component(self, component_type: ComponentType) -> bool:
@@ -494,6 +495,7 @@ CAPABILITY_REGISTRY: dict[AIToolType, IDECapability] = {
         mcp_project_config_path=".vscode/mcp.json",  # Workspace-level MCP config
         hooks_directory=None,  # Hooks not supported
         commands_directory=None,  # Commands not supported
+        mcp_servers_json_key="servers",  # VS Code uses "servers" not "mcpServers"
         notes=(
             "GitHub Copilot uses .github/copilot-instructions.md (main) and "
             ".github/instructions/**/*.instructions.md (file-specific with globs). "

{devsync-0.12.0 → devsync-0.14.0}/devsync/cli/extract.py

@@ -1,12 +1,21 @@
 """Extract command — reads project configs and produces a shareable package."""
 
 import shutil
+import warnings
+from collections import Counter
 from pathlib import Path
 from typing import Optional
 
 from rich.console import Console
 from rich.progress import Progress, SpinnerColumn, TextColumn
-
+from rich.table import Table
+
+from devsync.core.component_detector import (
+    COMPONENT_TYPE_MAP,
+    ComponentDetector,
+    DetectionResult,
+    filter_detection_result,
+)
 from devsync.core.extractor import PracticeExtractor
 from devsync.core.package_manifest_v2 import PackageManifestV2, detect_manifest_format, parse_manifest
 from devsync.llm.config import load_config
@@ -14,6 +23,89 @@ from devsync.llm.provider import resolve_provider
 
 console = Console()
 
+# Map DetectionResult field names back to user-facing component names
+_FIELD_TO_LABEL: dict[str, str] = {
+    "instructions": "Rules",
+    "mcp_servers": "MCP",
+    "hooks": "Hooks",
+    "commands": "Commands",
+    "skills": "Skills",
+    "workflows": "Workflows",
+    "memory_files": "Memory",
+    "resources": "Resources",
+}
+
+
+def _get_detection_rows(detection: DetectionResult) -> list[tuple[str, str, int]]:
+    """Build (component_label, source_tool, count) rows from detection.
+
+    Groups by component type + source tool for a concise table.
+
+    Returns:
+        List of (label, source, count) tuples, sorted by label then source.
+    """
+    rows: list[tuple[str, str, int]] = []
+
+    for field_name, label in _FIELD_TO_LABEL.items():
+        items = getattr(detection, field_name, [])
+        if not items:
+            continue
+
+        source_counts: Counter[str] = Counter()
+        for item in items:
+            source = getattr(item, "source_tool", "") or getattr(item, "source_ide", "") or "project"
+            source_counts[source] += 1
+
+        for source, count in sorted(source_counts.items()):
+            rows.append((label, source, count))
+
+    return rows
+
+
+def _display_detection_summary(detection: DetectionResult) -> None:
+    """Display a Rich table summarizing detected components."""
+    rows = _get_detection_rows(detection)
+
+    if not rows:
+        return
+
+    table = Table(title="Detected Components", show_header=True, header_style="bold cyan")
+    table.add_column("Component", style="cyan", no_wrap=True)
+    table.add_column("Source", style="green")
+    table.add_column("Count", justify="right")
+
+    for label, source, count in rows:
+        table.add_row(label, source, str(count))
+
+    console.print()
+    console.print(table)
+
+    tool_sources = {source for _, source, _ in rows if source not in ("project", "devsync")}
+    tool_count = len(tool_sources) if tool_sources else 1
+    console.print(f"\n  Total: {detection.total_count} components from {tool_count} tool(s)")
+
+
+def _display_zero_result_warning(
+    tool: Optional[list[str]] = None,
+    component: Optional[list[str]] = None,
+    include_global: bool = False,
+) -> None:
+    """Display a helpful warning when filters match no components."""
+    console.print("\n[yellow]No components found matching your filters.[/yellow]")
+
+    active_filters = []
+    if tool:
+        active_filters.append(f"--tool {' --tool '.join(tool)}")
+    if component:
+        active_filters.append(f"--component {' --component '.join(component)}")
+    if active_filters:
+        console.print(f"\n  Active: {' '.join(active_filters)}")
+
+    console.print("\n  Suggestions:")
+    console.print("  - Run [cyan]devsync extract --dry-run[/cyan] without filters to see all available components")
+    if not include_global:
+        console.print("  - Try [cyan]--include-global[/cyan] to include home directory configs")
+
 
 def extract_command(
     output: Optional[str] = None,
@@ -21,6 +113,11 @@ def extract_command(
     no_ai: bool = False,
     project_dir: Optional[str] = None,
     upgrade: Optional[str] = None,
+    tool: Optional[list[str]] = None,
+    component: Optional[list[str]] = None,
+    scope: str = "project",
+    dry_run: bool = False,
+    include_global: bool = False,
 ) -> int:
     """Extract practices from the current project into a shareable package.
 
@@ -30,6 +127,11 @@ def extract_command(
         no_ai: Force file-copy mode (no LLM calls).
         project_dir: Project directory to extract from. Defaults to cwd.
         upgrade: Path to a v1 package to convert to v2 format.
+        tool: Only extract from these AI tool(s).
+        component: Only extract these component types.
+        scope: Detection scope — project, global, or all. Deprecated; use include_global.
+        dry_run: Show what would be extracted without writing files.
+        include_global: Include home directory / global configs.
 
     Returns:
         Exit code (0 = success).
@@ -37,11 +139,70 @@ def extract_command(
     if upgrade:
         return _upgrade_v1_package(upgrade, output=output, name=name, no_ai=no_ai)
 
+    # Resolve effective scope: --include-global takes precedence
+    effective_scope = "project"
+    if include_global:
+        effective_scope = "all"
+    elif scope != "project":
+        warnings.warn(
+            "--scope is deprecated, use --include-global instead",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        console.print("[yellow]--scope is deprecated. Use --include-global instead.[/yellow]")
+        effective_scope = scope
+
+    # Validate scope
+    if effective_scope not in ("project", "global", "all"):
+        console.print(f"[red]Invalid scope: {effective_scope}. Must be project, global, or all.[/red]")
+        return 1
+
+    # Validate tool names
+    if tool:
+        from devsync.ai_tools.detector import AIToolDetector
+
+        detector = AIToolDetector()
+        for t in tool:
+            if not detector.validate_tool_name(t):
+                console.print(f"[red]Unknown tool: {t}[/red]")
+                console.print(f"Supported tools: {', '.join(detector.get_tool_names())}")
+                return 1
+
+    # Validate component names
+    if component:
+        for c in component:
+            if c.lower() not in COMPONENT_TYPE_MAP:
+                valid = sorted(set(COMPONENT_TYPE_MAP.keys()))
+                console.print(f"[red]Unknown component type: {c}[/red]")
+                console.print(f"Valid types: {', '.join(valid)}")
+                return 1
+
     project_path = Path(project_dir) if project_dir else Path.cwd()
     if not project_path.is_dir():
         console.print(f"[red]Not a directory: {project_path}[/red]")
         return 1
 
+    # Phase 1: Detection + filtering
+    comp_detector = ComponentDetector(project_path, scope=effective_scope, tool_filter=tool)
+    detection = comp_detector.detect_all()
+
+    if component:
+        detection = filter_detection_result(detection, component_filter=component)
+
+    # Zero-result handling
+    if detection.total_count == 0:
+        _display_zero_result_warning(tool=tool, component=component, include_global=include_global)
+        return 0
+
+    # Display detection summary
+    _display_detection_summary(detection)
+
+    # Dry-run: stop here
+    if dry_run:
+        console.print("\n[dim]Dry run — no files written.[/dim]")
+        return 0
+
+    # Phase 2: Extraction
     package_name = name or project_path.name
     output_path = Path(output) if output else project_path / "devsync-package"
 
@@ -63,8 +224,8 @@ def extract_command(
         TextColumn("[progress.description]{task.description}"),
         console=console,
     ) as progress:
-        task = progress.add_task("Scanning project...", total=None)
-        result = extractor.extract(project_path)
+        task = progress.add_task("Extracting practices...", total=None)
+        result = extractor.extract(project_path, detection=detection)
         progress.update(task, description="Building package...")
 
     output_path.mkdir(parents=True, exist_ok=True)
@@ -96,12 +257,13 @@ def extract_command(
     manifest_path = output_path / "devsync-package.yaml"
     manifest_path.write_text(manifest.to_yaml())
 
+    # Enhanced output
     mode = "[green]AI-powered[/green]" if result.ai_powered else "[yellow]file-copy[/yellow]"
-    console.print(f"\nExtracted ({mode}):")
-    console.print(f"  Practices: {len(result.practices)}")
+    console.print(f"\nExtraction complete ({mode})")
+    console.print(f"  Practices generated: {len(result.practices)}")
     console.print(f"  MCP servers: {len(result.mcp_servers)}")
     console.print(f"  Source files: {len(result.source_files)}")
-    console.print(f"\nPackage written to: [cyan]{output_path}[/cyan]")
+    console.print(f"\n  Package written to: [cyan]{output_path}[/cyan]")
     return 0
 
 

{devsync-0.12.0 → devsync-0.14.0}/devsync/cli/install_v2.py

@@ -1,9 +1,14 @@
 """V2 install command — AI-powered package installation."""
 
+from __future__ import annotations
+
 import shutil
 import tempfile
 from pathlib import Path
-from typing import Optional
+from typing import TYPE_CHECKING, Optional
+
+if TYPE_CHECKING:
+    from devsync.core.practice import MCPDeclaration
 
 from rich.console import Console
 from rich.prompt import Confirm
@@ -26,6 +31,7 @@ def install_v2_command(
     no_ai: bool = False,
     conflict: str = "prompt",
     project_dir: Optional[str] = None,
+    skip_pip: bool = False,
 ) -> int:
     """Install a package into the current project.
 
@@ -37,6 +43,7 @@ def install_v2_command(
         no_ai: Disable AI-powered adaptation.
         conflict: Conflict strategy ('prompt', 'skip', 'overwrite', 'rename').
         project_dir: Target project directory. Defaults to cwd.
+        skip_pip: Skip pip package installations for MCP servers.
 
     Returns:
         Exit code (0 = success).
@@ -72,8 +79,8 @@ def install_v2_command(
         console.print(f"  Tools: {', '.join(target_tools)}")
 
         if manifest.is_v2 and manifest.has_practices and not no_ai:
-            return _install_v2_ai(manifest, project_root, target_tools)
-        return _install_v2_fallback(manifest, package_path, project_root, target_tools, conflict)
+            return _install_v2_ai(manifest, project_root, target_tools, skip_pip=skip_pip)
+        return _install_v2_fallback(manifest, package_path, project_root, target_tools, conflict, skip_pip=skip_pip)
     finally:
         if cloned_tmp and cloned_tmp.exists():
             shutil.rmtree(cloned_tmp, ignore_errors=True)
@@ -125,6 +132,7 @@ def _install_v2_ai(
     manifest: PackageManifestV2,
     project_root: Path,
     target_tools: list[str],
+    skip_pip: bool = False,
 ) -> int:
     """Install using AI-powered adaptation."""
     config = load_config()
@@ -142,7 +150,7 @@ def _install_v2_ai(
     _execute_plan(plan, project_root, target_tools)
 
     if manifest.mcp_servers:
-        _install_mcp_servers(manifest, project_root)
+        _install_mcp_servers(manifest, project_root, skip_pip=skip_pip)
 
     console.print(f"\n[green]Installed {manifest.name} successfully.[/green]")
     return 0
@@ -154,6 +162,7 @@ def _install_v2_fallback(
     project_root: Path,
     target_tools: list[str],
     conflict: str,
+    skip_pip: bool = False,
 ) -> int:
     """Install using file-copy mode (v1 compat or --no-ai)."""
     installed_count = 0
@@ -205,7 +214,7 @@ def _install_v2_fallback(
                     console.print(f"  Installed: {ref.name} → {dest.relative_to(project_root)}")
 
     if manifest.mcp_servers:
-        _install_mcp_servers(manifest, project_root)
+        _install_mcp_servers(manifest, project_root, skip_pip=skip_pip)
 
     console.print(f"\n[green]Installed {installed_count} instructions.[/green]")
     return 0
@@ -258,17 +267,94 @@ def _get_tool_instruction_path(tool_name: str, project_root: Path, instruction_n
     return project_root / dir_name / f"{instruction_name}{ext}"
 
 
-def _install_mcp_servers(manifest: PackageManifestV2, project_root: Path) -> None:
-    """Install MCP server configurations with credential prompting."""
-    servers_with_creds = [s for s in manifest.mcp_servers if s.credentials]
+def _install_mcp_servers(
+    manifest: PackageManifestV2,
+    project_root: Path,
+    skip_pip: bool = False,
+) -> None:
+    """Install MCP server configurations with pip dependencies and credential prompting."""
+    failed_pip_servers = _install_pip_dependencies(manifest.mcp_servers, skip_pip=skip_pip)
+
+    # Skip credential prompting for servers whose pip deps failed
+    eligible_servers = [s for s in manifest.mcp_servers if s.name not in failed_pip_servers]
+    servers_with_creds = [s for s in eligible_servers if s.credentials]
     if servers_with_creds:
         env_path = project_root / ".devsync" / ".env"
         credentials = prompt_mcp_credentials(servers_with_creds, env_path=env_path)
 
-        for server in manifest.mcp_servers:
+        for server in eligible_servers:
             server_creds = credentials.get(server.name, {})
             build_mcp_config(server, server_creds)
             console.print(f"  MCP: {server.name} configured")
     else:
-        for server in manifest.mcp_servers:
+        for server in eligible_servers:
             console.print(f"  MCP: {server.name} (no credentials needed)")
+
+
+def _install_pip_dependencies(
+    mcp_servers: list[MCPDeclaration],
+    skip_pip: bool = False,
+) -> set[str]:
+    """Install pip package dependencies for MCP servers.
+
+    Args:
+        mcp_servers: List of MCPDeclaration objects.
+        skip_pip: If True, skip all pip installations.
+
+    Returns:
+        Set of server names whose pip dependency installation failed or was declined.
+    """
+    from devsync.core.pip_utils import (
+        get_installed_version,
+        install_pip_package,
+        installed_version_satisfies,
+        validate_pip_spec,
+    )
+
+    failed_servers: set[str] = set()
+    servers_with_pip = [s for s in mcp_servers if s.pip_package]
+    if not servers_with_pip:
+        return failed_servers
+
+    console.print("\n[bold]MCP Server Dependencies[/bold]")
+
+    if skip_pip:
+        console.print("  [yellow]Skipping pip installations (--skip-pip)[/yellow]")
+        for server in servers_with_pip:
+            console.print(f"  [dim]{server.name}: {server.pip_package} (skipped)[/dim]")
+        return failed_servers
+
+    for server in servers_with_pip:
+        spec = server.pip_package
+        assert spec is not None  # guarded by servers_with_pip filter
+
+        if not validate_pip_spec(spec):
+            console.print(f"  [red]Invalid package spec for {server.name}: {spec}[/red]")
+            failed_servers.add(server.name)
+            continue
+
+        if installed_version_satisfies(spec):
+            installed_ver = get_installed_version(spec)
+            console.print(f"  [dim]{server.name}: {spec} already installed (v{installed_ver})[/dim]")
+            continue
+
+        console.print(f"  [cyan]{server.name} requires pip package: {spec}[/cyan]")
+        if server.description:
+            console.print(f"  [dim]{server.description}[/dim]")
+
+        if not Confirm.ask(f"  Install {spec}?", default=True):
+            console.print(f"  [yellow]Skipped pip install for {server.name}[/yellow]")
+            failed_servers.add(server.name)
+            continue
+
+        with console.status(f"  Installing {spec}..."):
+            success, message = install_pip_package(spec)
+
+        if success:
+            console.print(f"  [green]{message}[/green]")
+        else:
+            console.print(f"  [red]{message}[/red]")
+            console.print(f"  [yellow]MCP server {server.name} may not work without {spec}[/yellow]")
+            failed_servers.add(server.name)
+
+    return failed_servers

{devsync-0.12.0 → devsync-0.14.0}/devsync/cli/main.py

@@ -30,13 +30,20 @@ def setup() -> None:
 
 
 @app.command()
-def tools() -> None:
+def tools(
+    verbose: bool = typer.Option(
+        False,
+        "--verbose",
+        "-v",
+        help="Show capabilities and valid filter names",
+    ),
+) -> None:
     """Show detected AI coding tools.
 
     Display which AI coding tools are installed on your system
     and where their configuration directories are located.
     """
-    exit_code = show_tools()
+    exit_code = show_tools(verbose=verbose)
     raise typer.Exit(code=exit_code)
 
 
@@ -70,11 +77,41 @@ def extract(
         "--upgrade",
         help="Convert a v1 package to v2 format",
     ),
+    tool: Optional[list[str]] = typer.Option(
+        None,
+        "--tool",
+        "-t",
+        help="Only extract from specific AI tool(s). Repeatable.",
+    ),
+    component: Optional[list[str]] = typer.Option(
+        None,
+        "--component",
+        "-c",
+        help="Component types to extract: rules, mcp, hooks, commands, skills, workflows, memory. Repeatable.",
+    ),
+    scope: str = typer.Option(
+        "project",
+        "--scope",
+        "-s",
+        help="(Deprecated) Detection scope: project, global, or all. Use --include-global instead.",
+        hidden=True,
+    ),
+    dry_run: bool = typer.Option(
+        False,
+        "--dry-run",
+        help="Show detected components without writing files or calling the LLM",
+    ),
+    include_global: bool = typer.Option(
+        False,
+        "--include-global",
+        help="Include home directory / global configs in extraction",
+    ),
 ) -> None:
     """Extract practices from a project into a shareable package.
 
-    Reads your project's AI tool configs (rules, MCP servers, hooks, commands)
-    and produces a devsync-package.yaml with abstract practice declarations.
+    Reads your project's AI tool configs (rules, MCP servers, hooks, commands,
+    skills, workflows, memory files, resources) and produces a devsync-package.yaml
+    with abstract practice declarations.
 
     Examples:
       # AI-powered extraction
@@ -86,6 +123,21 @@ def extract(
       # Custom output and name
       devsync extract --output ./my-package --name team-standards
 
+      # Extract only from Cursor
+      devsync extract --tool cursor
+
+      # Extract only MCP configs
+      devsync extract --component mcp
+
+      # Preview what would be extracted (no files written)
+      devsync extract --dry-run
+
+      # Include home directory / global configs
+      devsync extract --include-global
+
+      # Combine filters: extract only rules and hooks from Claude Code
+      devsync extract --tool claude --component rules --component hooks
+
       # Upgrade v1 package to v2
       devsync extract --upgrade ./old-package
     """
@@ -97,6 +149,11 @@ def extract(
         no_ai=no_ai,
         project_dir=project_dir,
         upgrade=upgrade,
+        tool=tool,
+        component=component,
+        scope=scope,
+        dry_run=dry_run,
+        include_global=include_global,
     )
     raise typer.Exit(code=exit_code)
 
@@ -130,6 +187,11 @@ def install(
         "-p",
         help="Target project directory (default: current directory)",
     ),
+    skip_pip: bool = typer.Option(
+        False,
+        "--skip-pip",
+        help="Skip pip package installations for MCP servers",
+    ),
 ) -> None:
     """Install a package into the current project.
 
@@ -151,6 +213,9 @@ def install(
 
       # Skip conflicts
       devsync install ./package --conflict skip
+
+      # Skip pip installations
+      devsync install ./package --skip-pip
     """
     from devsync.cli.install_v2 import install_v2_command
 
@@ -160,6 +225,7 @@ def install(
         no_ai=no_ai,
         conflict=conflict,
         project_dir=project_dir,
+        skip_pip=skip_pip,
     )
     raise typer.Exit(code=exit_code)
 

devsync-0.14.0/devsync/cli/tools.py

@@ -0,0 +1,74 @@
+"""Tools command to show detected AI coding tools."""
+
+from rich.console import Console
+from rich.table import Table
+
+from devsync.ai_tools.detector import get_detector
+
+console = Console()
+
+# Map ComponentType enum values to user-facing filter names
+_COMPONENT_TYPE_LABELS: dict[str, str] = {
+    "instruction": "rules",
+    "mcp_server": "mcp",
+    "hook": "hooks",
+    "command": "commands",
+    "skill": "skills",
+    "workflow": "workflows",
+    "resource": "resources",
+    "memory_file": "memory",
+}
+
+
+def show_tools(verbose: bool = False) -> int:
+    """Show detected AI coding tools.
+
+    Args:
+        verbose: Show capabilities column and valid filter names.
+
+    Returns:
+        Exit code (0 for success)
+    """
+    from devsync.ai_tools.capability_registry import CAPABILITY_REGISTRY
+
+    detector = get_detector()
+
+    table = Table(title="AI Coding Tools", show_header=True, header_style="bold cyan")
+    table.add_column("Tool", style="cyan", no_wrap=True)
+    table.add_column("Status", style="green")
+    if verbose:
+        table.add_column("Capabilities", style="dim")
+
+    for tool_type, tool in detector.tools.items():
+        is_installed = tool.is_installed()
+        status = "[green]✓ Installed[/green]" if is_installed else "[red]✗ Not found[/red]"
+
+        if verbose:
+            cap = CAPABILITY_REGISTRY.get(tool_type)
+            if cap:
+                labels = sorted(_COMPONENT_TYPE_LABELS.get(ct.value, ct.value) for ct in cap.supported_components)
+                caps_str = ", ".join(labels)
+            else:
+                caps_str = ""
+            table.add_row(tool.tool_name, status, caps_str)
+        else:
+            table.add_row(tool.tool_name, status)
+
+    console.print()
+    console.print(table)
+    console.print()
+
+    installed = detector.detect_installed_tools()
+    if installed:
+        tool_names = ", ".join([t.tool_name for t in installed])
+        console.print(f"[green]Found {len(installed)} installed tool(s):[/green] {tool_names}")
+    else:
+        console.print("[yellow]No AI coding tools detected[/yellow]")
+        console.print("\nSupported tools: Cursor, GitHub Copilot, Winsurf, Claude Code")
+
+    if verbose:
+        all_labels = sorted(set(_COMPONENT_TYPE_LABELS.values()))
+        console.print(f"\nValid --component names: {', '.join(all_labels)}")
+
+    console.print()
+    return 0