Makefile

# DedAI-Neurodynamics Makefile
# Common development commands

.PHONY: help install dev test lint train demo clean docs

# Default target
help:
	@echo "DedAI-Neurodynamics Development Commands"
	@echo "========================================="
	@echo ""
	@echo "Setup:"
	@echo "  make install     Install package in editable mode"
	@echo "  make dev         Install with development dependencies"
	@echo ""
	@echo "Testing:"
	@echo "  make test        Run all unit tests"
	@echo "  make test-cov    Run tests with coverage report"
	@echo "  make lint        Check code style (ruff)"
	@echo ""
	@echo "Running:"
	@echo "  make demo        Run inference on sample audio"
	@echo "  make train       Retrain TCN model (requires GPU)"
	@echo "  make jupyter     Start Jupyter notebook server"
	@echo ""
	@echo "Maintenance:"
	@echo "  make clean       Remove generated files"
	@echo "  make clean-all   Remove all generated files and caches"
	@echo ""

# Installation
install:
	pip install -e .

dev:
	pip install -e ".[dev]"

all:
	pip install -e ".[all]"

# Testing
test:
	pytest tests/ -v

test-cov:
	pytest tests/ -v --cov=src/pynrt --cov-report=html
	@echo "Coverage report: htmlcov/index.html"

# Linting
lint:
	ruff check src/ ml_utils/ tests/
	ruff format --check src/ ml_utils/ tests/

format:
	ruff format src/ ml_utils/ tests/

# Type checking
typecheck:
	mypy src/pynrt --ignore-missing-imports

# Running
demo:
	@echo "Running groove extraction demo..."
	@if [ -f "outputs/sessions/20251230_212609/audio/neural_duet.wav" ]; then \
		python ml_utils/run_inference_complete.py \
			outputs/sessions/20251230_212609/audio/neural_duet.wav \
			-m models/ml_v3_20260102_162052_best_model.pt \
			-o outputs/demo/; \
	else \
		echo "Sample audio not found. Please provide an audio file:"; \
		echo "  python ml_utils/run_inference_complete.py your_audio.wav -m models/ml_v3_*_best_model.pt -o outputs/"; \
	fi

train:
	@echo "Training TCN surrogate model..."
	@echo "This requires GPU and takes ~45 minutes."
	@echo "Run the dedAI_ML_Component.ipynb notebook for interactive training."
	jupyter nbconvert --to notebook --execute dedAI_ML_Component.ipynb --output dedAI_ML_Component_executed.ipynb

jupyter:
	jupyter notebook

# Cleaning
clean:
	rm -rf outputs/demo/
	rm -rf __pycache__/
	rm -rf src/__pycache__/
	rm -rf src/pynrt/__pycache__/
	rm -rf .pytest_cache/
	rm -rf *.egg-info/
	find . -name "*.pyc" -delete
	find . -name ".DS_Store" -delete

clean-all: clean
	rm -rf .venv/
	rm -rf htmlcov/
	rm -rf .coverage
	rm -rf .mypy_cache/
	rm -rf .ruff_cache/

# Documentation
docs:
	@echo "Documentation is in docs/ folder"
	@echo "  - README.md: Main documentation"
	@echo "  - docs/ARCHITECTURE.md: System design"
	@echo "  - docs/QUICKSTART.md: Getting started guide"

# Verification
verify:
	@echo "Verifying installation..."
	python -c "from pynrt import ASHLE, GrFNN, HopfOscillator; print('Core modules: OK')"
	python -c "from pynrt.audio.synthesis import NeuralSynthesizer; print('Audio synthesis: OK')"
	python -c "import torch; print(f'PyTorch: OK (CUDA: {torch.cuda.is_available()})')"
	@echo "All checks passed!"