codexa 0.4.0__py3-none-any.whl

semantic_code_intelligence/cli/commands/watch_cmd.py

@@ -0,0 +1,72 @@
+"""CLI command: watch — run the background indexing daemon."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+
+from semantic_code_intelligence.config.settings import AppConfig
+from semantic_code_intelligence.daemon.watcher import IndexingDaemon
+from semantic_code_intelligence.utils.logging import (
+    get_logger,
+    print_error,
+    print_info,
+    print_success,
+)
+
+logger = get_logger("cli.watch")
+
+
+@click.command("watch")
+@click.option(
+    "--path",
+    "-p",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Project root path.",
+)
+@click.option(
+    "--interval",
+    "-i",
+    default=2.0,
+    type=float,
+    help="Polling interval in seconds.",
+)
+@click.pass_context
+def watch_cmd(ctx: click.Context, path: str, interval: float) -> None:
+    """Watch the repository for changes and re-index automatically.
+
+    Starts a background daemon that polls for file changes and triggers
+    incremental re-indexing.
+
+    Press Ctrl+C to stop.
+
+    Examples:
+
+        codexa watch
+
+        codexa watch --interval 5
+    """
+    root = Path(path).resolve()
+    config_dir = AppConfig.config_dir(root)
+
+    if not config_dir.exists():
+        print_error("Project not initialized. Run 'codexa init' first.")
+        return
+
+    print_info(f"Starting watch daemon for {root} (poll every {interval}s)")
+    print_info("Press Ctrl+C to stop.")
+
+    daemon = IndexingDaemon(root, poll_interval=interval)
+    daemon.start()
+
+    try:
+        import time
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        pass
+    finally:
+        daemon.stop()
+        print_success("Watch daemon stopped.")

semantic_code_intelligence/cli/commands/web_cmd.py

@@ -0,0 +1,61 @@
+"""CLI command: web — start the CodexA web interface and REST API."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+import click
+
+from semantic_code_intelligence.utils.logging import get_logger, print_info
+
+logger = get_logger("cli.web")
+
+
+@click.command("web")
+@click.option(
+    "--host",
+    "-h",
+    default="127.0.0.1",
+    type=str,
+    help="Host to bind the web server to.",
+)
+@click.option(
+    "--port",
+    "-p",
+    default=8080,
+    type=int,
+    help="Port to bind the web server to.",
+)
+@click.option(
+    "--path",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Project root path.",
+)
+@click.pass_context
+def web_cmd(
+    ctx: click.Context,
+    host: str,
+    port: int,
+    path: str,
+) -> None:
+    """Start the CodexA web interface and REST API server.
+
+    Provides a browser-based search UI and JSON REST endpoints
+    for programmatic access.  Uses only the Python standard library.
+
+    Examples:
+
+        codexa web
+
+        codexa web --port 9000
+
+        codexa web --host 0.0.0.0 --port 8080 --path /my/project
+    """
+    from semantic_code_intelligence.web.server import WebServer
+
+    project_root = Path(path)
+    server = WebServer(project_root, host=host, port=port)
+    print_info(f"Starting CodexA web server on {server.url}")
+    print_info("Press Ctrl+C to stop.")
+    server.start()

semantic_code_intelligence/cli/commands/workspace_cmd.py

