pcd-cli 0.2.0__tar.gz → 0.2.2__tar.gz

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pcd-cli
-Version: 0.2.0
+Version: 0.2.2
 Summary: Fast project navigator for Bash, Zsh and Fish
 License-Expression: MIT
 License-File: LICENSE
@@ -69,7 +69,7 @@ COMMANDS
     pcd roots                    List scan roots
     pcd refresh                  Rescan roots and rebuild the project cache
 
-    pcd list                     List all known projects
+    pcd list [options]           List and filter known projects
     pcd config path              Print the configuration file path
     pcd config show              Print the effective configuration
     pcd config edit              Edit the user configuration
@@ -85,6 +85,8 @@ COMMANDS
 
 * Projects inside registered roots are discovered automatically.
 * You can register multiple scan roots.
+* Filter `pcd list` with `--manual`, `--discovered`, or `--missing`.
+* Use `pcd list --json` for machine-readable output.
 * Set `editor = "nvim"` in the configuration to choose an editor for `pcd config edit`.
 
 
@@ -103,10 +105,7 @@ SEE ALSO
         FEATURES.txt
 
     Planned changes:
-        ROADMAP.md
-
-    Changelog:
-        CHANGELOG.md
+        ROADMAP.txt
 
     License:
         MIT

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/README.txt

@@ -45,7 +45,7 @@ COMMANDS
     pcd roots                    List scan roots
     pcd refresh                  Rescan roots and rebuild the project cache
 
-    pcd list                     List all known projects
+    pcd list [options]           List and filter known projects
     pcd config path              Print the configuration file path
     pcd config show              Print the effective configuration
     pcd config edit              Edit the user configuration
@@ -61,6 +61,8 @@ COMMANDS
 
 * Projects inside registered roots are discovered automatically.
 * You can register multiple scan roots.
+* Filter `pcd list` with `--manual`, `--discovered`, or `--missing`.
+* Use `pcd list --json` for machine-readable output.
 * Set `editor = "nvim"` in the configuration to choose an editor for `pcd config edit`.
 
 
@@ -79,10 +81,7 @@ SEE ALSO
         FEATURES.txt
 
     Planned changes:
-        ROADMAP.md
-
-    Changelog:
-        CHANGELOG.md
+        ROADMAP.txt
 
     License:
         MIT

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "pcd-cli"
-version = "0.2.0"
+version = "0.2.2"
 description = "Fast project navigator for Bash, Zsh and Fish"
 readme = { file = "README.txt", content-type = "text/plain" }
 license = "MIT"

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/src/pcd_cli/cli/__init__.py

@@ -6,7 +6,8 @@ from pcd_cli.cli.config import (
     show_config,
     validate_config,
 )
