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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.1.1
+Version: 0.1.2
 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
@@ -162,6 +162,17 @@ ctxgraph-code context "add pagination to the users endpoint"
 
 Generates a focused context summary: relevant files, their symbols, and dependency/call edges between them. This is the closest equivalent to `ctxgraph`'s capsule format.
 
+### `view`
+
+```bash
+ctxgraph-code view
+ctxgraph-code view --output tree.txt
+```
+
+Prints a hierarchical directory tree from the graph showing every file and its symbols (classes marked `[C]`, functions/methods marked `[M]`). Also lists import and call edges at the bottom.
+
+Useful for a quick visual scan of the project structure without reading every file.
+
 ### `info`
 
 ```bash
@@ -272,10 +283,10 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 8 (init, build, query, deps, usedby, overview, symbols, context, setup, info) |
+| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 9 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
-| Visualizer | D3.js HTML + SVG | No |
+| Visualizer | D3.js HTML + SVG | Text tree (`view` command) |
 | Skills system | Yes (customizable skill TOML files) | No |
 | MCP server | Yes | No |
 | Token savings | Yes (capsule DSL compression) | No |

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

@@ -139,6 +139,17 @@ ctxgraph-code context "add pagination to the users endpoint"
 
 Generates a focused context summary: relevant files, their symbols, and dependency/call edges between them. This is the closest equivalent to `ctxgraph`'s capsule format.
 
+### `view`
+
+```bash
+ctxgraph-code view
+ctxgraph-code view --output tree.txt
+```
+
+Prints a hierarchical directory tree from the graph showing every file and its symbols (classes marked `[C]`, functions/methods marked `[M]`). Also lists import and call edges at the bottom.
+
+Useful for a quick visual scan of the project structure without reading every file.
+
 ### `info`
 
 ```bash
@@ -249,10 +260,10 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 8 (init, build, query, deps, usedby, overview, symbols, context, setup, info) |
+| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 9 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
-| Visualizer | D3.js HTML + SVG | No |
+| Visualizer | D3.js HTML + SVG | Text tree (`view` command) |
 | Skills system | Yes (customizable skill TOML files) | No |
 | MCP server | Yes | No |
 | Token savings | Yes (capsule DSL compression) | No |

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ctxgraph-code"
-version = "0.1.1"
+version = "0.1.2"
 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.1 → ctxgraph_code-0.1.2}/src/ctxgraph_code/cli.py

@@ -17,6 +17,7 @@ from ctxgraph_code.render import (
     render_deps,
     render_overview,
     render_symbols,
+    render_treeview,
     render_usedby,
 )
 
