MCP Agile Flow

# MCP Agile Flow - Makefile # ------------------------- .PHONY: help venv install test test-coverage coverage test-kg test-core test-nl-commands test-full test-agent test-via-agent run-server setup-cursor clean clean-all clean-archived quality format lint type-check fix-lint setup-quality all # Configuration # ------------- VENV_DIR := .venv VENV_ACTIVATE := $(VENV_DIR)/bin/activate UV := uv PACKAGE_NAME := mcp_agile_flow SOURCE_DIR := src TESTS_DIR := tests PYTEST_FLAGS := -v TEST_PATH ?= $(TESTS_DIR) TEST_MARKERS ?= --ignore=tests/full-stack-fastapi-sample-project --ignore=tests/test_mcp_via_agno_agent.py # Help target # ----------- help: @echo "MCP Agile Flow - Make Targets" @echo "---------------------------" @echo "help: Show this help message" @echo "venv: Create virtual environment" @echo "install: Install package" @echo "test: Run tests with detailed debug output (excludes agent tests)" @echo " Use TEST_PATH=path/to/test to run specific tests" @echo " Use TEST_MARKERS=\"\" to clear default markers" @echo "test-coverage: Run tests with coverage report (basic)" @echo "coverage: Run tests with detailed coverage reports and badge generation" @echo "test-core: Run only the core tests (migration and integration)" @echo "test-nl-commands: Run only the natural language command detection tests" @echo "test-agent: Run only the agent tests (test_mcp_via_agno_agent.py)" @echo "test-via-agent: Run only the tests that use an AI agent for testing" @echo "test-full: Run all tests with full dependencies" @echo "test-kg: Run only the knowledge graph creation test" @echo "run-server: Run the MCP Agile Flow server" @echo "setup-cursor: Set up Cursor MCP integration" @echo "setup-quality: Set up quality tools (formatting, linting, type checking)" @echo "clean: Remove build artifacts and cache files" @echo "clean-all: Remove build artifacts, cache files, and virtual environment" @echo "clean-archived: Remove archived files (creates backup first)" @echo "quality: Run all code quality checks (formatting, linting, type checking)" @echo "dead-code: Run dead code analysis and generate reports" @echo "format: Run code formatting with Black" @echo "lint: Run code linting with Ruff and Flake8" @echo "type-check: Run type checking with MyPy" @echo "fix-lint: Automatically fix linting issues with Ruff" @echo "all: Install and run tests" # Virtual environment # ------------------ venv: $(UV) venv $(VENV_DIR) --python=$(shell which python3) # Installation # ------------ install: venv $(UV) pip install -e . # Testing # ------- test: venv @echo "Installing test dependencies..." $(UV) pip install -e ".[test]" @echo "Running tests with debug output..." $(UV) run pytest $(PYTEST_FLAGS) -s --show-capture=all --tb=short $(TEST_MARKERS) $(TEST_PATH) test-coverage: venv @echo "Installing test dependencies..." $(UV) pip install -e ".[test]" @echo "Running tests with coverage..." $(UV) run pytest $(PYTEST_FLAGS) --cov=$(PACKAGE_NAME) --cov-report=term --cov-report=html $(TEST_MARKERS) $(TESTS_DIR) coverage: venv @echo "Installing test and development dependencies..." $(UV) pip install -e ".[dev]" @echo "Running tests with detailed coverage report..." . $(VENV_ACTIVATE) && UV_LINK_MODE=copy coverage run -m pytest $(TEST_MARKERS) $(TESTS_DIR) . $(VENV_ACTIVATE) && coverage report -m . $(VENV_ACTIVATE) && coverage html . $(VENV_ACTIVATE) && coverage xml . $(VENV_ACTIVATE) && coverage-badge -o coverage.svg -f @echo "Coverage report generated at htmlcov/index.html" @echo "Coverage badge generated at coverage.svg" test-kg: venv @echo "Installing test dependencies..." $(UV) pip install -e ".[test]" @echo "Running knowledge graph test..." $(UV) run python -c "from tests.test_mcp_via_agno_agent import test_fastapi_project_knowledge_graph; test_fastapi_project_knowledge_graph()" # test-agent is an alias for test-via-agent for backward compatibility test-agent: test-via-agent test-via-agent: venv @echo "Installing test and agent-specific dependencies..." $(UV) pip install -e ".[test]" $(UV) pip install agno rich openai @echo "Running tests via AI agent..." $(UV) run pytest $(PYTEST_FLAGS) -s --show-capture=all --tb=short tests/test_mcp_via_agno_agent.py test-core: venv @echo "Installing test dependencies..." $(UV) pip install -e ".[test]" @echo "Running core tests only (migration and integration)..." $(UV) run pytest $(PYTEST_FLAGS) -s --show-capture=all --tb=short tests/test_integration.py::test_get_project_settings tests/test_project_configuration.py::test_get_project_settings_tool tests/test_integration.py::test_get_project_settings_with_path test-nl-commands: venv @echo "Installing test dependencies..." $(UV) pip install -e ".[test]" @echo "Running natural language command detection tests..." $(UV) run pytest $(PYTEST_FLAGS) -s --show-capture=all --tb=short tests/test_nl_commands.py test-full: venv @echo "Installing full development dependencies..." $(UV) pip install -e ".[dev]" @echo "Installing additional dependencies for FastAPI tests..." $(UV) pip install fastapi sqlmodel httpx email-validator pydantic[email] @echo "Installing agent dependencies..." $(UV) pip install agno rich openai @echo "Running all tests with debug output..." $(UV) run pytest -v -s --show-capture=all --tb=short --ignore=tests/full-stack-fastapi-sample-project tests # Server execution # --------------- run-server: install $(UV) run -m mcp_agile_flow.server # Setup # ----- setup-cursor: install $(UV) run setup_cursor_mcp.py setup-quality: venv @echo "Installing quality tools..." $(UV) pip install -e ".[test]" $(UV) pip install black==24.3.0 flake8==7.0.0 mypy==1.9.0 ruff==0.3.0 @echo "Creating .mypy.ini file if it doesn't exist..." @if [ ! -f .mypy.ini ]; then \ echo "[mypy]\npython_version = 3.10\nwarn_return_any = true\nwarn_unused_configs = true\ndisallow_untyped_defs = false\ndisallow_incomplete_defs = false\nignore_missing_imports = true\n" > .mypy.ini; \ fi @echo "Setup complete. You can now run 'make quality' to check code quality." # Cleaning # -------- clean: rm -rf build/ rm -rf dist/ rm -rf *.egg-info rm -rf **/__pycache__/ rm -rf **/.pytest_cache/ rm -rf .coverage rm -rf htmlcov/ rm -rf .mypy_cache/ rm -rf .ruff_cache/ rm -rf dead_code_report* # Remove everything including the virtual environment clean-all: clean rm -rf $(VENV_DIR) # Remove archived files (with backup) clean-archived: @echo "Running cleanup script for archived files..." chmod +x scripts/cleanup_archives.sh && ./scripts/cleanup_archives.sh # Code quality # ------------ # Dead code analysis dead-code: venv @echo "Installing dead code analyzer dependencies..." $(UV) pip install vulture>=2.14 @echo "Running dead code analysis with Vulture..." $(UV) run python scripts/quality/analyze_dead_code.py --src $(SOURCE_DIR) --output reports/dead_code_report --html --json @echo "Dead code reports generated in reports/ directory" # Combined quality command that runs all checks in one go quality: venv @echo "Installing development dependencies..." $(UV) pip install -e ".[test]" @echo "Installing quality tools explicitly..." $(UV) pip install black==24.3.0 flake8==7.0.0 mypy==1.9.0 ruff==0.3.0 vulture>=2.14 @echo "Running code formatting with Black..." $(UV) run black $(SOURCE_DIR) $(TESTS_DIR) @echo "Running code linting with Ruff..." $(UV) run ruff check $(SOURCE_DIR) $(TESTS_DIR) @echo "Running code linting with Flake8..." $(UV) run flake8 $(SOURCE_DIR) @echo "Running type checking with MyPy..." $(UV) run mypy $(SOURCE_DIR) @echo "Running dead code analysis with Vulture..." mkdir -p reports $(UV) run python scripts/quality/analyze_dead_code.py --src $(SOURCE_DIR) --output reports/dead_code_report --html --json # Default target # -------------- all: install test