Metadata-Version: 2.4
Name: atlas-strata
Version: 0.1.2
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** - Build dependency graphs automatically
- **Architecture Understanding** - Identify coupling, cycles, dead code, impact analysis
- **Health Scoring** - Rate architecture quality and surface issues
- **Dependency Visualization** - Interactive browser-based graphs
- **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
```

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

### Usage Examples

```bash
# Quick analysis
atlas analyze .

# Generate interactive graph
atlas visualize . --format html

# Check code health
atlas health .

# Find circular dependencies
atlas health cycles .

# Detect dead code
atlas health dead-code .

# Query dependency paths
atlas query --from auth.py --to main.py .

# Get JSON output
atlas analyze . --format json
```

## Commands

### Standalone CLI

```bash
# Analyze directory
atlas analyze <path> [--format json|text|mermaid]

# Generate health report
atlas report <path>
atlas health <path>

# Visualize dependency graph
atlas visualize <path> [--format html|json] [--output FILE]

# Query dependencies
atlas query --from <source> --to <target> <path>

# Show help
atlas --help
```



## Running Tests

```bash
# Run full test suite
pytest tests/

# Run specific tests
pytest tests/test_cli.py -v

# With coverage
pytest --cov=agent tests/
```

Expected: 159+ tests passing

## Architecture

Atlas uses a **pure Python architecture**:

- **Core Modules**: `agent/atlas/core/` - Analysis engines (Analyzer, QueryEngine, Visualizer, Formatters)
- **Existing Analysis Infrastructure**: Reuses all existing analyzers (BlastRadius, DeadCode, Cycles, Coupling, Health)
- **CLI Layer**: `agent/cli.py` - Command-line interface using Click
- **No Internal LLM**: All LLM reasoning handled by Copilot CLI

### No External Dependencies for LLM
- ✅ No GitHub Copilot SDK imports
- ✅ No direct API calls
- ✅ No hardcoded credentials
- ✅ Pure JSON output to stdout
- ✅ Copilot CLI manages all LLM authentication

## Documentation

See the docs/ and site/ directories for detailed documentation.

## Development

See CONTRIBUTING.md for contribution guidelines. Requires Python 3.12+.

## License

MIT License