@@ -350,6 +351,33 @@ def setup(
     console.print("Open Claude Code in this project and type [bold]/ctxgraph-code[/bold] to get started.")
 
 
+@app.command()
+def view(
+    repo_path: Optional[str] = typer.Option(
+        None, "--repo", "-r", help="Repository path"
+    ),
+    output: Optional[str] = typer.Option(
+        None, "--output", "-o", help="Save tree to file"
+    ),
+):
+    """Visualize the graph as a directory tree with symbols and edges."""
+    path = Path(repo_path).resolve() if repo_path else Path.cwd()
+
+    storage = get_storage(path)
+    if storage is None:
+        console.print("[red]No graph found. Run [bold]ctxgraph-code build[/bold] first.[/red]")
+        raise typer.Exit(1)
+
+    tree = render_treeview(storage)
+
+    if output:
+        out_path = Path(output)
+        out_path.write_text(tree, encoding="utf-8")
+        console.print(f"Saved tree to [bold]{out_path}[/bold]")
+    else:
+        console.print(tree)
+
+
 @app.command()
 def info(
     repo_path: Optional[str] = typer.Option(
@@ -395,7 +423,7 @@ def version():
     try:
         ver = _v("ctxgraph-code")
     except Exception:
-        ver = "0.1.0"
+        ver = "0.1.2"
     console.print(f"ctxgraph-code version [bold]{ver}[/bold]")
 
 

{ctxgraph_code-0.1.1 → ctxgraph_code-0.1.2}/src/ctxgraph_code/render.py

@@ -235,6 +235,107 @@ def render_context(storage: Storage, query: str, max_nodes: int = 15) -> str:
     return "\n".join(lines)
 
 
+def render_treeview(storage: Storage) -> str:
+    all_nodes = storage.get_all_nodes()
+    all_edges = storage.get_all_edges()
+
+    file_nodes = sorted([n for n in all_nodes if n.type == "file"], key=lambda n: n.path or "")
+    symbol_map: dict[str, list[Node]] = {}
+    for n in all_nodes:
+        if n.type != "file":
+            symbol_map.setdefault(n.parent_id or "", []).append(n)
+
+    dir_tree: dict[str, dict] = {}
+    for node in file_nodes:
+        parts = (node.path or node.name).split("/")
+        for i in range(len(parts)):
+            parent = "/".join(parts[:i]) if i > 0 else "."
+            child = parts[i]
+            if parent not in dir_tree:
+                dir_tree[parent] = {"dirs": set(), "files": []}
+            if i == len(parts) - 1:
+                dir_tree[parent]["files"].append(node)
+            else:
+                dir_tree[parent]["dirs"].add(child)
+
+    stats = storage.stats()
+    bt = storage.get_metadata("build_time")
+    build_label = ""
+    if bt:
+        try:
+            from datetime import datetime
+            build_label = f" (built {datetime.fromtimestamp(float(bt)).strftime('%Y-%m-%d %H:%M')})"
+        except Exception:
+            pass
+
+    lines = [
+        f".ctxgraph/graph.db  ({stats['nodes']} nodes, {stats['edges']} edges){build_label}",
+        "",
+    ]
+
+    def _render_dir(parent: str, prefix: str = ""):
+        entry = dir_tree.get(parent, {"dirs": set(), "files": []})
+        items: list[tuple[str, object]] = []
+        for d in sorted(entry["dirs"]):
+            items.append(("dir", d))
+        for f in sorted(entry["files"], key=lambda x: x.path or x.name):
+            items.append(("file", f))
+
+        for idx, (kind, obj) in enumerate(items):
+            last = idx == len(items) - 1
+            connector = "\\-- " if last else "+-- "
+            ext = "    " if last else "|   "
+
+            if kind == "dir":
+                name = str(obj)
+                lines.append(f"{prefix}{connector}{name}/")
+                child = name if parent == "." else parent + "/" + name
+                _render_dir(child, prefix + ext)
+            else:
+                node = obj
+                basename = (node.path or node.name).split("/")[-1]
+                lines.append(f"{prefix}{connector}{basename}")
+                symbols = sorted(symbol_map.get(node.id, []), key=lambda s: s.lineno)
+                if symbols:
+                    sym_lines = []
+                    for s in symbols:
+                        tag = "C" if s.type == "class" else "M"
+                        summary = f" -- {s.summary}" if s.summary else ""
+                        sym_lines.append(f"    [{tag}] {s.name}{summary}")
+                    for sidx, sl in enumerate(sym_lines):
+                        slast = sidx == len(sym_lines) - 1
+                        sconn = "\\-- " if slast else "+-- "
+                        lines.append(f"{prefix}{ext}{sconn}{sl}")
+
+    _render_dir(".")
+    lines.append("")
+
+    import_edges = [(s, t) for e in all_edges for s, t, r in [(e.source_id, e.target_id, e.relation)] if r == "imports"]
+    call_edges = [(s, t) for e in all_edges for s, t, r in [(e.source_id, e.target_id, e.relation)] if r == "calls"]
+
+    if import_edges:
+        lines.append(f"Imports ({len(import_edges)}):")
+        node_map = {n.id: n for n in all_nodes}
+        for src, tgt in sorted(import_edges, key=lambda x: (x[0], x[1]))[:20]:
+            sn = _short_name(src, node_map) or src
+            tn = _short_name(tgt, node_map) or tgt
+            lines.append(f"  {sn}  ->  {tn}")
+        if len(import_edges) > 20:
+            lines.append(f"  ... and {len(import_edges) - 20} more")
+
+    if call_edges:
+        lines.append(f"\nCalls ({len(call_edges)}):")
+        node_map = {n.id: n for n in all_nodes}
+        for src, tgt in sorted(call_edges, key=lambda x: (x[0], x[1]))[:15]:
+            sn = _short_name(src, node_map) or src
+            tn = _short_name(tgt, node_map) or tgt
+            lines.append(f"  {sn}  ->  {tn}")
+        if len(call_edges) > 15:
+            lines.append(f"  ... and {len(call_edges) - 15} more")
+
+    return "\n".join(lines)
+
+
 def _short_name(node_id: str, node_map: dict[str, Node]) -> Optional[str]:
     if node_id in node_map:
         n = node_map[node_id]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxgraph-code
-Version: 0.1.1
+Version: 0.1.2
 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
@@ -162,6 +162,17 @@ ctxgraph-code context "add pagination to the users endpoint"
 
 Generates a focused context summary: relevant files, their symbols, and dependency/call edges between them. This is the closest equivalent to `ctxgraph`'s capsule format.
 
+### `view`
+
+```bash
+ctxgraph-code view
+ctxgraph-code view --output tree.txt
+```
+
+Prints a hierarchical directory tree from the graph showing every file and its symbols (classes marked `[C]`, functions/methods marked `[M]`). Also lists import and call edges at the bottom.
+
+Useful for a quick visual scan of the project structure without reading every file.
+
 ### `info`
 
 ```bash
@@ -272,10 +283,10 @@ Built-in default exclusion patterns (always applied): `__pycache__`, `*.pyc`, `.
 
 | Feature | ctxgraph | ctxgraph-code |
 |---------|----------|---------------|
-| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 8 (init, build, query, deps, usedby, overview, symbols, context, setup, info) |
+| CLI commands | 9 (build, capsule, query, view, serve, info, init, ask, chat, history, skill) | 9 (init, build, query, deps, usedby, overview, symbols, context, setup, view, info) |
 | LLM integration | Built-in (Ollama, Claude, OpenAI, Azure) | None (delegates to Claude Code) |
 | Chat sessions | Yes | No |
-| Visualizer | D3.js HTML + SVG | No |
+| Visualizer | D3.js HTML + SVG | Text tree (`view` command) |
 | Skills system | Yes (customizable skill TOML files) | No |
 | MCP server | Yes | No |
 | Token savings | Yes (capsule DSL compression) | No |