@@ -0,0 +1,250 @@
+"""CLI command: workspace — manage multi-repo workspaces."""
+
+from __future__ import annotations
+
+import json as json_mod
+from pathlib import Path
+
+import click
+
+from semantic_code_intelligence.utils.logging import (
+    console,
+    get_logger,
+    print_error,
+    print_info,
+    print_success,
+    print_warning,
+)
+
+logger = get_logger("cli.workspace")
+
+
+@click.group("workspace")
+def workspace_cmd() -> None:
+    """Manage multi-repository workspaces."""
+
+
+@workspace_cmd.command("init")
+@click.option(
+    "--path",
+    "-p",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Workspace root directory.",
+)
+def workspace_init(path: str) -> None:
+    """Initialise a new workspace."""
+    from semantic_code_intelligence.workspace import Workspace
+
+    ws = Workspace.load_or_create(Path(path))
+    ws.save()
+    print_success(f"Workspace initialised at {ws.root}")
+
+
+@workspace_cmd.command("add")
+@click.argument("name")
+@click.argument("repo_path", type=click.Path(exists=True, file_okay=False, resolve_path=True))
+@click.option(
+    "--path",
+    "-p",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Workspace root directory.",
+)
+def workspace_add(name: str, repo_path: str, path: str) -> None:
+    """Register a repository in the workspace."""
+    from semantic_code_intelligence.workspace import Workspace
+
+    try:
+        ws = Workspace.load(Path(path))
+    except FileNotFoundError:
+        print_error("Workspace not initialised. Run 'codexa workspace init' first.")
+        return
+
+    try:
+        ws.add_repo(name, Path(repo_path))
+        ws.save()
+        print_success(f"Added repository '{name}' → {repo_path}")
+    except (ValueError, FileNotFoundError) as exc:
+        print_error(str(exc))
+
+
+@workspace_cmd.command("remove")
+@click.argument("name")
+@click.option(
+    "--path",
+    "-p",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Workspace root directory.",
+)
+def workspace_remove(name: str, path: str) -> None:
+    """Unregister a repository from the workspace."""
+    from semantic_code_intelligence.workspace import Workspace
+
+    try:
+        ws = Workspace.load(Path(path))
+    except FileNotFoundError:
+        print_error("Workspace not initialised.")
+        return
+
+    if ws.remove_repo(name):
+        ws.save()
+        print_success(f"Removed repository '{name}'.")
+    else:
+        print_warning(f"Repository '{name}' not found in workspace.")
+
+
+@workspace_cmd.command("list")
+@click.option(
+    "--json-output",
+    "--json",
+    "json_mode",
+    is_flag=True,
+    default=False,
+    help="Output in JSON format.",
+)
+@click.option(
+    "--path",
+    "-p",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Workspace root directory.",
+)
+def workspace_list(json_mode: bool, path: str) -> None:
+    """List all repositories in the workspace."""
+    from semantic_code_intelligence.workspace import Workspace
+
+    try:
+        ws = Workspace.load(Path(path))
+    except FileNotFoundError:
+        print_error("Workspace not initialised.")
+        return
+
+    if json_mode:
+        click.echo(json_mod.dumps(ws.summary(), indent=2))
+    else:
+        repos = ws.repos
+        if not repos:
+            print_info("No repositories registered.")
+            return
+        from rich.table import Table
+
+        table = Table(title=f"Workspace: {ws.root}")
+        table.add_column("Name", style="cyan")
+        table.add_column("Path")
+        table.add_column("Files", justify="right")
+        table.add_column("Vectors", justify="right")
+        for r in repos:
+            table.add_row(r.name, r.path, str(r.file_count), str(r.vector_count))
+        console.print(table)
+
+
+@workspace_cmd.command("index")
+@click.option(
+    "--repo",
+    "-r",
+    default=None,
+    help="Index only this repository (by name).",
+)
+@click.option(
+    "--force",
+    is_flag=True,
+    default=False,
+    help="Force full re-index.",
+)
+@click.option(
+    "--path",
+    "-p",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Workspace root directory.",
+)
+def workspace_index(repo: str | None, force: bool, path: str) -> None:
+    """Index repositories in the workspace."""
+    from semantic_code_intelligence.workspace import Workspace
+
+    try:
+        ws = Workspace.load(Path(path))
+    except FileNotFoundError:
+        print_error("Workspace not initialised.")
+        return
+
+    if repo:
+        try:
+            result = ws.index_repo(repo, force=force)
+            ws.save()
+            print_success(
+                f"[{repo}] Indexed {result.files_indexed} files "
+                f"({result.chunks_created} chunks, {result.total_vectors} vectors)"
+            )
+        except KeyError:
+            print_error(f"Repository '{repo}' not registered.")
+    else:
+        results = ws.index_all(force=force)
+        for name, result in results.items():
+            print_success(
+                f"[{name}] Indexed {result.files_indexed} files "
+                f"({result.chunks_created} chunks, {result.total_vectors} vectors)"
+            )
+
+
+@workspace_cmd.command("search")
+@click.argument("query")
+@click.option("--top-k", "-k", default=10, type=int, help="Number of results.")
+@click.option("--threshold", "-t", default=0.3, type=float, help="Minimum score.")
+@click.option(
+    "--repo",
+    "-r",
+    multiple=True,
+    help="Restrict to specific repos (repeatable).",
+)
+@click.option(
+    "--json-output",
+    "--json",
+    "json_mode",
+    is_flag=True,
+    default=False,
+    help="Output in JSON format.",
+)
+@click.option(
+    "--path",
+    "-p",
+    default=".",
+    type=click.Path(exists=True, file_okay=False, resolve_path=True),
+    help="Workspace root directory.",
+)
+def workspace_search(
+    query: str,
+    top_k: int,
+    threshold: float,
+    repo: tuple[str, ...],
+    json_mode: bool,
+    path: str,
+) -> None:
+    """Search across all workspace repositories."""
+    from semantic_code_intelligence.workspace import Workspace
+
+    try:
+        ws = Workspace.load(Path(path))
+    except FileNotFoundError:
+        print_error("Workspace not initialised.")
+        return
+
+    repos = list(repo) if repo else None
+    results = ws.search(query, top_k=top_k, threshold=threshold, repos=repos)
+
+    if json_mode:
+        click.echo(json_mod.dumps(results, indent=2))
+    else:
+        if not results:
+            print_info("No results found.")
+            return
+        from rich.panel import Panel
+        from rich.syntax import Syntax
+
+        for r in results:
+            lang = r.get("language", "text")
+            syn = Syntax(r["content"], lang, line_numbers=True, start_line=r["start_line"])
+            title = f"[{r['repo']}] {r['file_path']}:{r['start_line']}-{r['end_line']}  (score: {r['score']})"
+            console.print(Panel(syn, title=title, border_style="green"))

