adam-java-analytics/README.md

Java code analyzer for detecting package dependencies and circular references

# Adam Evaluation - Java Code Analyzer

A tool for analyzing Java projects to visualize package dependencies and detect circular dependencies.

## Features

- Visualize Java package structure as an interactive graph
- Navigate through package hierarchy with breadcrumbs
- Detect and highlight circular dependencies
- Configure dependency direction display
- Analyze any Java project with a simple command

## Installation

\`\`\`bash
# Install globally
npm install -g adam-evaluation

# Or use directly with npx
npx adam-evaluation
\`\`\`

## Usage

Navigate to the root of your Java project and run:

\`\`\`bash
npx adam-evaluation
\`\`\`

This will:
1. Analyze your Java project structure
2. Start a Next.js server on port 3333
3. Open a browser with the visualization

## Configuration

In the web interface, you can configure:
- Dependency direction (incoming, outgoing, or both)
- Whether to highlight circular dependencies
- The project path (automatically set when using the CLI)

## Development

\`\`\`bash
# Clone the repository
git clone https://github.com/yourusername/adam-evaluation.git

# Install dependencies
cd adam-evaluation
npm install

# Start development server
npm run dev
\`\`\`

## Requirements

- Node.js 16.0.0 or higher

## License

MIT