aurora-lsp 0.1.0__tar.gz

aurora_lsp-0.1.0/.gitignore

@@ -0,0 +1,99 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+ENV/
+env/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.mypy_cache/
+.ruff_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Database
+*.db
+*.sqlite
+*.sqlite3
+
+# Logs
+*.log
+
+# Environment variables
+.env
+.env.local
+
+# PyPI credentials
+.pypirc
+
+# Claude Code specific
+.claude/
+
+# Session checkpoints (personal, not shared)
+.aurora/session.md
+
+# Friction analysis outputs (experimental, project-local)
+.aurora/friction/
+
+# Build artifacts
+*.whl
+*.tar.gz
+.coverage
+coverage.xml
+htmlcov/
+cli_full_test.txt
+openspec-source/
+
+# Temporary reports and profiling results
+*_report.json
+*_report.txt
+profiling_results.json
+bandit-report.json
+coverage.json
+baseline_failures.txt
+misclassified-files.txt
+saas_summary.json
+
+# Test artifacts that should use tmp directories
+MagicMock/
+test_plans/
+fixtures/
+/.aurora/

aurora_lsp-0.1.0/PKG-INFO

@@ -0,0 +1,195 @@
+Metadata-Version: 2.4
+Name: aurora-lsp
+Version: 0.1.0
+Summary: LSP integration for Aurora - code intelligence, dead code detection, and impact analysis
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: multilspy>=0.0.15
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Aurora LSP
+
+LSP integration for Aurora - code intelligence, dead code detection, and impact analysis.
+
+Built on [multilspy](https://github.com/microsoft/multilspy) (Microsoft) with custom layers for import filtering and code analysis.
+
+## Features
+
+- **Find Usages (excluding imports)** - Distinguish actual code usage from import statements
+- **Dead Code Detection** - Find functions/classes with 0 usages
+- **Linting** - Get errors, warnings, hints via LSP diagnostics
+- **Call Hierarchy** - Find callers of a function (where supported)
+
+## Supported Languages
+
+| Language | LSP Server | Import Filtering | Call Hierarchy |
+|----------|------------|------------------|----------------|
+| Python | Pyright | ✓ | Limited |
+| TypeScript | tsserver | ✓ | ✓ |
+| JavaScript | tsserver | ✓ | ✓ |
+| Rust | rust-analyzer | ✓ | ✓ |
+| Go | gopls | ✓ | ✓ |
+| Java | Eclipse JDT | ✓ | ✓ |
+| Ruby | Solargraph | ✓ | Limited |
+| C# | OmniSharp | ✓ | ✓ |
+| Dart | Dart Analysis | ✓ | ✓ |
+| Kotlin | kotlin-lsp | ✓ | Limited |
+
+## Installation
+
+```bash
+pip install aurora-lsp
+```
+
+## Usage
+
+### Basic Usage
+
+```python
+from aurora_lsp import AuroraLSP
+
+# Initialize with workspace path
+lsp = AuroraLSP("/path/to/project")
+
+# Find usages of a symbol (excluding imports)
+result = lsp.find_usages("src/main.py", line=10, col=5)
+print(f"Found {result['total_usages']} usages ({result['total_imports']} imports filtered)")
+
+# Get usage summary with impact assessment
+summary = lsp.get_usage_summary("src/main.py", line=10, col=5, symbol_name="MyClass")
+print(f"Impact: {summary['impact']} ({summary['files_affected']} files affected)")
+
+# Find dead code
+dead = lsp.find_dead_code()
+for item in dead:
+    print(f"Unused: {item['name']} ({item['kind']}) in {item['file']}:{item['line']}")
+
+# Lint a directory
+diags = lsp.lint("src/")
+print(f"{diags['total_errors']} errors, {diags['total_warnings']} warnings")
+
+# Find callers of a function
+callers = lsp.get_callers("src/utils.py", line=25, col=0)
+for caller in callers:
+    print(f"Called by: {caller['name']} in {caller['file']}")
+
+# Clean up
+lsp.close()
+```
+
+### Context Manager
+
+```python
+from aurora_lsp import AuroraLSP
+
+with AuroraLSP("/path/to/project") as lsp:
+    dead = lsp.find_dead_code()
+    print(f"Found {len(dead)} dead code items")
+# Server connections closed automatically
+```
+
+### Convenience Functions
+
+```python
+from aurora_lsp import find_usages, find_dead_code, lint
+
+# One-off operations (creates temporary LSP instance)
+result = find_usages("src/main.py", line=10, col=5)
+dead = find_dead_code("src/")
+diags = lint("src/")
+```
+
+## API Reference
+
+### AuroraLSP
+
+Main facade class providing synchronous API.
+
+#### `find_usages(file_path, line, col, include_imports=False) -> dict`
+
+Find usages of a symbol.
+
+**Returns:**
+- `usages`: List of usage locations with context
+- `imports`: List of import locations
+- `total_usages`: Count of actual usages
+- `total_imports`: Count of import statements
+
+#### `get_usage_summary(file_path, line, col, symbol_name=None) -> dict`
+
+Get comprehensive usage summary.
+
+**Returns:**
+- `symbol`: Symbol name
+- `total_usages`: Usage count
+- `total_imports`: Import count
+- `impact`: 'low' (<3), 'medium' (3-10), 'high' (>10)
+- `files_affected`: Number of files with usages
+- `usages_by_file`: Usages grouped by file
+
+#### `find_dead_code(path=None, include_private=False) -> list[dict]`
+
+Find functions/classes with 0 usages.
+
+**Returns:** List of items with:
+- `file`: File path
+- `line`: Line number
+- `name`: Symbol name
+- `kind`: 'function', 'class', or 'method'
+- `imports`: Number of times imported but never used
+
+#### `lint(path=None, severity_filter=None) -> dict`
+
+Get linting diagnostics.
+
+**Returns:**
+- `errors`: List of errors
+- `warnings`: List of warnings
+- `hints`: List of hints
+- `total_errors`, `total_warnings`, `total_hints`: Counts
+
+#### `get_callers(file_path, line, col) -> list[dict]`
+
+Find functions that call this symbol.
+
+**Returns:** List of items with:
+- `file`: File path
+- `line`: Line number
+- `name`: Function name
+
+## Architecture
+
+```
+┌─────────────────────────────────────────┐
+│  AuroraLSP (facade.py)                  │  High-level sync API
+├─────────────────────────────────────────┤
+│  CodeAnalyzer (analysis.py)             │  Dead code, usage summary
+│  DiagnosticsFormatter (diagnostics.py)  │  Linting
+│  ImportFilter (filters.py)              │  Import vs usage
+├─────────────────────────────────────────┤
+│  AuroraLSPClient (client.py)            │  Async LSP operations
+├─────────────────────────────────────────┤
+│  multilspy (Microsoft)                  │  LSP server management
+└─────────────────────────────────────────┘
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/
+
+# Type checking
+mypy src/
+```
+
+## License
+
+MIT

aurora_lsp-0.1.0/POC_README.md

@@ -0,0 +1,85 @@
+# Aurora LSP MCP POC
+
+Proof-of-concept MCP server to test Claude invocation of Aurora LSP tools.
+
+## Quick Test (Local)
+
+```bash
+cd /home/hamr/PycharmProjects/aurora
+python packages/lsp/test_poc_mcp.py
+```
+
+## Test with Claude Code
+
+Add to `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "aurora-lsp-poc": {
+      "command": "python",
+      "args": ["/home/hamr/PycharmProjects/aurora/packages/lsp/poc_mcp_server.py"]
+    }
+  }
+}
+```
+
+Then restart Claude Code. Tools will appear as:
+- `mcp__aurora-lsp-poc__lsp`
+- `mcp__aurora-lsp-poc__mem_search`
+
+## Tools
+
+### `lsp` - Code Intelligence
+
+Use BEFORE modifying/deleting code to understand impact.
+
+| Action | Purpose | Required Params |
+|--------|---------|-----------------|
+| `check` | Quick pre-edit check | path, line |
+| `impact` | Full impact analysis | path, line |
+| `deadcode` | Find unused code | path |
+
+**Test prompts:**
+- "Check usage of line 42 in src/main.py before I delete it"
+- "Find dead code in packages/core/"
+- "Show impact of changing SQLiteStore"
+
+### `mem_search` - Search Code Memory
+
+Search indexed code and knowledge base with LSP enrichment.
+
+**Test prompts:**
+- "Search for SOAR orchestrator"
+- "Find code related to memory storage"
+
+**To get full content:** Claude uses `Read` tool with file + lines from search results.
+
+## What POC Returns
+
+All responses include `"_poc": true` - mock data:
+
+```json
+{
+  "action": "check",
+  "symbol": "symbol_at_line_42",
+  "used_by": 7,
+  "risk": "medium",
+  "_poc": true
+}
+```
+
+## Files
+
+```
+packages/lsp/
+├── poc_mcp_server.py   # MCP server (lsp, mem_search)
+├── test_poc_mcp.py     # Local test
+└── POC_README.md       # This file
+```
+
+## Next Steps
+
+Wire POC to real implementations:
+- `lsp` → `AuroraLSP` facade
+- `mem_search` → `memory_store.search()` + LSP enrichment

aurora_lsp-0.1.0/README.md

@@ -0,0 +1,182 @@
+# Aurora LSP
+
+LSP integration for Aurora - code intelligence, dead code detection, and impact analysis.
+
+Built on [multilspy](https://github.com/microsoft/multilspy) (Microsoft) with custom layers for import filtering and code analysis.
+
+## Features
+
+- **Find Usages (excluding imports)** - Distinguish actual code usage from import statements
+- **Dead Code Detection** - Find functions/classes with 0 usages
+- **Linting** - Get errors, warnings, hints via LSP diagnostics
+- **Call Hierarchy** - Find callers of a function (where supported)
+
+## Supported Languages
+
+| Language | LSP Server | Import Filtering | Call Hierarchy |
+|----------|------------|------------------|----------------|
+| Python | Pyright | ✓ | Limited |
+| TypeScript | tsserver | ✓ | ✓ |
+| JavaScript | tsserver | ✓ | ✓ |
+| Rust | rust-analyzer | ✓ | ✓ |
+| Go | gopls | ✓ | ✓ |
+| Java | Eclipse JDT | ✓ | ✓ |
+| Ruby | Solargraph | ✓ | Limited |
+| C# | OmniSharp | ✓ | ✓ |
+| Dart | Dart Analysis | ✓ | ✓ |
+| Kotlin | kotlin-lsp | ✓ | Limited |
+
+## Installation
+
+```bash
+pip install aurora-lsp
+```
+
+## Usage
+
+### Basic Usage
+
+```python
+from aurora_lsp import AuroraLSP
+
+# Initialize with workspace path
+lsp = AuroraLSP("/path/to/project")
+
+# Find usages of a symbol (excluding imports)
+result = lsp.find_usages("src/main.py", line=10, col=5)
+print(f"Found {result['total_usages']} usages ({result['total_imports']} imports filtered)")
+
+# Get usage summary with impact assessment
+summary = lsp.get_usage_summary("src/main.py", line=10, col=5, symbol_name="MyClass")
+print(f"Impact: {summary['impact']} ({summary['files_affected']} files affected)")
+
+# Find dead code
+dead = lsp.find_dead_code()
+for item in dead:
+    print(f"Unused: {item['name']} ({item['kind']}) in {item['file']}:{item['line']}")
+
+# Lint a directory
+diags = lsp.lint("src/")
+print(f"{diags['total_errors']} errors, {diags['total_warnings']} warnings")
+
+# Find callers of a function
+callers = lsp.get_callers("src/utils.py", line=25, col=0)
+for caller in callers:
+    print(f"Called by: {caller['name']} in {caller['file']}")
+
+# Clean up
+lsp.close()
+```
+
+### Context Manager
+
+```python
+from aurora_lsp import AuroraLSP
+
+with AuroraLSP("/path/to/project") as lsp:
+    dead = lsp.find_dead_code()
+    print(f"Found {len(dead)} dead code items")
+# Server connections closed automatically
+```
+
+### Convenience Functions
+
+```python
+from aurora_lsp import find_usages, find_dead_code, lint
+
+# One-off operations (creates temporary LSP instance)
+result = find_usages("src/main.py", line=10, col=5)
+dead = find_dead_code("src/")
+diags = lint("src/")
+```
+
+## API Reference
+
+### AuroraLSP
+
+Main facade class providing synchronous API.
+
+#### `find_usages(file_path, line, col, include_imports=False) -> dict`
+
+Find usages of a symbol.
+
+**Returns:**
+- `usages`: List of usage locations with context
+- `imports`: List of import locations
+- `total_usages`: Count of actual usages
+- `total_imports`: Count of import statements
+
+#### `get_usage_summary(file_path, line, col, symbol_name=None) -> dict`
+
+Get comprehensive usage summary.
+
+**Returns:**
+- `symbol`: Symbol name
+- `total_usages`: Usage count
+- `total_imports`: Import count
+- `impact`: 'low' (<3), 'medium' (3-10), 'high' (>10)
+- `files_affected`: Number of files with usages
+- `usages_by_file`: Usages grouped by file
+
+#### `find_dead_code(path=None, include_private=False) -> list[dict]`
+
+Find functions/classes with 0 usages.
+
+**Returns:** List of items with:
+- `file`: File path
+- `line`: Line number
+- `name`: Symbol name
+- `kind`: 'function', 'class', or 'method'
+- `imports`: Number of times imported but never used
+
+#### `lint(path=None, severity_filter=None) -> dict`
+
+Get linting diagnostics.
+
+**Returns:**
+- `errors`: List of errors
+- `warnings`: List of warnings
+- `hints`: List of hints
+- `total_errors`, `total_warnings`, `total_hints`: Counts
+
+#### `get_callers(file_path, line, col) -> list[dict]`
+
+Find functions that call this symbol.
+
+**Returns:** List of items with:
+- `file`: File path
+- `line`: Line number
+- `name`: Function name
+
+## Architecture
+
+```
+┌─────────────────────────────────────────┐
+│  AuroraLSP (facade.py)                  │  High-level sync API
+├─────────────────────────────────────────┤
+│  CodeAnalyzer (analysis.py)             │  Dead code, usage summary
+│  DiagnosticsFormatter (diagnostics.py)  │  Linting
+│  ImportFilter (filters.py)              │  Import vs usage
+├─────────────────────────────────────────┤
+│  AuroraLSPClient (client.py)            │  Async LSP operations
+├─────────────────────────────────────────┤
+│  multilspy (Microsoft)                  │  LSP server management
+└─────────────────────────────────────────┘
+```
+
+## Development
+
+```bash
+# Install dev dependencies
+pip install -e ".[dev]"
+
+# Run tests
+pytest tests/
+
+# Type checking
+mypy src/
+```
+
+## License
+
+MIT