ctxgraph-code 0.1.0__tar.gz → 0.1.1__tar.gz

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.1.0
+Version: 0.1.1
 Summary: Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions.
 Author: ctxgraph-code contributors
 License: MIT
@@ -70,11 +70,21 @@ ctxgraph-code setup
 ctxgraph-code setup
 ```
 
+Interactive walkthrough — prompts for:
+- **File extensions** to scan (`.py`, `.js`, `.ts`, etc.)
+- **Exclude patterns** (folders like `tests/`, globs like `*.generated.py`)
+
 Does everything in one step:
-1. Creates `.ctxgraph/config.toml` with defaults
-2. Builds the knowledge graph from all Python files
+1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
+2. Builds the knowledge graph from all matching files
 3. Creates `.claude/commands/ctxgraph-code.md` with instructions for Claude Code
 
+Non-interactive mode (skip prompts):
+```bash
+ctxgraph-code setup --extensions .py,.js,.ts --exclude tests/,examples/
+ctxgraph-code setup -y                                 # all defaults
+```
+
 ### `init`
 
 ```bash
@@ -87,10 +97,12 @@ Creates the `.ctxgraph/` directory with a default `config.toml`.
 
 ```bash
 ctxgraph-code build
-ctxgraph-code build --exclude "tests/" --exclude "*.generated.py"
+ctxgraph-code build --extensions .py,.js,.ts
+ctxgraph-code build --exclude tests/ --exclude *.generated.py
 ```
 
-Scans all `*.py` files in the project, runs AST analysis:
+Scans all matching files in the project, runs AST analysis. Extensions are read from config (`.py` by default, or whatever was set in `setup`).
+
 - **Imports**: which files import other files
 - **Class definitions**: class names, base classes, methods
 - **Function definitions**: function names, arguments
@@ -99,6 +111,8 @@ Scans all `*.py` files in the project, runs AST analysis:
 
 Stores the result in `.ctxgraph/graph.db`.
 
+> The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Claude Code will also rebuild when it detects the graph is stale.
+
 ### `query`
 
 ```bash
@@ -234,11 +248,13 @@ Claude then uses these commands as needed during the conversation.
 
 ## Configuration
 
-Configure via `.ctxgraph/config.toml` (created by `init` or `setup`):
+Configure via `.ctxgraph/config.toml` (created interactively by `setup` or manually):
 
 ```toml
 [graph]
-# Additional exclude patterns beyond defaults
+# File extensions to scan
+extensions = [".py", ".js", ".ts"]
+# Exclude patterns beyond built-in defaults
 exclude = ["tests/", "examples/"]
 # Follow symlinks when scanning
 follow_symlinks = false
@@ -246,7 +262,7 @@ follow_symlinks = false
 max_file_size_mb = 5
 ```
 
-Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
+Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
 
 ---
 

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.1}/README.md

@@ -47,11 +47,21 @@ ctxgraph-code setup
 ctxgraph-code setup
 ```
 
+Interactive walkthrough — prompts for:
+- **File extensions** to scan (`.py`, `.js`, `.ts`, etc.)
+- **Exclude patterns** (folders like `tests/`, globs like `*.generated.py`)
+
 Does everything in one step:
-1. Creates `.ctxgraph/config.toml` with defaults
-2. Builds the knowledge graph from all Python files
+1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
+2. Builds the knowledge graph from all matching files
 3. Creates `.claude/commands/ctxgraph-code.md` with instructions for Claude Code
 
+Non-interactive mode (skip prompts):
+```bash
+ctxgraph-code setup --extensions .py,.js,.ts --exclude tests/,examples/
+ctxgraph-code setup -y                                 # all defaults
+```
+
 ### `init`
 
 ```bash
@@ -64,10 +74,12 @@ Creates the `.ctxgraph/` directory with a default `config.toml`.
 
 ```bash
 ctxgraph-code build
