Metadata-Version: 2.4
Name: atlas-strata
Version: 0.1.5
Summary: Intelligent code analysis tool for understanding any codebase. Analyze dependencies, risks, and architecture instantly.
Author: Puneet Ghanshani
License: MIT
Project-URL: Homepage, https://github.com/punitganshani/atlas-strata
Project-URL: Documentation, https://punitganshani.github.io/atlas-strata/
Project-URL: Repository, https://github.com/punitganshani/atlas-strata.git
Project-URL: Issues, https://github.com/punitganshani/atlas-strata/issues
Project-URL: Changelog, https://github.com/punitganshani/atlas-strata/releases
Keywords: code-analysis,dependency-graph,codebase-understanding,architecture-analysis,code-intelligence,static-analysis,cli,github-copilot
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: networkx>=3.0
Requires-Dist: rich>=13.0
Requires-Dist: tree-sitter>=0.25
Requires-Dist: tree-sitter-python>=0.20
Requires-Dist: tree-sitter-typescript>=0.20
Requires-Dist: tree-sitter-java>=0.20
Requires-Dist: tree-sitter-go>=0.20
Requires-Dist: tree-sitter-c-sharp>=0.23.0
Requires-Dist: diskcache>=5.6
Requires-Dist: pydantic>=2.0
Requires-Dist: scikit-learn>=1.0
Requires-Dist: jinja2>=3.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=3.0; extra == "dev"
Requires-Dist: black>=22.0; extra == "dev"
Requires-Dist: flake8>=4.0; extra == "dev"
Requires-Dist: mypy>=0.950; extra == "dev"
Dynamic: license-file

# Atlas Strata - Code Architecture Analysis

A pure Python CLI for analyzing codebase architecture, dependencies, and code quality.

## Features

- **Intelligent Code Analysis** - Analyze dependencies, coupling, and architecture instantly
- **Interactive Visualization** - Browser-based dependency graphs with multiple layout algorithms
- **LLM-Powered Insights** - Ask questions about your codebase with AI reasoning (via Copilot CLI)
- **Codebase Comparison** - Compare two projects for architectural and structural differences
- **Multiple Languages** - Python, TypeScript, Java, Go, C#
- **JSON Export** - Integration with CI/CD and other tools
- **Cross-platform** - Windows, macOS, Linux

## Quick Start

### Installation

```bash
pip install atlas-strata
atlas --version
```

After installation, the `atlas` command will be available globally in your terminal.

### Using with GitHub Copilot CLI (Recommended)

To use `@atlas` in GitHub Copilot CLI:

```bash
# After pip install, enable the tool once
copilot --allow-tool atlas

# Now you can use @atlas in Copilot
@atlas ask "What does the auth module do?"
@atlas analyze ./src
```

Direct `atlas` command works immediately after `pip install` and does not require this permission step.

### Usage Examples

```bash
# Analyze codebase for dependencies and architecture
atlas analyze ./src

# Generate interactive dependency graph
atlas visualize ./src --format html

# Ask LLM about your codebase
atlas ask "What does the auth module do?" ./src

# Compare two codebases
atlas compare ./src ./backup/src

# Get JSON output for scripting
atlas analyze ./src --format json | jq

# Show detailed recommendations
atlas analyze ./src --with-recommendations
```

## Commands

### Quick Command Overview

| Command | Purpose | Setup Required |
|---------|---------|-----------------|
| `atlas analyze` | Analyze code dependencies and architecture | ✓ Works offline |
| `atlas visualize` | Generate interactive dependency graph | ✓ Works offline |
| `atlas ask` | Ask LLM about your codebase | ⚠ Requires Copilot CLI |
| `atlas compare` | Compare two codebases | ✓ Works offline |

### CLI Commands

**3 Commands Work Offline (No Setup Needed)**

```bash
# 1. ANALYZE - Analyze code dependencies and architecture
atlas analyze <path> [OPTIONS]
  --format json|text|mermaid    Output format (default: text)
  --with-recommendations        Show detailed refactoring insights
  --json-output PATH            Save analysis JSON to file

# 2. VISUALIZE - Generate interactive dependency graph
atlas visualize <path> [OPTIONS]
  --format html|json            Output format (default: html)
  --output DIR                  Output directory (default: ./atlas-output)

# 4. COMPARE - Compare two codebases
atlas compare <path1> <path2> [OPTIONS]
  --format json|text            Output format (default: text)
  --json-output PATH            Save comparison JSON to file
```

**LLM-Powered Command (Requires GitHub Copilot CLI)**

```bash
# 3. ASK - Ask LLM about your codebase (Requires: copilot --allow-tool atlas)
atlas ask [OPTIONS]
  "question" [path]             Query with optional path
  --interactive                 Interactive mode
  --format json|text|html       Output format
```

To use `ask`:
```bash
copilot --allow-tool atlas    # One-time setup
atlas ask "your question"     # Now works
```

# 4. COMPARE - Compare two codebases
atlas compare <path1> <path2> [OPTIONS]
  --format json|text            Output format (default: text)
  --json-output PATH            Save comparison JSON to file

# Show help and version
atlas --help
atlas --version
```

## License

MIT License