semantic_code_intelligence/cli/main.py

@@ -0,0 +1,65 @@
+"""Main CLI entry point for Semantic Code Intelligence."""
+
+from __future__ import annotations
+
+import sys
+
+import click
+
+from semantic_code_intelligence import __version__
+from semantic_code_intelligence.cli.router import register_commands
+from semantic_code_intelligence.utils.logging import setup_logging
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="codexa")
+@click.option(
+    "--verbose",
+    "-v",
+    is_flag=True,
+    default=False,
+    help="Enable verbose output.",
+)
+@click.option(
+    "--pipe",
+    is_flag=True,
+    default=False,
+    help="Pipeline mode — plain text output, no colors or spinners.",
+)
+@click.pass_context
+def cli(ctx: click.Context, verbose: bool, pipe: bool) -> None:
+    """CodexA - Local semantic code search and AI-assisted code understanding.
+
+    A CLI tool that indexes codebases, performs semantic search, and provides
+    structured code context for AI integration.
+    """
+    ctx.ensure_object(dict)
+    ctx.obj["verbose"] = verbose
+    ctx.obj["pipe"] = pipe
+    setup_logging(verbose=verbose)
+
+
+# Register all commands via the router
+register_commands(cli)
+
+
+def main() -> None:
+    """Entry point for the CLI application."""
+    try:
+        cli()
+    except KeyboardInterrupt:
+        click.echo("\nInterrupted.", err=True)
+        sys.exit(130)
+    except Exception as exc:  # noqa: BLE001
+        try:
+            from semantic_code_intelligence.utils.logging import error_console
+            error_console.print(f"[bold red]Fatal error:[/bold red] {exc}")
+            error_console.print("[dim]Run with --verbose for full traceback.[/dim]")
+        except (UnicodeEncodeError, OSError):
+            click.echo(f"Fatal error: {exc}", err=True)
+            click.echo("Run with --verbose for full traceback.", err=True)
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

semantic_code_intelligence/cli/router.py

