todo-agent 0.1.0__tar.gz → 0.2.1__tar.gz

{todo_agent-0.1.0 → todo_agent-0.2.1}/.gitignore

@@ -236,6 +236,7 @@ $RECYCLE.BIN/
 # Project-specific patterns
 # Log files
 logs/*.log
+logs/
 *.log
 
 # Configuration files with sensitive data
@@ -273,3 +274,16 @@ settings_local.py
 ehthumbs.db
 Icon?
 Thumbs.db
+
+# Test and coverage files
+.coverage
+htmlcov/
+bandit-test-report.json
+
+# Build and distribution files
+dist/
+todo_agent.egg-info/
+
+# Cache directories
+.mypy_cache/
+.pytest_cache/

todo_agent-0.2.1/Makefile

@@ -0,0 +1,54 @@
+.PHONY: clean build check publish format lint test-lint all-lint install install-dev
+
+# ==============================================================================
+# Build and Publishing
+# ==============================================================================
+
+install: build
+	@echo "📦 Installing built package locally..."
+	pip install dist/*.whl
+
+install-dev:
+	@echo "🔧 Installing package in development mode with dev dependencies..."
+	pip install -e ".[dev]"
+
+clean:
+	@echo "🧹 Cleaning build artifacts..."
+	rm -rf dist/ build/ .eggs/ *.egg-info
+
+build: clean
+	@echo "🔨 Building package..."
+	python -m build
+
+check:
+	@echo "✅ Checking distribution files..."
+	twine check dist/*
+
+publish: clean build check
+	@echo "🚀 Publishing to PyPI..."
+	twine upload dist/* 
+
+# ==============================================================================
+# Linting and Code Quality
+# ==============================================================================
+
+format:
+	@echo "🎨 Formatting and linting code with Ruff..."
+	ruff check --fix todo_agent/ tests/
+	ruff format todo_agent/ tests/
+
+lint:
+	@echo "🔍 Running Ruff linting..."
+	ruff check todo_agent/ tests/
+	@echo "🔍 Running MyPy type checking..."
+	mypy todo_agent/
+	@echo "🔍 Running Bandit security checks..."
+	bandit -r todo_agent/ || true
+
+# ==============================================================================
+# Testing
+# ==============================================================================
+
+test:
+	@echo "🧪 Running tests with linting and coverage..."
+	pytest --cov=todo_agent --cov-report=term-missing --cov-report=html 

{todo_agent-0.1.0 → todo_agent-0.2.1}/PKG-INFO

@@ -1,22 +1,20 @@
 Metadata-Version: 2.4
 Name: todo-agent
-Version: 0.1.0
+Version: 0.2.1
 Summary: A natural language interface for todo.sh task management
 Author: codeprimate
 Maintainer: codeprimate
 License-Expression: GPL-3.0
-Project-URL: Homepage, https://github.com/codeprimate/todo_agent
-Project-URL: Documentation, https://github.com/codeprimate/todo_agent#readme
-Project-URL: Repository, https://github.com/codeprimate/todo_agent
-Project-URL: Bug Tracker, https://github.com/codeprimate/todo_agent/issues
+Project-URL: Homepage, https://github.com/codeprimate/todo-agent
+Project-URL: Documentation, https://github.com/codeprimate/todo-agent#readme
+Project-URL: Repository, https://github.com/codeprimate/todo-agent
+Project-URL: Bug Tracker, https://github.com/codeprimate/todo-agent/issues
 Keywords: todo,task-management,llm,natural-language,cli
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -26,28 +24,25 @@ Classifier: Topic :: Text Processing :: Linguistic
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests>=2.31.0
-Requires-Dist: typing-extensions>=4.8.0
-Requires-Dist: types-requests>=2.31.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: tiktoken>=0.5.0
+Requires-Dist: requests>=2.32.0
+Requires-Dist: typing-extensions>=4.15.0
+Requires-Dist: types-requests>=2.32.0
+Requires-Dist: rich>=14.0.0
+Requires-Dist: tiktoken>=0.11.0
 Provides-Extra: dev
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: flake8>=6.0.0; extra == "dev"
-Requires-Dist: isort>=5.12.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
-Requires-Dist: pre-commit>=3.0.0; extra == "dev"
-Requires-Dist: bandit>=1.7.0; extra == "dev"
-Requires-Dist: safety>=2.3.0; extra == "dev"
-Requires-Dist: sphinx>=6.0.0; extra == "dev"
-Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == "dev"
-Requires-Dist: radon>=5.1.0; extra == "dev"
-Requires-Dist: xenon>=0.7.0; extra == "dev"
-Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=4.0.0; extra == "dev"
-Requires-Dist: setuptools_scm[toml]>=6.2.0; extra == "dev"
+Requires-Dist: ruff>=0.12.0; extra == "dev"
+Requires-Dist: mypy>=1.17.0; extra == "dev"
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=6.0.0; extra == "dev"
+Requires-Dist: pre-commit>=4.0.0; extra == "dev"
+Requires-Dist: bandit>=1.8.0; extra == "dev"
+Requires-Dist: sphinx>=8.0.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=3.0.0; extra == "dev"
+Requires-Dist: radon>=6.0.0; extra == "dev"
+Requires-Dist: xenon>=0.9.0; extra == "dev"
+Requires-Dist: build>=1.2.0; extra == "dev"
+Requires-Dist: twine>=6.0.0; extra == "dev"
+Requires-Dist: setuptools_scm[toml]>=9.0.0; extra == "dev"
 Dynamic: license-file
 
 # Todo Agent
@@ -143,10 +138,15 @@ You can add this to your shell profile (`.bashrc`, `.zshrc`, etc.) to make it pe
 # Clone and install from source
 git clone https://github.com/codeprimate/todo-agent.git
 cd todo_agent
-pip install -e .
 
-# Or with development dependencies
-pip install -e ".[dev]"
+# Option 1: Install built package locally
+make install
+
+# Option 2: Install in development mode with dev dependencies
+make install-dev
+
+# Option 3: Install in development mode (basic)
+pip install -e .
 ```
 
 ### 2. Set up your LLM provider
@@ -226,14 +226,52 @@ The `TODO_FILE`, `DONE_FILE`, and `REPORT_FILE` are automatically inferred from
 # Clone and install
 git clone https://github.com/codeprimate/todo-agent.git
 cd todo_agent
-pip install -e ".[dev]"
 
-# Run tests
-pytest
+# Install options:
+# - Built package (like production install)
+make install
+# - Development mode with dev dependencies (recommended for development)
+make install-dev
+# - Basic development mode
+pip install -e .
+
+# Available Makefile tasks:
+make test      # Run tests with coverage
+make format    # Format and lint code
+make lint      # Run linting only
+make build     # Build package distribution
+make clean     # Clean build artifacts
+make install   # Build and install package locally
+make install-dev # Install in development mode with dev dependencies
+```
+
+## Code Quality and Linting
+
+This project uses comprehensive linting to maintain code quality:
+
+### Linting Tools
+- **Ruff**: Fast Python linter and formatter (replaces Black, isort, and Flake8)
+- **MyPy**: Static type checking
+- **Bandit**: Security vulnerability scanning
+
+**Note**: Ruff is configured to be compatible with Black's formatting style and provides 10-100x faster performance than traditional tools.
+
+### Pre-commit Hooks
+Install pre-commit hooks for automatic linting on commits:
+```bash
+pre-commit install
+```
+
+### Linting in Test Suite
+Linting checks are integrated into the test suite via `tests/test_linting.py`. The `make test` command runs all tests including linting checks. You can also run linting tests separately:
+```bash
+# Run linting tests only
+pytest -m lint
+```
 
-# Format code
-black .
-isort .
+### Configuration Files
+- `pyproject.toml`: Ruff, MyPy, and pytest configuration
+- `.pre-commit-config.yaml`: Pre-commit hooks configuration
 ```
 
 ## Architecture

{todo_agent-0.1.0 → todo_agent-0.2.1}/README.md

@@ -91,10 +91,15 @@ You can add this to your shell profile (`.bashrc`, `.zshrc`, etc.) to make it pe
 # Clone and install from source
 git clone https://github.com/codeprimate/todo-agent.git
 cd todo_agent
-pip install -e .
 
-# Or with development dependencies
-pip install -e ".[dev]"
+# Option 1: Install built package locally
+make install
+
+# Option 2: Install in development mode with dev dependencies
+make install-dev
+
+# Option 3: Install in development mode (basic)
+pip install -e .
 ```
 
 ### 2. Set up your LLM provider
@@ -174,14 +179,52 @@ The `TODO_FILE`, `DONE_FILE`, and `REPORT_FILE` are automatically inferred from
 # Clone and install
 git clone https://github.com/codeprimate/todo-agent.git
 cd todo_agent
-pip install -e ".[dev]"
 
-# Run tests
-pytest
+# Install options:
+# - Built package (like production install)
+make install
+# - Development mode with dev dependencies (recommended for development)
+make install-dev
+# - Basic development mode
+pip install -e .
+
+# Available Makefile tasks:
+make test      # Run tests with coverage
+make format    # Format and lint code
+make lint      # Run linting only
+make build     # Build package distribution
+make clean     # Clean build artifacts
+make install   # Build and install package locally
+make install-dev # Install in development mode with dev dependencies
+```
+
+## Code Quality and Linting
+
+This project uses comprehensive linting to maintain code quality:
+
+### Linting Tools
+- **Ruff**: Fast Python linter and formatter (replaces Black, isort, and Flake8)
+- **MyPy**: Static type checking
+- **Bandit**: Security vulnerability scanning
+
+**Note**: Ruff is configured to be compatible with Black's formatting style and provides 10-100x faster performance than traditional tools.
+
+### Pre-commit Hooks
+Install pre-commit hooks for automatic linting on commits:
+```bash
+pre-commit install
+```
+
+### Linting in Test Suite
+Linting checks are integrated into the test suite via `tests/test_linting.py`. The `make test` command runs all tests including linting checks. You can also run linting tests separately:
+```bash
+# Run linting tests only
+pytest -m lint
+```
 
-# Format code
-black .
-isort .
+### Configuration Files
+- `pyproject.toml`: Ruff, MyPy, and pytest configuration
+- `.pre-commit-config.yaml`: Pre-commit hooks configuration
 ```
 
 ## Architecture

{todo_agent-0.1.0 → todo_agent-0.2.1}/docs/publishing.md

@@ -13,9 +13,9 @@ After initial setup, each release follows the same simple workflow using the pro
 
 ## Release Checklist
 
-- [ ] All code changes merged and tests passing
+- [ ] Run code quality checks: `ruff check .`, `ruff format .`, `mypy .`
 - [ ] Run tests: `pytest`
-- [ ] Run code quality checks: `black .`, `isort .`, `mypy .`, `flake8`
+- [ ] All code changes merged and tests passing
 - [ ] Create and push git tag: `git tag vX.X.X && git push origin main && git push origin vX.X.X`
 - [ ] Build and publish: `make publish`
 - [ ] Verify package published at [https://pypi.org/project/todo-agent/](https://pypi.org/project/todo-agent/)
@@ -58,10 +58,9 @@ Ensure all code is ready for release:
 pytest
 
 # Run code quality checks
-black .
-isort .
+ruff check .
+ruff format .
 mypy .
-flake8
 
 # Check for security issues
 bandit -r todo_agent/
@@ -163,4 +162,4 @@ For subsequent releases after initial setup:
 
 - Check the [PyPI documentation](https://packaging.python.org/guides/distributing-packages-using-setuptools/)
 - Review the [setuptools_scm documentation](https://github.com/pypa/setuptools_scm)
-- Check the project's [GitHub repository](https://github.com/codeprimate/todo_agent) for issues
+- Check the project's [GitHub repository](https://github.com/codeprimate/todo-agent) for issues

todo_agent-0.2.1/pyproject.toml

@@ -0,0 +1,190 @@
+[build-system]
+requires = ["setuptools>=45", "wheel", "setuptools_scm[toml]>=6.2"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "todo-agent"
+dynamic = ["version"]
+description = "A natural language interface for todo.sh task management"
+readme = "README.md"
+license = "GPL-3.0"
+authors = [
+    {name = "codeprimate"}
+]
+maintainers = [
+    {name = "codeprimate"}
+]
+keywords = ["todo", "task-management", "llm", "natural-language", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business :: Scheduling",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing :: Linguistic",
+]
+requires-python = ">=3.8"
+dependencies = [
+    "requests>=2.32.0",
+    "typing-extensions>=4.15.0",
+    "types-requests>=2.32.0",
+    "rich>=14.0.0",
+    "tiktoken>=0.11.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "ruff>=0.12.0",
+    "mypy>=1.17.0",
+    "pytest>=8.0.0",
+    "pytest-cov>=6.0.0",
+    "pre-commit>=4.0.0",
+    "bandit>=1.8.0",
+    "sphinx>=8.0.0",
+    "sphinx-rtd-theme>=3.0.0",
+    "radon>=6.0.0",
+    "xenon>=0.9.0",
+    "build>=1.2.0",
+    "twine>=6.0.0",
+    "setuptools_scm[toml]>=9.0.0",
+]
+
+[project.scripts]
+todo-agent = "todo_agent.main:main"
+
+[project.urls]
+Homepage = "https://github.com/codeprimate/todo-agent"
+Documentation = "https://github.com/codeprimate/todo-agent#readme"
+Repository = "https://github.com/codeprimate/todo-agent"
+"Bug Tracker" = "https://github.com/codeprimate/todo-agent/issues"
+
+[tool.setuptools_scm]
+write_to = "todo_agent/_version.py"
+
+[tool.setuptools.packages.find]
+include = ["todo_agent*"]
+exclude = ["tests*", "docs*", "logs*", "htmlcov*", "dist*", "build*", "*.egg-info*"]
+
+
+
+[tool.ruff]
+# Same as Black.
+line-length = 88
+indent-width = 4
+
+# Assume Python 3.8
+target-version = "py38"
+
+# Exclude a variety of commonly ignored directories.
+exclude = [
+    ".bzr",
+    ".direnv",
+    ".eggs",
+    ".git",
+    ".git-rewrite",
+    ".hg",
+    ".mypy_cache",
+    ".nox",
+    ".pants.d",
+    ".pytype",
+    ".ruff_cache",
+    ".svn",
+    ".tox",
+    ".venv",
+    "__pypackages__",
+    "_build",
+    "buck-out",
+    "build",
+    "dist",
+    "node_modules",
+    "venv",
+]
+
+[tool.ruff.lint]
+# Enable pycodestyle (`E`), Pyflakes (`F`), and isort (`I`) codes
+select = ["E", "F", "I", "B", "C4", "UP", "ARG", "SIM", "TCH", "TID", "Q", "RUF"]
+ignore = [
+    "E501",  # line too long, handled by formatter
+    "B008",  # do not perform function calls in argument defaults
+    "C901",  # too complex
+    "ARG002",  # unused method arguments (common in interface methods)
+    "B904",  # raise exceptions with 'from' (too many to fix right now)
+    "SIM117",  # nested with statements (style preference)
+]
+
+# Allow fix for all enabled rules (when `--fix`) is provided.
+fixable = ["ALL"]
+unfixable = []
+
+[tool.ruff.lint.per-file-ignores]
+# Ignore unused imports in test files
+"tests/*" = ["F401"]
+# Ignore f-string issues in specific files
+"todo_agent/interface/tools.py" = ["F541"]
+"todo_agent/interface/cli.py" = ["F541"]
+"todo_agent/infrastructure/todo_shell.py" = ["F541"]
+
+[tool.ruff.format]
+# Like Black, use double quotes for strings.
+quote-style = "double"
+
+# Like Black, indent with spaces, rather than tabs.
+indent-style = "space"
+
+# Like Black, respect magic trailing commas.
+skip-magic-trailing-comma = false
+
+# Like Black, automatically detect the appropriate line ending.
+line-ending = "auto"
+
+[tool.ruff.lint.isort]
+# Like isort, sort imports using a single line after the import block.
+combine-as-imports = true
+
+[tool.mypy]
+python_version = "3.11"
+warn_return_any = false
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_incomplete_defs = true
+check_untyped_defs = true
+disallow_untyped_decorators = true
+no_implicit_optional = true
+warn_redundant_casts = true
+warn_unused_ignores = false
+warn_no_return = true
+warn_unreachable = true
+strict_equality = true
+namespace_packages = true
+explicit_package_bases = true
+ignore_missing_imports = true
+allow_redefinition = true
+
+[[tool.mypy.overrides]]
+module = [
+    "todo_agent.infrastructure.llm_client_factory",
+    "todo_agent.infrastructure.inference"
+]
+allow_redefinition = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "--strict-markers",
+    "--strict-config",
+    "--cov=todo_agent",
+    "--cov-report=term-missing",
+    "--cov-report=html",
+]
+markers = [
+    "integration: marks tests as integration tests",
+    "lint: marks tests as linting checks",
+]

todo_agent-0.2.1/requirements-dev.txt

@@ -0,0 +1,27 @@
+# Include all production requirements
+-r requirements.txt
+
+# Development and linting tools
+ruff>=0.12.0
+mypy>=1.17.0
+
+# Testing
+pytest>=8.0.0
+pytest-cov>=6.0.0
+
+# Additional development tools
+pre-commit>=4.0.0
+bandit>=1.8.0
+
+# Documentation
+sphinx>=8.0.0
+sphinx-rtd-theme>=3.0.0
+
+# Code quality
+radon>=6.0.0
+xenon>=0.9.0
+
+# Build and packaging
+build>=1.2.0
+twine>=6.0.0
+setuptools_scm[toml]>=9.0.0

todo_agent-0.2.1/requirements.txt

@@ -0,0 +1,6 @@
+# Core dependencies
+requests>=2.32.0
+typing-extensions>=4.15.0
+types-requests>=2.32.0
+rich>=14.0.0
+tiktoken>=0.11.0