-ctxgraph-code build --exclude "tests/" --exclude "*.generated.py"
+ctxgraph-code build --extensions .py,.js,.ts
+ctxgraph-code build --exclude tests/ --exclude *.generated.py
 ```
 
-Scans all `*.py` files in the project, runs AST analysis:
+Scans all matching files in the project, runs AST analysis. Extensions are read from config (`.py` by default, or whatever was set in `setup`).
+
 - **Imports**: which files import other files
 - **Class definitions**: class names, base classes, methods
 - **Function definitions**: function names, arguments
@@ -76,6 +88,8 @@ Scans all `*.py` files in the project, runs AST analysis:
 
 Stores the result in `.ctxgraph/graph.db`.
 
+> The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Claude Code will also rebuild when it detects the graph is stale.
+
 ### `query`
 
 ```bash
@@ -211,11 +225,13 @@ Claude then uses these commands as needed during the conversation.
 
 ## Configuration
 
-Configure via `.ctxgraph/config.toml` (created by `init` or `setup`):
+Configure via `.ctxgraph/config.toml` (created interactively by `setup` or manually):
 
 ```toml
 [graph]
-# Additional exclude patterns beyond defaults
+# File extensions to scan
+extensions = [".py", ".js", ".ts"]
+# Exclude patterns beyond built-in defaults
 exclude = ["tests/", "examples/"]
 # Follow symlinks when scanning
 follow_symlinks = false
@@ -223,7 +239,7 @@ follow_symlinks = false
 max_file_size_mb = 5
 ```
 
-Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
+Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
 
 ---
 

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ctxgraph-code"
-version = "0.1.0"
+version = "0.1.1"
 description = "Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions."
 readme = "README.md"
 license = {text = "MIT"}

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.1}/src/ctxgraph_code/cli.py