-from pcd_cli.cli.projects import add, init, list_projects, project, refresh, remove, roots, uninit
+from pcd_cli.cli.projects import add, list_projects, project, remove
+from pcd_cli.cli.roots import init, refresh, roots, uninit
 from pcd_cli.cli.shell import (
     install_shell,
     print_shell_integration,

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/src/pcd_cli/cli/app.py

@@ -8,6 +8,7 @@ import click
 from pcd_cli.catalog import ProjectCatalog
 from pcd_cli.cli.config import config_commands
 from pcd_cli.cli.projects import project_commands
+from pcd_cli.cli.roots import root_commands
 from pcd_cli.cli.shell import shell_commands, shell_init
 from pcd_cli.config import InvalidConfigError
 from pcd_cli.models import ExitCode
@@ -83,11 +84,14 @@ def cli(ctx: click.Context, project_name: str | None) -> None:
     navigate_to_project(catalog, project_name, exact_only=True)
 
 
-for command in project_commands:
+for command in (
+    *project_commands,
+    *root_commands,
+    config_commands,
+    shell_commands,
+    shell_init,
+):
     cli.add_command(command)
-cli.add_command(config_commands)
-cli.add_command(shell_commands)
-cli.add_command(shell_init)
 
 
 def main() -> None:

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/src/pcd_cli/cli/config.py

@@ -40,8 +40,8 @@ def edit_config(catalog: ProjectCatalog) -> None:
         editor = catalog.config.load().editor
     except InvalidConfigError:
         editor = None
-    else:
-        editor = editor or os.environ.get("VISUAL") or os.environ.get("EDITOR")
+
+    editor = editor or os.environ.get("VISUAL") or os.environ.get("EDITOR")
 
     if editor is None:
         raise click.UsageError("Set $VISUAL or $EDITOR before running `pcd config edit`")

pcd_cli-0.2.2/src/pcd_cli/cli/projects.py

@@ -0,0 +1,217 @@
+from __future__ import annotations
+
+import json
+from enum import StrEnum
+from pathlib import Path
+from typing import assert_never, ClassVar, Literal, NamedTuple, TYPE_CHECKING
+
+import click
+
+from pcd_cli.filesystem import canonical_path, format_path
+from pcd_cli.models import ExitCode, Project, ProjectSource
+from pcd_cli.navigation import navigate_to_project, project_completions, select_project
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
+    from pcd_cli.catalog import ProjectCatalog
+
+type ProjectSourceLabel = Literal["manual", "scanned"]
+
+
+class ProjectStatus(StrEnum):
+    AVAILABLE = "available"
+    MISSING = "missing"
+
+
+class ProjectListRow(NamedTuple):
+    name: str
+    path: str
+    source: ProjectSourceLabel
+    status: ProjectStatus
+
+    @classmethod
+    def from_project(cls, project: Project) -> ProjectListRow:
+        return cls(
+            name=project.name,
+            path=format_path(project.display_path),
+            source=cls._source_label(project.source),
+            status=cls._status_label(project.path),
+        )
+
+    @staticmethod
+    def _source_label(source: ProjectSource) -> ProjectSourceLabel:
+        match source:
+            case ProjectSource.DISCOVERED:
+                return "scanned"
+            case ProjectSource.MANUAL:
+                return "manual"
+            case _:
+                assert_never(source)
+
+    @staticmethod
+    def _status_label(path: Path) -> ProjectStatus:
+        if path.is_dir():
+            return ProjectStatus.AVAILABLE
+        else:
+            return ProjectStatus.MISSING
+
+
+class ProjectListTable:
+    HEADERS: ClassVar[tuple[str, str, str, str]] = ("NAME", "PATH", "SOURCE", "STATUS")
+
+    _rows: tuple[ProjectListRow, ...]
+
+    def __init__(self, projects: Sequence[Project]) -> None:
+        self._rows = tuple(ProjectListRow.from_project(project) for project in projects)
+
+    @classmethod
+    def from_rows(cls, rows: Sequence[ProjectListRow]) -> ProjectListTable:
+        table = cls(())
+        table._rows = tuple(rows)
+        return table
+
+    def render(self) -> str:
+        if self._rows:
+            return self._render_table()
+        else:
+            return "No projects found."
+
+    def _render_table(self) -> str:
+        table = (self.HEADERS, *self._rows)
+        columns = zip(*table, strict=True)
+        widths = tuple(max(len(value) for value in column) for column in columns)
+
+        return "\n".join(self._render_row(row, widths) for row in table)
+
+    @staticmethod
+    def _render_row(row: tuple[str, ...], widths: tuple[int, ...]) -> str:
+        return "  ".join(
+            value.ljust(width) for value, width in zip(row, widths, strict=True)
+        ).rstrip()
+
+
+@click.command(hidden=True)
+@click.argument("query")
+@click.pass_obj
+def project(catalog: ProjectCatalog, query: str) -> None:
+    """Resolve a project name routed by the root command."""
+    navigate_to_project(catalog, query)
+
+
+@click.command()
+@click.argument("path", type=click.Path(path_type=Path, file_okay=False), required=False)
+@click.option("--name", help="Custom name for a manual project.")
+@click.pass_obj
+def add(catalog: ProjectCatalog, path: Path | None, name: str | None) -> None:
+    """Register a directory as a manual project."""
+    if path is None:
+        location = Path.cwd()
+    else:
+        try:
+            location = path.expanduser()
+        except RuntimeError as exc:
+            raise click.BadParameter("Unknown home directory", param_hint="path") from exc
+
+    if not location.is_absolute():
+        location = Path.cwd() / location
+    if not location.is_dir():
+        raise click.BadParameter(f"Directory does not exist: {location}", param_hint="path")
+
+    project_name = location.name if name is None else name.strip()
+    if not project_name:
+        raise click.BadParameter("Project name cannot be empty", param_hint="--name")
+
+    item = Project(
+        name=project_name,
+        path=canonical_path(location),
+        display_path=location,
+        source=ProjectSource.MANUAL,
+    )
+    if catalog.add_project(item):
+        click.echo(f"Added project: {item.name} -> {format_path(item.display_path)}")
+        return
+
+    click.echo(f"Project already exists: {item.name} -> {format_path(item.display_path)}")
+
+
+@click.command()
+@click.argument(
+    "query",
+    shell_complete=lambda _ctx, _param, value: project_completions(value),
+)
+@click.pass_obj
+def remove(catalog: ProjectCatalog, query: str) -> None:
+    """Remove a manual project registration."""
+    matches = catalog.search(query, exact_only=True)
+    if not matches:
+        click.echo(f"Project not found: {query}", err=True)
+        raise click.exceptions.Exit(ExitCode.NOT_FOUND)
+
+    selected = select_project(catalog, matches, query)
+    if selected is None:
+        return
+
+    if selected.source is ProjectSource.DISCOVERED:
+        click.echo(
+            f"{selected.name} is discovered automatically and cannot be removed with pcd remove.",
+            err=True,
+        )
+        raise click.exceptions.Exit(ExitCode.ERROR)
+
+    if catalog.remove_project(selected.path):
+        click.echo(f"Removed project: {selected.name}")
+        return
+
+    click.echo("Project is no longer registered.", err=True)
+    raise click.exceptions.Exit(ExitCode.ERROR)
+
+
+@click.command("list")
+@click.option("--manual", is_flag=True, help="Show manually registered projects.")
+@click.option("--discovered", is_flag=True, help="Show automatically discovered projects.")
+@click.option("--missing", is_flag=True, help="Show projects whose directories are missing.")
+@click.option("--json", "as_json", is_flag=True, help="Print projects as JSON.")
+@click.pass_obj
+def list_projects(
+    catalog: ProjectCatalog,
+    manual: bool,
+    discovered: bool,
+    missing: bool,
+    as_json: bool,
+) -> None:
+    """List and filter known projects."""
+    entries: list[tuple[Project, ProjectListRow]] = []
+    for project in catalog.projects():
+        source_matches = (
+            not (manual or discovered)
+            or (manual and project.source is ProjectSource.MANUAL)
+            or (discovered and project.source is ProjectSource.DISCOVERED)
+        )
+        if not source_matches:
+            continue
+
+        row = ProjectListRow.from_project(project)
+        if missing and row.status is not ProjectStatus.MISSING:
+            continue
+
+        entries.append((project, row))
+
+    if as_json:
+        items = [
+            {
+                "name": project.name,
+                "path": str(project.display_path),
+                "source": project.source.value,
+                "status": row.status,
+            }
+            for project, row in entries
+        ]
+        click.echo(json.dumps(items, indent=2))
+        return
+
+    table = ProjectListTable.from_rows(tuple(row for _, row in entries))
+    click.echo(table.render())
+
+
+project_commands = (project, add, remove, list_projects)

pcd_cli-0.2.2/src/pcd_cli/cli/roots.py

@@ -0,0 +1,113 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import ClassVar, Literal, NamedTuple, TYPE_CHECKING
+
+import click
+
+from pcd_cli.filesystem import canonical_path, format_path
+from pcd_cli.models import ExitCode, ProjectSource
+
+if TYPE_CHECKING:
+    from collections.abc import Sequence
+
+    from pcd_cli.catalog import ProjectCatalog
+    from pcd_cli.models import Project
+
+type RootStatusLabel = Literal["available", "missing"]
+
+
+class RootListRow(NamedTuple):
+    path: str
+    projects: str
+    status: RootStatusLabel
+
+    @classmethod
+    def from_root(cls, root: Path, projects: Sequence[Project]) -> RootListRow:
+        resolved_root = canonical_path(root)
+        project_count = sum(
+            project.path.is_relative_to(resolved_root)
+            for project in projects
+            if project.source is ProjectSource.DISCOVERED
+        )
+
+        return cls(
+            path=format_path(root),
+            projects=str(project_count),
+            status="available" if root.is_dir() else "missing",
+        )
+
+
+class RootListTable:
+    HEADERS: ClassVar[tuple[str, str, str]] = ("PATH", "PROJECTS", "STATUS")
+
+    _rows: tuple[RootListRow, ...]
+
+    def __init__(self, roots: Sequence[Path], projects: Sequence[Project]) -> None:
+        self._rows = tuple(RootListRow.from_root(root, projects) for root in roots)
+
+    def render(self) -> str:
+        if not self._rows:
+            return "No roots found."
+
+        table = (self.HEADERS, *self._rows)
+        columns = zip(*table, strict=True)
+        widths = tuple(max(len(value) for value in column) for column in columns)
+
+        return "\n".join(self._render_row(row, widths) for row in table)
+
+    @staticmethod
+    def _render_row(row: tuple[str, ...], widths: tuple[int, ...]) -> str:
+        return "  ".join(
+            value.ljust(width) for value, width in zip(row, widths, strict=True)
+        ).rstrip()
+
+
+@click.command()
+@click.pass_obj
+def init(catalog: ProjectCatalog) -> None:
+    """Register the current directory as a scan root."""
+    current = Path.cwd()
+    parent = catalog.find_parent_root(current)
+    added = catalog.add_scan_root(current)
+
+    if not added:
+        click.echo(f"Already a root: {format_path(current)}")
+        return
+
+    if parent is not None:
+        click.echo(f"Note: root is inside {format_path(parent)}", err=True)
+
+    click.echo(f"Added root: {format_path(current)}")
+
+
+@click.command()
+@click.pass_obj
+def uninit(catalog: ProjectCatalog) -> None:
+    """Remove the current directory from scan roots."""
+    current = Path.cwd()
+    if catalog.remove_scan_root(current):
+        click.echo(f"Removed root: {format_path(current)}")
+        return
+
+    click.echo("Current directory is not a pcd root.", err=True)
+    raise click.exceptions.Exit(ExitCode.ERROR)
+
+
+@click.command()
+@click.pass_obj
+def roots(catalog: ProjectCatalog) -> None:
+    """List registered scan roots with project counts and status."""
+    settings = catalog.config.load()
+    table = RootListTable(settings.roots, catalog.projects())
+    click.echo(table.render())
+
+
+@click.command()
+@click.pass_obj
+def refresh(catalog: ProjectCatalog) -> None:
+    """Rescan roots and rebuild the project cache."""
+    click.echo(f"Found {len(catalog.refresh())} projects.")
+
+
+root_commands = (init, uninit, roots, refresh)

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/src/pcd_cli/cli/shell.py

@@ -84,17 +84,22 @@ def uninstall_shell(shell: str | None) -> None:
     required=False,
     type=click.Choice([item.value for item in Shell], case_sensitive=False),
 )
