feat/replace --overview (list of files) with --outline (symbols

  1. repomap_class.py: Replaced generate_overview_only with generate_outline
    - Extracts symbols via tree-sitter
    - Lists definitions (classes/functions) with line numbers
    - Skips PageRank (faster than full map)
  2. repomap.py: Renamed --overview to --outline with updated help text
  3. README.md: Updated the example

  Output format:
  src\repomapper\repomap_class.py
      FileReport (23)
      RepoMap (37)
      __init__ (40)
      load_tags_cache (80)
      ...

  src\repomapper\utils.py
      Tag (16)
      count_tokens (19)
      read_text (33)

  README.md:
  - Updated installation section from pip install -r requirements.txt to use uv sync and uv pip install -e .
  - The old requirements.txt didn't even exist; the project uses pyproject.toml

  src/repomapper/repomap.py:
  - Fixed --outline mode to include files from --chat-files (previously only --other-files and positional args were
  used)
  - Moved the "Chat files:" print to only execute in non-outline mode

  CLI args with --outline:
  - --chat-files and positional args/--other-files now all work correctly with --outline
  - Args like --mentioned-files, --mentioned-idents, --force-refresh, --exclude-unranked, --map-tokens,
  --max-context-window have no effect in outline mode (they're for PageRank which outline skips) but this is by design -
   outline is a simpler/faster mode

Updated readme to use `uv...`

Author: ssweber

README.md

@@ -41,7 +41,7 @@ I then used a combination of Aider w/Claude 3.7, Cline w/Gemini 2.5 Pro Preview
 ## Example Output
 
 ```
-> python repomap.py . --chat-files repomap_class.py
+> uv run repomapper . --chat-files repomap_class.py
 Chat files: ['/mnt/programming/RepoMapper/repomap_class.py']
 repomap_class.py:
 (Rank value: 10.8111)
@@ -94,7 +94,11 @@ importance.py:
 ## Installation
 
 ```bash
-pip install -r requirements.txt
+# Install with uv (recommended)
+uv sync
+
+# Or install as editable package
+uv pip install -e .
 ```
 
 ----------
@@ -105,37 +109,37 @@ pip install -r requirements.txt
 
 ```bash
 # Map current directory
-python repomap.py .
+uv run repomapper .
 
 # Map specific directory with custom token limit
-python repomap.py src/ --map-tokens 2048
+uv run repomapper src/ --map-tokens 2048
 
 # Map specific files
-python repomap.py file1.py file2.py
+uv run repomapper file1.py file2.py
 
 # Specify chat files (higher priority) vs other files
-python repomap.py --chat-files main.py --other-files src/
+uv run repomapper --chat-files main.py --other-files src/
 
 # Specify mentioned files and identifiers
-python repomap.py --mentioned-files config.py --mentioned-idents "main_function"
+uv run repomapper --mentioned-files config.py --mentioned-idents "main_function"
 
 # Enable verbose output
-python repomap.py . --verbose
+uv run repomapper . --verbose
 
 # Force refresh of caches
-python repomap.py . --force-refresh
+uv run repomapper . --force-refresh
 
 # Specify model for token counting
-python repomap.py . --model gpt-3.5-turbo
+uv run repomapper . --model gpt-3.5-turbo
 
 # Set maximum context window
-python repomap.py . --max-context-window 8192
+uv run repomapper . --max-context-window 8192
 
 # Exclude files with Page Rank 0
-python repomap.py . --exclude-unranked
+uv run repomapper . --exclude-unranked
 
-# Only list files in directory
-python repomap.py . --overview
+# Output code outline (classes/functions per file)
+uv run repomapper . --outline
 ```
 
 The tool prioritizes files in the following order:
@@ -148,22 +152,22 @@ The tool prioritizes files in the following order:
 
 ```bash
 # Enable verbose output
-python repomap.py . --verbose
+uv run repomapper . --verbose
 
 # Force refresh of caches
-python repomap.py . --force-refresh
+uv run repomapper . --force-refresh
 
 # Specify model for token counting
-python repomap.py . --model gpt-3.5-turbo
+uv run repomapper . --model gpt-3.5-turbo
 
 # Set maximum context window
-python repomap.py . --max-context-window 8192
+uv run repomapper . --max-context-window 8192
 
 # Exclude files with Page Rank 0
-python repomap.py . --exclude-unranked
+uv run repomapper . --exclude-unranked
 
 # Mention specific files or identifiers for higher priority
-python repomap.py . --mentioned-files config.py --mentioned-idents "main_function"
+uv run repomapper . --mentioned-files config.py --mentioned-idents "main_function"
 ```
 
 ----------
@@ -274,23 +278,26 @@ RepoMap can also be run as an MCP (Model Context Protocol) server, allowing othe
       "disabled": false,
       "timeout": 60,
       "type": "stdio",
-      "command": "/usr/bin/python3",
+      "command": "uv",
       "args": [
-        "/absolute/path/to/repomap_server.py"
+        "run",
+        "--directory",
+        "/absolute/path/to/RepoMapper",
+        "repomap-mcp"
       ]
     }
   }
 }
 ```
 
-- Replace `"/absolute/path/to/repomap_server.py"` with the actual path to your `repomap_server.py` file.
+- Replace `"/absolute/path/to/RepoMapper"` with the actual path to your RepoMapper installation directory.
 
 ### Usage
 
-1. Run the `repomap_server.py` script:
+1. Run the MCP server:
 
 ```bash
-python repomap_server.py
+uv run repomap-mcp
 ```
 
 2. The server will start and listen for requests via STDIO.

src/repomapper/repomap.py

@@ -113,9 +113,9 @@ def main():
     )
 
     parser.add_argument(
-        "--overview",
+        "--outline",
         action="store_true",
-        help="Output only the repository overview (file list with status)",
+        help="Output code outline (classes/functions per file, no ranking)",
     )
 
     args = parser.parse_args()
@@ -152,8 +152,6 @@ def token_counter(text: str) -> int:
     # other_files for RepoMap are the effective_other_files, resolved after expansion.
     other_files = [str(Path(f).resolve()) for f in effective_other_files_unresolved]
 
-    print(f"Chat files: {chat_files}")
-
     # Convert mentioned files to sets
     mentioned_fnames = set(args.mentioned_files) if args.mentioned_files else None
     mentioned_idents = set(args.mentioned_idents) if args.mentioned_idents else None
@@ -170,12 +168,16 @@ def token_counter(text: str) -> int:
         exclude_unranked=args.exclude_unranked,
     )
 
