# BugLab - Maze Pathfinding & Optimization Project

C++ pathfinding and maze optimization project for [buglab.ru](https://buglab.ru/).

## Project Structure

```text
buglab/
├── CMakeLists.txt        # CMake build configuration (C++23)
├── Makefile              # Build shortcuts (wraps CMake)
├── run.sh                # Background runner with cpulimit (160% CPU)
├── README.md             # Project documentation
├── src/
│   └── main.cpp          # Tabu Search optimizer engine
├── docs/
│   ├── ideas.md          # Short-term ideas and backlog
│   ├── observations.md   # Key heuristics and insights
│   ├── research.md       # General research and milestone notes
│   └── experiments/      # Detailed logs for specific experiments
└── storage/
    ├── labyrinths.db     # SQLite database for saved labyrinths & metadata
    └── schema.sql        # Database schema definition
```

## Build & Run

1. **Build the project:**
   ```bash
   make
   ```
2. **Run optimizer in background with resource limit:**
   ```bash
   ./run.sh ./build/optimizer
   ```
3. **Clean build artifacts:**
   ```bash
   make clean
   ```