-def print_shell_integration(shell: str | None) -> None:
+@click.pass_context
+def print_shell_integration(ctx: click.Context, shell: str | None) -> None:
     """Print shell integration for manual dotfile management."""
     selected = _selected_shell(shell)
-    click.echo(render_shell_integration(selected), nl=False)
+    click.echo(render_shell_integration(selected, _registered_command_names(ctx)), nl=False)
 
 
 @click.command("shell-init", hidden=True)
 @click.argument("shell", type=click.Choice([item.value for item in Shell], case_sensitive=False))
-def shell_init(shell: str) -> None:
+@click.pass_context
+def shell_init(ctx: click.Context, shell: str) -> None:
     """Backward-compatible alias for `pcd shell print`."""
-    click.echo(render_shell_integration(Shell(shell.casefold())), nl=False)
+    click.echo(
+        render_shell_integration(Shell(shell.casefold()), _registered_command_names(ctx)),
+        nl=False,
+    )
 
 
 def _shell_integration(shell: str | None) -> ShellIntegration:
@@ -109,3 +114,11 @@ def _selected_shell(shell: str | None) -> Shell:
         return detect_shell()
     except ShellIntegrationError as exc:
         raise click.UsageError(str(exc)) from exc
+
+
+def _registered_command_names(ctx: click.Context) -> tuple[str, ...]:
+    root = ctx.find_root()
+    if not isinstance(root.command, click.Group):
+        return ()
+
+    return tuple(root.command.list_commands(root))

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/src/pcd_cli/navigation.py