@@ -0,0 +1,92 @@
+"""Command router - registers all CLI commands with the main group."""
+
+from __future__ import annotations
+
+import click
+
+from semantic_code_intelligence.cli.commands.init_cmd import init_cmd
+from semantic_code_intelligence.cli.commands.index_cmd import index_cmd
+from semantic_code_intelligence.cli.commands.search_cmd import search_cmd
+from semantic_code_intelligence.cli.commands.explain_cmd import explain_cmd
+from semantic_code_intelligence.cli.commands.summary_cmd import summary_cmd
+from semantic_code_intelligence.cli.commands.watch_cmd import watch_cmd
+from semantic_code_intelligence.cli.commands.deps_cmd import deps_cmd
+from semantic_code_intelligence.cli.commands.ask_cmd import ask_cmd
+from semantic_code_intelligence.cli.commands.review_cmd import review_cmd
+from semantic_code_intelligence.cli.commands.refactor_cmd import refactor_cmd
+from semantic_code_intelligence.cli.commands.suggest_cmd import suggest_cmd
+from semantic_code_intelligence.cli.commands.serve_cmd import serve_cmd
+from semantic_code_intelligence.cli.commands.context_cmd import context_cmd
+from semantic_code_intelligence.cli.commands.workspace_cmd import workspace_cmd
+from semantic_code_intelligence.cli.commands.docs_cmd import docs_cmd
+from semantic_code_intelligence.cli.commands.doctor_cmd import doctor_cmd
+from semantic_code_intelligence.cli.commands.plugin_cmd import plugin_cmd
+from semantic_code_intelligence.cli.commands.web_cmd import web_cmd
+from semantic_code_intelligence.cli.commands.viz_cmd import viz_cmd
+from semantic_code_intelligence.cli.commands.quality_cmd import quality_cmd
+from semantic_code_intelligence.cli.commands.pr_summary_cmd import pr_summary_cmd
+from semantic_code_intelligence.cli.commands.ci_gen_cmd import ci_gen_cmd
+from semantic_code_intelligence.cli.commands.chat_cmd import chat_cmd
+from semantic_code_intelligence.cli.commands.investigate_cmd import investigate_cmd
+from semantic_code_intelligence.cli.commands.cross_refactor_cmd import cross_refactor_cmd
+from semantic_code_intelligence.cli.commands.metrics_cmd import metrics_cmd
+from semantic_code_intelligence.cli.commands.gate_cmd import gate_cmd
+from semantic_code_intelligence.cli.commands.hotspots_cmd import hotspots_cmd
+from semantic_code_intelligence.cli.commands.impact_cmd import impact_cmd
+from semantic_code_intelligence.cli.commands.trace_cmd import trace_cmd
+from semantic_code_intelligence.cli.commands.tool_cmd import tool_cmd
+from semantic_code_intelligence.cli.commands.evolve_cmd import evolve_cmd
+from semantic_code_intelligence.cli.commands.tui_cmd import tui_cmd
+from semantic_code_intelligence.cli.commands.mcp_cmd import mcp_cmd
+from semantic_code_intelligence.cli.commands.lsp_cmd import lsp_cmd
+from semantic_code_intelligence.cli.commands.models_cmd import models_cmd
+from semantic_code_intelligence.cli.commands.benchmark_cmd import benchmark_cmd
+from semantic_code_intelligence.cli.commands.grep_cmd import grep_cmd
+from semantic_code_intelligence.cli.commands.languages_cmd import languages_cmd
+
+
+def register_commands(cli: click.Group) -> None:
+    """Register all available CLI commands with the main click group.
+
+    Args:
+        cli: The root click.Group to attach commands to.
+    """
+    cli.add_command(init_cmd)
+    cli.add_command(index_cmd)
+    cli.add_command(search_cmd)
+    cli.add_command(explain_cmd)
+    cli.add_command(summary_cmd)
+    cli.add_command(watch_cmd)
+    cli.add_command(deps_cmd)
+    cli.add_command(ask_cmd)
+    cli.add_command(review_cmd)
+    cli.add_command(refactor_cmd)
+    cli.add_command(suggest_cmd)
+    cli.add_command(serve_cmd)
+    cli.add_command(context_cmd)
+    cli.add_command(workspace_cmd)
+    cli.add_command(docs_cmd)
+    cli.add_command(doctor_cmd)
+    cli.add_command(plugin_cmd)
+    cli.add_command(web_cmd)
+    cli.add_command(viz_cmd)
+    cli.add_command(quality_cmd)
+    cli.add_command(pr_summary_cmd)
+    cli.add_command(ci_gen_cmd)
+    cli.add_command(chat_cmd)
+    cli.add_command(investigate_cmd)
+    cli.add_command(cross_refactor_cmd)
+    cli.add_command(metrics_cmd)
+    cli.add_command(gate_cmd)
+    cli.add_command(hotspots_cmd)
+    cli.add_command(impact_cmd)
+    cli.add_command(trace_cmd)
+    cli.add_command(tool_cmd)
+    cli.add_command(evolve_cmd)
+    cli.add_command(tui_cmd)
+    cli.add_command(mcp_cmd)
+    cli.add_command(lsp_cmd)
+    cli.add_command(models_cmd)
+    cli.add_command(benchmark_cmd)
+    cli.add_command(grep_cmd)
+    cli.add_command(languages_cmd)