# AlCheck

A parallel code quality checker for Elixir projects. AlCheck runs multiple code quality checks (format, compile, credo, dialyzer, and tests) concurrently with smart test partitioning.

## Features

- **Parallel Execution**: Runs all checks concurrently to maximize CPU utilization
- **Test Partitioning**: Splits test suite across multiple partitions for parallel execution
- **Smart Test Management**: Re-run only failed tests, monitor test progress in real-time
- **Auto-fix Support**: Apply credo fixes automatically from stored outputs
- **Real-time Progress**: Visual feedback with test counts and status updates
- **Flexible Filtering**: Run specific checks or use fast mode for quick feedback

## Installation

Add `al_check` to your list of dependencies in `mix.exs`:

```elixir
def deps do
  [
    {:al_check, "~> 0.1.0"}
  ]
end
```

Then run:

```bash
mix deps.get
mix escript.install
```

## Usage

### CLI Usage

Run all checks:

```bash
scripts/check
```

### Common Options

```bash
# Run only fast checks (format, compile, credo)
scripts/check --fast

# Run specific checks only
scripts/check --only format,test
scripts/check --only credo

# Run tests with custom partition count
scripts/check --partitions 4

# Run tests from specific directory
scripts/check --dir test/my_app/feature/

# Re-run only failed tests from previous run
scripts/check --failed

# Apply auto-fixes from stored credo output
scripts/check --fix

# Monitor test partition files in real-time
scripts/check --watch
```

### Available Checks

- **format** - `mix format --check-formatted`
- **compile** - `mix compile --warnings-as-errors`
- **compile_test** - `MIX_ENV=test mix compile --warnings-as-errors`
- **dialyzer** - `mix dialyzer`
- **credo** - `mix credo --all`
- **credo_strict** - `mix credo --strict --only readability --all`
- **test** - `mix test` (with parallel partitioning)

## Workflows

### Failed Test Workflow

When tests fail, failed test locations are automatically saved:

```bash
scripts/check --only test     # Run tests and save failures
cat check/failed_tests.txt    # View failed tests
scripts/check --failed        # Re-run only the failed tests
```

### Auto-fix Workflow

Credo output is stored for later use with `--fix`:

```bash
scripts/check --only credo    # Run checks and store output
scripts/check --fix           # Apply fixes from stored output
```

### Test Partitioning

Tests run in parallel partitions (default: 3). Each partition uses its own database.
Customize based on your CPU cores:

```bash
scripts/check --partitions 3  # Run with 3 partitions
```

## Output Files

AlCheck creates a `check/` directory with the following files:

- `check/credo.txt` - Credo output for auto-fix
- `check/credo_strict.txt` - Strict credo output for auto-fix
- `check/check_tests.txt` - Merged test output from all partitions
- `check/test_partition_N.txt` - Individual partition outputs
- `check/failed_tests.txt` - List of failed test locations

## Requirements

- Elixir ~> 1.18
- Mix build tool

## Documentation

Full documentation is available at [https://hexdocs.pm/al_check](https://hexdocs.pm/al_check).

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.