@@ -31,7 +31,7 @@ def navigate_to_project(
         click.echo(f"Project not found{suffix}", err=True)
         raise click.exceptions.Exit(ExitCode.NOT_FOUND)
 
-    selected = matches[0] if len(matches) == 1 else select_project(catalog, matches, query or "")
+    selected = select_project(catalog, matches, query or "")
     if selected is not None:
         _open_project(catalog, selected)
 
@@ -41,10 +41,13 @@ def select_project(
     projects: Sequence[Project],
     query: str = "",
 ) -> Project | None:
-    # Import lazily so shell completion never initializes terminal UI machinery.
-    from pcd_cli.picker import ProjectPicker
+    if len(projects) == 1:
+        return projects[0]
+    else:
+        # Import lazily so shell completion never initializes terminal UI machinery.
+        from pcd_cli.picker import ProjectPicker
 
-    return ProjectPicker(projects, catalog.history.load(), query).run()
+        return ProjectPicker(projects, catalog.history.load(), query).run()
 
 
 def project_completions(value: str) -> list[CompletionItem]:

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/src/pcd_cli/picker.py

@@ -139,4 +139,5 @@ class ProjectPicker:
 
         if len(self.matches) > PAGE_SIZE:
             lines.append(("dim", f"\n{self.selected_index + 1}/{len(self.matches)}\n"))
+
         return lines

{pcd_cli-0.2.0 → pcd_cli-0.2.2}/src/pcd_cli/shell_integration.py

@@ -6,7 +6,7 @@ from dataclasses import dataclass
 from enum import StrEnum
 from pathlib import Path
 from textwrap import dedent
-from typing import Self
+from typing import Literal, Self
 
 from pcd_cli.filesystem import atomic_write, file_lock
 
@@ -160,9 +160,18 @@ def render_managed_block(shell: Shell) -> str:
     return f"{_MANAGED_BLOCK_START}\n{command}\n{_MANAGED_BLOCK_END}\n"
 
 
-def render_shell_integration(shell: Shell) -> str:
+def render_shell_integration(shell: Shell, direct_commands: tuple[str, ...] = ()) -> str:
     """Generate shell integration for directory changes and Click completion."""
-    return _fish() if shell is Shell.FISH else _posix(shell)
+    commands = tuple(sorted(set(direct_commands)))
+    match shell:
+        case Shell.FISH:
+            return _fish(commands)
+        case Shell.BASH:
+            return _posix("bash_source", commands)
+        case Shell.ZSH:
+            return _posix("zsh_source", commands)
+        case _:
+            raise ValueError(f"Unsupported shell: {shell}")
 
 
 def _integration_state(content: str, shell: Shell) -> ShellIntegrationState:
@@ -200,8 +209,8 @@ def _managed_block_bounds(content: str) -> tuple[int, int] | None:
     return start, end
 
 
-def _posix(shell: Shell) -> str:
-    completion = "bash_source" if shell is Shell.BASH else "zsh_source"
+def _posix(completion: Literal["bash_source", "zsh_source"], commands: tuple[str, ...]) -> str:
+    direct_patterns = "|".join(("-*", *commands))
     return dedent(
         f"""\
         pcd() {{
@@ -210,6 +219,18 @@ def _posix(shell: Shell) -> str:
                 return $?
             fi
 
+            if [ "$#" -eq 0 ]; then
+                command pcd
+                return $?
+            fi
+            case "$1" in
+                --project|--project=*) : ;;
+                {direct_patterns})
+                    command pcd "$@"
+                    return $?
+                    ;;
+            esac
+
             local output code
             if output="$({SHELL_MODE_ENV}=1 command pcd "$@")"; then
                 code=0
@@ -234,7 +255,8 @@ def _posix(shell: Shell) -> str:
     )
 
 
-def _fish() -> str:
+def _fish(commands: tuple[str, ...]) -> str:
+    direct_patterns = " ".join(("'-*'", *commands))
     return dedent(
         f"""\
         function pcd
@@ -243,6 +265,18 @@ def _fish() -> str:
                 return $status
             end
 
+            if test (count $argv) -eq 0
+                command pcd
+                return $status
+            end
+            switch $argv[1]
+                case '--project' '--project=*'
+                    true
+                case {direct_patterns}
+                    command pcd $argv
+                    return $status
+            end
+
             set -l output (env {SHELL_MODE_ENV}=1 command pcd $argv)
             set -l code $status
             if test $code -eq {SHELL_CD_EXIT_CODE}

pcd_cli-0.2.0/src/pcd_cli/cli/projects.py

@@ -1,155 +0,0 @@
-from __future__ import annotations
-
-from pathlib import Path
-from typing import TYPE_CHECKING
-
-import click
-
-from pcd_cli.filesystem import canonical_path, format_path
-from pcd_cli.models import ExitCode, Project, ProjectSource
-from pcd_cli.navigation import navigate_to_project, project_completions, select_project
-
-if TYPE_CHECKING:
-    from pcd_cli.catalog import ProjectCatalog
-
-
-@click.command(hidden=True)
-@click.argument("query")
-@click.pass_obj
-def project(catalog: ProjectCatalog, query: str) -> None:
-    """Resolve a project name routed by the root command."""
-    navigate_to_project(catalog, query)
-
-
-@click.command()
-@click.pass_obj
-def init(catalog: ProjectCatalog) -> None:
-    """Register the current directory as a scan root."""
-    current = Path.cwd()
-    parent = catalog.find_parent_root(current)
-    added = catalog.add_scan_root(current)
-
-    if not added:
-        click.echo(f"Already a root: {format_path(current)}")
-        return
-
-    if parent is not None:
-        click.echo(f"Note: root is inside {format_path(parent)}", err=True)
-
-    click.echo(f"Added root: {format_path(current)}")
-
-
-@click.command()
-@click.pass_obj
-def uninit(catalog: ProjectCatalog) -> None:
-    """Remove the current directory from scan roots."""
-    current = Path.cwd()
-    if catalog.remove_scan_root(current):
-        click.echo(f"Removed root: {format_path(current)}")
-        return
-
-    click.echo("Current directory is not a pcd root.", err=True)
-    raise click.exceptions.Exit(ExitCode.ERROR)
-
-
-@click.command()
-@click.argument("path", type=click.Path(path_type=Path, file_okay=False), required=False)
-@click.option("--name", help="Custom name for a manual project.")
-@click.pass_obj
-def add(catalog: ProjectCatalog, path: Path | None, name: str | None) -> None:
-    """Register a directory as a manual project."""
-    if path is None:
-        location = Path.cwd()
-    else:
-        try:
-            location = path.expanduser()
-        except RuntimeError as exc:
-            raise click.BadParameter("Unknown home directory", param_hint="path") from exc
-
-    if not location.is_absolute():
-        location = Path.cwd() / location
-    if not location.is_dir():
-        raise click.BadParameter(f"Directory does not exist: {location}", param_hint="path")
-
-    project_name = location.name if name is None else name.strip()
-    if not project_name:
-        raise click.BadParameter("Project name cannot be empty", param_hint="--name")
-
-    item = Project(
-        name=project_name,
-        path=canonical_path(location),
-        display_path=location,
-        source=ProjectSource.MANUAL,
-    )
-    if catalog.add_project(item):
-        click.echo(f"Added project: {item.name} -> {format_path(item.display_path)}")
-        return
-
-    click.echo(f"Project already exists: {item.name} -> {format_path(item.display_path)}")
-
-
-@click.command()
-@click.argument(
-    "query",
-    shell_complete=lambda _ctx, _param, value: project_completions(value),
-)
-@click.pass_obj
-def remove(catalog: ProjectCatalog, query: str) -> None:
-    """Remove a manual project registration."""
-    matches = catalog.search(query, exact_only=True)
-    if not matches:
-        click.echo(f"Project not found: {query}", err=True)
-        raise click.exceptions.Exit(ExitCode.NOT_FOUND)
-
-    selected = matches[0] if len(matches) == 1 else select_project(catalog, matches, query)
-    if selected is None:
-        return
-
-    if selected.source is ProjectSource.DISCOVERED:
-        click.echo(
-            f"{selected.name} is discovered automatically and cannot be removed with pcd remove.",
-            err=True,
-        )
-        raise click.exceptions.Exit(ExitCode.ERROR)
-
-    if catalog.remove_project(selected.path):
-        click.echo(f"Removed project: {selected.name}")
-        return
-
-    click.echo("Project is no longer registered.", err=True)
-    raise click.exceptions.Exit(ExitCode.ERROR)
-
-
-@click.command("list")
-@click.pass_obj
-def list_projects(catalog: ProjectCatalog) -> None:
-    """List all known projects."""
-    projects = catalog.projects()
-    if not projects:
-        click.echo("No projects found.")
-        return
-
-    name_width = max(len(project.name) for project in projects)
-    for item in projects:
-        status = "ok" if item.path.is_dir() else "missing"
-        click.echo(
-            f"{item.name:<{name_width}}  {format_path(item.display_path)}  {item.source.value:<10}  {status}"
-        )
-
-
-@click.command()
-@click.pass_obj
-def roots(catalog: ProjectCatalog) -> None:
-    """List registered scan roots."""
-    for root in catalog.config.load().roots:
-        click.echo(format_path(root))
-
-
-@click.command()
-@click.pass_obj
-def refresh(catalog: ProjectCatalog) -> None:
-    """Rescan roots and rebuild the project cache."""
-    click.echo(f"Found {len(catalog.refresh())} projects.")
-
-
-project_commands = (project, init, uninit, add, remove, list_projects, roots, refresh)