buglab/README.md

BugLab - Maze Pathfinding & Optimization Project

C++ pathfinding and maze optimization project for buglab.ru.

Project Structure

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:

   make
   

2. Run optimizer in background with resource limit:

   ./run.sh ./build/optimizer
   

3. Clean build artifacts:

   make clean