Metadata-Version: 2.4
Name: exarp
Version: 0.1.17
Summary: MCP server for project management automation - health scores, task alignment, security scanning
Author-email: David Lowes <lindog1@users.noreply.github.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/davidl71/project-management-automation
Project-URL: Repository, https://github.com/davidl71/project-management-automation
Project-URL: Documentation, https://github.com/davidl71/project-management-automation#readme
Project-URL: Issues, https://github.com/davidl71/project-management-automation/issues
Keywords: mcp,model-context-protocol,project-management,automation,ai-tools,fastmcp,task-management,code-health
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-mock>=3.10.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Dynamic: license-file

# Exarp

**MCP Server for Project Management Automation**

[![PyPI version](https://badge.fury.io/py/exarp.svg)](https://pypi.org/project/exarp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

## Install

```bash
pip install exarp
```

## Quick Start

```bash
# Run the MCP server
exarp

# Or use aliases
pma
python -m project_management_automation.server
```

## MCP Client Configuration

Add to your MCP client config (Cursor, Claude Desktop, VS Code):

```json
{
  "mcpServers": {
    "exarp": {
      "command": "exarp",
      "args": []
    }
  }
}
```

## Features

### 🏥 Project Health
| Tool | Description |
|------|-------------|
| `server_status` | Server status, version, tools count |
| `project_scorecard` | Comprehensive health metrics (codebase, tests, tasks, docs, security) |
| `project_overview` | One-page summary (text, markdown, HTML, slides) |

### 📚 Documentation
| Tool | Description |
|------|-------------|
| `check_documentation_health` | Analyze docs, find broken links, validate formatting |
| `add_external_tool_hints` | Add Context7 hints to documentation |

### ✅ Task Management
| Tool | Description |
|------|-------------|
| `analyze_todo2_alignment` | Check task alignment with PROJECT_GOALS.md |
| `detect_duplicate_tasks` | Find and merge duplicate tasks |
| `consolidate_tags` | Standardize task tags |
| `task_hierarchy_analyzer` | Recommend task hierarchies |
| `batch_approve_tasks` | Batch approve tasks without clarification needed |
| `sync_todo_tasks` | Sync between TODO table and Todo2 |

### 🔒 Security
| Tool | Description |
|------|-------------|
| `scan_dependency_security` | Scan Python/Rust/npm for vulnerabilities |

### 🤖 Automation
| Tool | Description |
|------|-------------|
| `run_daily_automation` | Daily maintenance (docs, alignment, duplicates) |
| `run_nightly_task_automation` | Execute background tasks in parallel |
| `sprint_automation` | Full sprint with subtask extraction |
| `find_automation_opportunities` | Discover automation candidates |

### 🔧 CI/CD & Git
| Tool | Description |
|------|-------------|
| `validate_ci_cd_workflow` | Validate GitHub Actions workflows |
| `setup_git_hooks` | Configure pre-commit/pre-push hooks |
| `setup_pattern_triggers` | File/git/task pattern automation |
| `check_working_copy_health` | Git status across agents |

### 🧪 Testing
| Tool | Description |
|------|-------------|
| `run_tests` | Execute pytest/unittest/ctest |
| `analyze_test_coverage` | Coverage reports and gap analysis |

## ZSH Plugin

For shell integration with context-aware project health:

```bash
# Add to ~/.zshrc
source /path/to/exarp.plugin.zsh

# Commands
xl   # Quick context (no Python needed)
xc   # Full context with score
xs   # Project scorecard
xo   # Project overview
xt   # List pending tasks
xp   # Scan for projects
motd # Daily wisdom
```

See `shell/exarp.plugin.zsh` for full documentation.

## Daily Wisdom

Exarp includes optional daily wisdom quotes based on project health:

```bash
# Configure source
export EXARP_WISDOM_SOURCE=stoic  # or: bofh, tao, bible, murphy, shakespeare, sefaria

# Disable
export EXARP_WISDOM_DISABLED=1
```

## Man Pages

```bash
man exarp       # MCP server documentation
man exarp-zsh   # ZSH plugin documentation
```

## Requirements

- Python 3.9+
- FastMCP 2.0+
- Pydantic 2.0+

## Links

- **PyPI**: https://pypi.org/project/exarp/
- **GitHub**: https://github.com/davidl71/project-management-automation
- **Issues**: https://github.com/davidl71/project-management-automation/issues

## License

MIT License - see [LICENSE](LICENSE)
