chore: migrate from Makefile to justfile

Replace Makefile with justfile for better command runner experience.
Add just to Nix devShell for development environment.

Author: ryoppippi

flake.nix

@@ -67,6 +67,7 @@
           devShells.default = pkgs.mkShell {
             buildInputs = with pkgs; [
               uv
+              just
               nixfmt-rfc-style
             ];
 

Makefile justfileMakefile renamed to justfile

@@ -1,32 +1,42 @@
+# Install dependencies and pre-commit hooks
 install:
 	uv sync --all-extras
 
+# Run ruff linting
 lint:
 	uv run ruff check .
 
+# Auto-fix linting issues
 lint-fix:
 	uv run ruff check --fix .
 
+# Run all tests
 test:
 	uv run pytest
 
+# Run tool-specific tests
 test-tools:
 	uv run pytest tests
 
+# Run example tests
 test-examples:
 	uv run pytest examples
 
+# Run type checking
 mypy:
 	uv run mypy stackone_ai
 
+# Build and serve docs locally
 docs-serve:
 	uv run scripts/build_docs.py
 	uv run mkdocs serve
 
+# Build docs for deployment
 docs-build:
 	uv run scripts/build_docs.py
 	uv run mkdocs build
 
+# Run MCP server inspector for debugging
 mcp-inspector:
 	uv sync --all-extras
 	npx @modelcontextprotocol/inspector stackmcp