-    # Handle --overview mode (fast path, no code analysis)
-    if args.overview:
-        overview = repo_map.generate_overview_only(other_files)
-        tool_output(overview)
+    # Handle --outline mode (symbols only, no PageRank)
+    if args.outline:
+        # Combine chat_files and other_files for outline
+        all_files = list(set(chat_files + other_files))
+        outline = repo_map.generate_outline(all_files)
+        tool_output(outline)
         return
 
+    print(f"Chat files: {chat_files}")
+
     # Generate the map
     try:
         map_content, file_report = repo_map.get_repo_map(

src/repomapper/repomap_class.py

@@ -334,10 +334,15 @@ def normalize_path(path):
             if personalization:
                 ranks = nx.pagerank(G, personalization=personalization, alpha=0.85)
             else:
+                ranks = nx.pagerank(G, alpha=0.85)
+        except Exception as e:
+            print(f"Error during PageRank: {e}")
+            try:
+                # If personalization caused the crash, try standard PageRank
+                ranks = nx.pagerank(G, alpha=0.85)
+            except Exception:
+                # If both fail, fallback to uniform
                 ranks = {node: 1.0 for node in G.nodes()}
-        except Exception:
-            # Fallback to uniform ranking
-            ranks = {node: 1.0 for node in G.nodes()}
 
         # Update excluded dictionary with status information
         for fname in set(chat_fnames + other_fnames):
@@ -483,28 +488,39 @@ def get_ranked_tags_map(
         self.map_cache[cache_key] = result
         return result
 
-    def generate_overview_only(self, all_files: list[str]) -> str:
-        """Generate a fast file overview without any code analysis.
+    def generate_outline(self, all_files: list[str]) -> str:
+        """Generate a code outline showing all classes/functions per file.
 
-        This skips tree-sitter parsing, PageRank, etc. for maximum speed.
+        This extracts symbols via tree-sitter but skips PageRank ranking.
+        Faster than full repo map, provides structural overview.
         """
         if not all_files:
             return ""
 
-        overview_lines = ["=== REPOSITORY OVERVIEW ==="]
-        overview_lines.append(f"Total files: {len(all_files)}")
-        overview_lines.append("")
-
         # Sort files for consistent output
         sorted_files = sorted(all_files, key=lambda f: self.get_rel_fname(f))
 
+        outline_parts = []
+
         for fname in sorted_files:
             rel_fname = self.get_rel_fname(fname)
-            overview_lines.append(f"  {rel_fname}")
 
-        overview_lines.append("")
+            if not os.path.exists(fname):
+                continue
 
-        return "\n".join(overview_lines)
+            tags = self.get_tags(fname, rel_fname)
+
+            # Filter to definitions only and sort by line number
+            definitions = [(tag.name, tag.line) for tag in tags if tag.kind == "def"]
+            definitions.sort(key=lambda x: x[1])
+
+            if definitions:
+                file_lines = [rel_fname]
+                for name, line in definitions:
+                    file_lines.append(f"    {name} ({line})")
+                outline_parts.append("\n".join(file_lines))
+
+        return "\n\n".join(outline_parts)
 
     def generate_file_overview(
         self, all_files: list[str], files_in_map: set[str], file_report: FileReport
@@ -608,11 +624,13 @@ def try_tags(num_tags: int) -> tuple[str | None, int, set[str]]:
             else:
                 right = mid - 1
 
-        # Generate file overview if we have a tree
+        # Generate file overview if we have a tree (only when verbose)
         if best_tree:
-            all_files = list(set(chat_fnames + other_fnames))
-            overview = self.generate_file_overview(all_files, best_files, file_report)
-            best_tree = overview + "=== DETAILED CODE MAP ===\n\n" + best_tree
+            if self.verbose:
+                all_files = list(set(chat_fnames + other_fnames))
+                overview = self.generate_file_overview(all_files, best_files, file_report)
+                if overview:
+                    best_tree = best_tree + "\n\n" + overview
 
         return best_tree, file_report