@@ -24,11 +24,25 @@ app = typer.Typer(name="ctxgraph-code", help="Code knowledge graph for Claude Co
 console = Console()
 
 
+def _build_time_label(storage) -> str:
+    ts = storage.get_metadata("build_time")
+    if ts:
+        try:
+            from datetime import datetime
+            dt = datetime.fromtimestamp(float(ts))
+            return dt.strftime("%Y-%m-%d %H:%M")
+        except Exception:
+            return ts
+    return "unknown"
+
+
 SLASH_COMMAND_TEMPLATE = """# ctxgraph-code: Code Relationship Graph
 
 This project has a knowledge graph at `.ctxgraph/graph.db`.
 The graph knows about imports, class hierarchies, and function calls.
 
+**Last build:** {build_time}
+
 **Available commands** (run these as shell commands in the terminal):
 
 - `ctxgraph-code query "search terms"` -- Find relevant files, classes, and functions
@@ -43,6 +57,9 @@ The graph knows about imports, class hierarchies, and function calls.
 - When exploring an unfamiliar area, run `query` to find relevant files, then read them.
 - When asked about architecture, run `overview` for the big picture.
 - For complex tasks, run `context "what I need to do"` for a focused summary.
+
+**Note:** The graph is a static snapshot. If files have changed since the last build,
+run `ctxgraph-code build` to refresh it.
 """
 
 
@@ -70,11 +87,14 @@ def build(
     repo_path: Optional[str] = typer.Argument(
         None, help="Path to repository (default: current directory)"
     ),
+    extensions: Optional[str] = typer.Option(
+        None, "--extensions", help="File extensions to scan, e.g. .py,.js,.ts"
+    ),
     exclude: Optional[list[str]] = typer.Option(
         None, "--exclude", "-e", help="Additional exclude patterns"
     ),
 ):
-    """Build the knowledge graph from Python source files."""
+    """Build the knowledge graph from source files."""
     path = Path(repo_path).resolve() if repo_path else Path.cwd()
 
     settings = Settings(path)
@@ -82,11 +102,16 @@ def build(
     if exclude:
         user_patterns = list((user_patterns or []) + exclude)
 
+    exts = settings.extensions
+    if extensions:
+        exts = [e.strip() for e in extensions.split(",") if e.strip()]
+
     if not (path / ".ctxgraph").exists():
         (path / ".ctxgraph").mkdir(parents=True, exist_ok=True)
 
-    with console.status(f"Analyzing {path}..."):
-        stats = build_graph(path, exclude_patterns=user_patterns)
+    ext_label = ", ".join(exts)
+    with console.status(f"Scanning {ext_label} files in {path}..."):
+        stats = build_graph(path, exclude_patterns=user_patterns, extensions=exts)
 
     table = Table(title="Graph Build Complete")
     table.add_column("Metric", style="cyan")
@@ -247,16 +272,52 @@ def setup(
     repo_path: Optional[str] = typer.Argument(
         None, help="Path to repository (default: current directory)"
     ),
+    extensions: Optional[str] = typer.Option(
+        None, "--extensions", help="File extensions to scan, e.g. .py,.js,.ts"
+    ),
+    exclude: Optional[str] = typer.Option(
+        None, "--exclude", help="Exclude patterns, e.g. tests/,examples/"
+    ),
+    non_interactive: bool = typer.Option(
+        False, "--yes", "-y", help="Skip prompts, use defaults"
+    ),
 ):
-    """Initialize config, build the graph, and configure Claude Code integration."""
+    """Initialize config, build the graph, and configure Claude Code."""
     path = Path(repo_path).resolve() if repo_path else Path.cwd()
 
-    init_project(path)
+    if non_interactive:
+        exts = [".py"]
+        excl = []
+    elif extensions:
+        exts = [e.strip() for e in extensions.split(",") if e.strip()]
+        excl = [e.strip() for e in exclude.split(",") if e.strip()] if exclude else []
+    else:
+        console.print("[bold cyan]ctxgraph-code setup[/bold cyan]")
+        console.print("Let's configure your project graph.\n")
+
+        ext_input = typer.prompt(
+            "File extensions to scan (comma-separated)",
+            default=".py",
+            prompt_suffix=": ",
+        )
+        exts = [e.strip() for e in ext_input.split(",") if e.strip()]
+        if not exts:
+            exts = [".py"]
+
+        excl_input = typer.prompt(
+            "Exclude patterns (comma-separated, e.g. tests/,examples/)",
+            default="",
+            prompt_suffix=": ",
+        )
+        excl = [e.strip() for e in excl_input.split(",") if e.strip()] if excl_input.strip() else []
+
+        console.print()
+
+    init_project(path, extensions=exts, exclude_patterns=excl)
     console.print(f"[green][OK] Initialized .ctxgraph/[/green]")
 
-    settings = Settings(path)
-    with console.status(f"Building graph for {path}..."):
-        stats = build_graph(path, exclude_patterns=settings.exclude_patterns)
+    with console.status(f"Scanning {', '.join(exts)} files in {path}..."):
+        stats = build_graph(path, exclude_patterns=excl, extensions=exts)
 
     table = Table(title="Graph Build Complete")
     table.add_column("Metric", style="cyan")
@@ -273,8 +334,13 @@ def setup(
     claude_dir = path / ".claude" / "commands"
     claude_dir.mkdir(parents=True, exist_ok=True)
     slash_path = claude_dir / "ctxgraph-code.md"
+
+    storage = get_storage(path)
+    build_label = _build_time_label(storage) if storage else "unknown"
+    content = SLASH_COMMAND_TEMPLATE.format(build_time=build_label)
+
     if not slash_path.exists():
-        slash_path.write_text(SLASH_COMMAND_TEMPLATE, encoding="utf-8")
+        slash_path.write_text(content, encoding="utf-8")
         console.print(f"[green][OK] Created {slash_path}[/green]")
     else:
         console.print(f"[yellow]  Skipped (already exists): {slash_path}[/yellow]")

ctxgraph_code-0.1.1/src/ctxgraph_code/config/init.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+from ctxgraph_code.config.settings import create_default_config
+
+
+def init_project(
+    repo_path: Path,
+    extensions: Optional[list[str]] = None,
+    exclude_patterns: Optional[list[str]] = None,
+) -> Path:
+    cfg_dir = repo_path / ".ctxgraph"
+    cfg_dir.mkdir(parents=True, exist_ok=True)
+
+    create_default_config(repo_path, extensions=extensions, exclude_patterns=exclude_patterns)
+
+    return cfg_dir

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.1}/src/ctxgraph_code/config/settings.py

@@ -8,6 +8,7 @@ from typing import Optional
 
 DEFAULT_CONFIG = {
     "graph": {
+        "extensions": [".py"],
         "exclude": [],
         "follow_symlinks": False,
         "max_file_size_mb": 5,
@@ -43,6 +44,11 @@ class Settings:
             parsed = self._parse_toml(text)
             self._deep_merge(self._data, parsed)
 
+    @property
+    def extensions(self) -> list[str]:
+        exts = self._data["graph"].get("extensions", [".py"])
+        return [e if e.startswith(".") else f".{e}" for e in exts]
+
     @property
     def exclude_patterns(self) -> list[str]:
         return self._data["graph"].get("exclude", [])
@@ -67,8 +73,10 @@ class Settings:
                 key = key.strip()
                 value = value.strip()
 
-                if (value.startswith('"') and value.endswith('"')) or \
-                   (value.startswith("'") and value.endswith("'")):
+                if value.startswith("[") and value.endswith("]"):
+                    value = Settings._parse_toml_array(value)
+                elif (value.startswith('"') and value.endswith('"')) or \
+                     (value.startswith("'") and value.endswith("'")):
                     value = value[1:-1]
                 else:
                     value = Settings._parse_toml_value(value)
@@ -77,6 +85,21 @@ class Settings:
 
         return result
 
+    @staticmethod
+    def _parse_toml_array(text: str) -> list:
+        inner = text[1:-1].strip()
+        if not inner:
+            return []
+        items = []
+        for item in inner.split(","):
+            item = item.strip()
+            if (item.startswith('"') and item.endswith('"')) or \
+               (item.startswith("'") and item.endswith("'")):
+                items.append(item[1:-1])
+            else:
+                items.append(Settings._parse_toml_value(item))
+        return items
+
     @staticmethod
     def _parse_toml_value(value: str):
         if value.lower() in ("true", "false"):
@@ -97,7 +120,11 @@ class Settings:
                 base[key] = value
 
 
-def create_default_config(repo_path: Path):
+def create_default_config(
+    repo_path: Path,
+    extensions: Optional[list[str]] = None,
+    exclude_patterns: Optional[list[str]] = None,
+):
     config_dir = repo_path / ".ctxgraph"
     config_dir.mkdir(parents=True, exist_ok=True)
 
@@ -105,12 +132,20 @@ def create_default_config(repo_path: Path):
     if config_path.exists():
         return
 
+    ext_list = extensions or [".py"]
+    ext_line = ", ".join(f'"{e}"' for e in ext_list)
+
+    excl_list = exclude_patterns or []
+    excl_line = ", ".join(f'"{e}"' for e in excl_list) if excl_list else ""
+
     config_path.write_text(
-        """# ctxgraph-code configuration
+        f"""# ctxgraph-code configuration
 
 [graph]
-# Additional exclude patterns (gitignore is used automatically)
-exclude = []
+# File extensions to scan
+extensions = [{ext_line}]
+# Exclude patterns (gitignore patterns are excluded automatically)
+exclude = [{excl_line}]
 # Follow symlinks when scanning files
 follow_symlinks = false
 # Skip files larger than this many MB

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.1}/src/ctxgraph_code/graph/builder.py

@@ -16,6 +16,7 @@ def build_graph(
     repo_path: str | Path,
     db_path: Optional[str | Path] = None,
     exclude_patterns: Optional[list[str]] = None,
+    extensions: Optional[list[str]] = None,
 ) -> dict:
     repo_path = Path(repo_path).resolve()
     if db_path is None:
@@ -29,8 +30,9 @@ def build_graph(
     combined = Graph()
     stats = {"files_analyzed": 0, "files_skipped": 0, "errors": 0}
 
-    python_files = list(repo_path.rglob("*.py"))
-    for file_path in python_files:
+    exts = set(extensions or [".py"])
+    scan_files = [f for f in repo_path.rglob("*") if f.suffix in exts and f.is_file()]
+    for file_path in scan_files:
         if should_exclude(file_path, repo_path, exclude_patterns):
             stats["files_skipped"] += 1
             continue

{ctxgraph_code-0.1.0 → ctxgraph_code-0.1.1}/src/ctxgraph_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.1.0
+Version: 0.1.1
 Summary: Code knowledge graph for Claude Code. Build a relationship graph of your Python codebase and query it during coding sessions.
 Author: ctxgraph-code contributors
 License: MIT
@@ -70,11 +70,21 @@ ctxgraph-code setup
 ctxgraph-code setup
 ```
 
+Interactive walkthrough — prompts for:
+- **File extensions** to scan (`.py`, `.js`, `.ts`, etc.)
+- **Exclude patterns** (folders like `tests/`, globs like `*.generated.py`)
+
 Does everything in one step:
-1. Creates `.ctxgraph/config.toml` with defaults
-2. Builds the knowledge graph from all Python files
+1. Creates `.ctxgraph/config.toml` with your chosen extensions and excludes
+2. Builds the knowledge graph from all matching files
 3. Creates `.claude/commands/ctxgraph-code.md` with instructions for Claude Code
 
+Non-interactive mode (skip prompts):
+```bash
+ctxgraph-code setup --extensions .py,.js,.ts --exclude tests/,examples/
+ctxgraph-code setup -y                                 # all defaults
+```
+
 ### `init`
 
 ```bash
@@ -87,10 +97,12 @@ Creates the `.ctxgraph/` directory with a default `config.toml`.
 
 ```bash
 ctxgraph-code build
-ctxgraph-code build --exclude "tests/" --exclude "*.generated.py"
+ctxgraph-code build --extensions .py,.js,.ts
+ctxgraph-code build --exclude tests/ --exclude *.generated.py
 ```
 
-Scans all `*.py` files in the project, runs AST analysis:
+Scans all matching files in the project, runs AST analysis. Extensions are read from config (`.py` by default, or whatever was set in `setup`).
+
 - **Imports**: which files import other files
 - **Class definitions**: class names, base classes, methods
 - **Function definitions**: function names, arguments
@@ -99,6 +111,8 @@ Scans all `*.py` files in the project, runs AST analysis:
 
 Stores the result in `.ctxgraph/graph.db`.
 
+> The graph is a **static snapshot**. If code changes, run `ctxgraph-code build` again to refresh. Claude Code will also rebuild when it detects the graph is stale.
+
 ### `query`
 
 ```bash
@@ -234,11 +248,13 @@ Claude then uses these commands as needed during the conversation.
 
 ## Configuration
 
-Configure via `.ctxgraph/config.toml` (created by `init` or `setup`):
+Configure via `.ctxgraph/config.toml` (created interactively by `setup` or manually):
 
 ```toml
 [graph]
-# Additional exclude patterns beyond defaults
+# File extensions to scan
+extensions = [".py", ".js", ".ts"]
+# Exclude patterns beyond built-in defaults
 exclude = ["tests/", "examples/"]
 # Follow symlinks when scanning
 follow_symlinks = false
@@ -246,7 +262,7 @@ follow_symlinks = false
 max_file_size_mb = 5
 ```
 
-Default exclusion patterns: `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
+Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.git`, `node_modules`, `venv`, `.venv`, `dist`, `build`, `*.egg-info`, `.pytest_cache`, `.mypy_cache`, `.ruff_cache`, `.tox`, `migrations`, `*.min.js`, `*.min.css`.
 
 ---
 

ctxgraph_code-0.1.0/src/ctxgraph_code/config/init.py

@@ -1,14 +0,0 @@
-from __future__ import annotations
-
-from pathlib import Path
-
-from ctxgraph_code.config.settings import create_default_config
-
-
-def init_project(repo_path: Path) -> Path:
-    cfg_dir = repo_path / ".ctxgraph"
-    cfg_dir.mkdir(parents=True, exist_ok=True)
-
-    create_default_config(repo_path)
-
-    return cfg_dir