mapify-cli 1.0.0__py3-none-any.whl

mapify_cli-1.0.0.dist-info/METADATA

@@ -0,0 +1,310 @@
+Metadata-Version: 2.4
+Name: mapify-cli
+Version: 1.0.0
+Summary: MAP Framework installer - Modular Agentic Planner for Claude Code
+Project-URL: Homepage, https://github.com/azalio/map-framework
+Project-URL: Repository, https://github.com/azalio/map-framework.git
+Project-URL: Issues, https://github.com/azalio/map-framework/issues
+Author: MAP Framework Contributors
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: readchar>=4.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == 'dev'
+Requires-Dist: mypy>=1.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-mock>=3.10.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Provides-Extra: ssl
+Requires-Dist: truststore>=0.9.0; extra == 'ssl'
+Provides-Extra: test
+Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
+Requires-Dist: pytest-mock>=3.10.0; extra == 'test'
+Requires-Dist: pytest>=7.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# MAP Framework for Claude Code
+
+Implementation of **Modular Agentic Planner (MAP)** — a cognitive architecture for AI agents inspired by prefrontal cortex functions. Orchestrates 8 specialized agents for development with automatic quality validation.
+
+> **Based on:** [Nature Communications research (2025)](https://github.com/Shanka123/MAP) — 74% improvement in planning tasks
+> **Enhanced with:** [ACE (Agentic Context Engineering)](https://arxiv.org/abs/2510.04618v1) — continuous learning from experience
+
+## 📖 Documentation Structure
+
+- **README** (this file) - Quick start and overview
+- **[INSTALL.md](docs/INSTALL.md)** - Complete installation guide with PATH setup and troubleshooting
+- **[ARCHITECTURE.md](docs/ARCHITECTURE.md)** - Technical deep dive, customization, and MCP integration
+- **[USAGE.md](docs/USAGE.md)** - Practical examples, best practices, and cost optimization
+
+## 🚀 Quick Start
+
+### Inside Claude Code (Recommended)
+
+```bash
+# Feature development
+/map-feature implement user authentication with JWT tokens
+
+# Debugging
+/map-debug fix the API 500 error on login endpoint
+
+# Refactoring
+/map-refactor refactor UserService class with dependency injection
+
+# Code review
+/map-review review the recent changes in auth.py
+```
+
+### Command Line Usage
+
+MAP Framework works exclusively through slash commands in Claude Code:
+
+```bash
+# Start Claude Code in your project directory
+cd your-project
+claude
+
+# Use slash commands inside Claude Code
+/map-feature implement user authentication with JWT tokens
+```
+
+**Note:** Direct `claude --agents` syntax is not applicable to MAP Framework, as the orchestration logic is implemented in slash command prompts (`.claude/commands/map-*.md`), not as a separate agent file.
+
+## 📦 Installation
+
+### Stable Release (Recommended)
+
+```bash
+# Using pip
+pip install mapify-cli
+
+# OR using UV (recommended for isolated tools)
+uv tool install mapify-cli
+
+# Verify installation
+mapify --version
+
+# Initialize in your project
+cd your-project
+mapify init
+```
+
+**Version Pinning:**
+```bash
+# Install specific version
+pip install mapify-cli==1.0.0
+
+# Install with version constraints (semantic versioning: MAJOR.MINOR.PATCH)
+pip install "mapify-cli>=1.0.0,<2.0.0"  # Allow 1.x versions, exclude 2.0.0+
+```
+
+**Version Information:**
+- Check installed version: `mapify --version`
+- [PyPI releases](https://pypi.org/project/mapify-cli/) - Available versions and package details
+- [GitHub releases](https://github.com/azalio/map-framework/releases) - Changelog and release notes
+
+### Development Installation
+
+For contributors or testing bleeding-edge features:
+
+```bash
+# Install from git repository
+uv tool install --from git+https://github.com/azalio/map-framework.git mapify-cli
+
+# OR clone and install locally
+git clone https://github.com/azalio/map-framework.git
+cd map-framework
+pip install -e .
+```
+
+**Other installation methods** (manual copy, troubleshooting): See [INSTALL.md](docs/INSTALL.md)
+
+**For maintainers**: Release process documented in [RELEASING.md](RELEASING.md)
+
+## Requirements
+
+- **Claude Code CLI** — installed and configured
+- **Python 3.11+** — for mapify CLI (optional)
+- **Git** — for cloning repository
+
+## 🏗️ Architecture
+
+MAP Framework orchestrates 8 specialized agents through slash commands:
+
+- **TaskDecomposer** breaks goals into subtasks
+- **Actor** generates code, **Monitor** validates quality
+- **Predictor** analyzes impact, **Evaluator** scores solutions
+- **Reflector/Curator** enable continuous learning via ACE playbook
+
+The orchestration logic lives in `.claude/commands/map-*.md` prompts, coordinating agents via the Task tool.
+
+**See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for:**
+- Detailed agent specifications and responsibilities
+- MCP integration architecture and tool usage patterns
+- Agent coordination protocol and workflow stages
+- Template customization guide with examples
+- Hooks integration (automated validation, knowledge storage, context enrichment)
+- Context engineering principles and optimizations
+
+## 🔌 MCP Integration
+
+MAP uses MCP (Model Context Protocol) servers for enhanced capabilities:
+
+- **cipher** - Knowledge base for storing and retrieving successful patterns
+- **claude-reviewer** - Professional code review with security analysis
+- **context7** - Up-to-date library documentation
+- **sequential-thinking** - Chain-of-thought reasoning for complex problems
+- **codex-bridge** - AI code generation (requires extended timeout)
+- **deepwiki** - GitHub repository intelligence
+
+Configuration files: `.claude/mcp_config.json` and `mcp_config.json`
+
+**See [ARCHITECTURE.md](docs/ARCHITECTURE.md#mcp-integration) for complete setup and usage patterns**
+
+## 📚 Usage Examples
+
+```bash
+# Feature development
+/map-feature implement user profile page with avatar upload
+
+# Bug fixing
+/map-debug debug why payment processing fails for amounts over $1000
+
+# Refactoring
+/map-refactor refactor OrderService to use dependency injection
+```
+
+**See [USAGE.md](docs/USAGE.md) for:**
+- Comprehensive usage examples with detailed scenarios
+- Best practices for optimal results
+- Cost optimization strategies (40-60% savings)
+- Playbook management commands
+
+## 🎓 ACE Playbook
+
+Built-in learning system that improves with each task:
+
+- **Reflector** extracts patterns from successes and failures
+- **Curator** maintains structured knowledge base with quality tracking
+- **Semantic search** (optional) finds patterns by meaning, not keywords
+- Automatically grows high-quality pattern library
+
+### Playbook Commands
+
+```bash
+# View statistics
+mapify playbook stats
+
+# Search patterns
+mapify playbook search "JWT authentication"
+
+# View high-quality patterns
+mapify playbook sync
+```
+
+**Optional semantic search**: `pip install -r requirements-semantic.txt` for meaning-based matching. Details in [SEMANTIC_SEARCH_SETUP.md](docs/SEMANTIC_SEARCH_SETUP.md) and [ARCHITECTURE.md](docs/ARCHITECTURE.md#semantic-search).
+
+**Playbook configuration**: See [ARCHITECTURE.md](docs/ARCHITECTURE.md#playbook-configuration) for top_k settings and optimization.
+
+## 💰 Cost Optimization
+
+MAP Framework uses intelligent model selection per agent:
+
+- **Predictor & Evaluator** use **haiku** (fast analysis) → ⬇️⬇️⬇️ cost
+- **Actor, Monitor, Reflector, Curator** use **sonnet** (quality-critical) → balanced cost
+
+**Result:** 40-60% cost reduction vs all-sonnet while maintaining code quality.
+
+**See [USAGE.md](docs/USAGE.md#cost-optimization) for detailed cost breakdown and model override strategies**
+
+## 🔗 Hooks Integration
+
+MAP integrates with Claude Code hooks for automated validation, knowledge storage, and context enrichment. Active hooks protect template variables, auto-store successful patterns, enrich prompts with relevant knowledge, and track performance metrics.
+
+**See [ARCHITECTURE.md](docs/ARCHITECTURE.md#hooks-integration) and [.claude/hooks/README.md](.claude/hooks/README.md) for configuration**
+
+## 🛠️ Troubleshooting
+
+### Command Not Found
+
+```
+Error: Slash command not recognized
+```
+
+**Solution:**
+- Ensure you're in a directory with `.claude/commands/` containing `map-*.md` files
+- Use `/map-feature`, `/map-debug`, `/map-refactor`, or `/map-review`
+- Run `/help` to see available commands
+
+### Agent Not Found
+
+```
+Error: Agent file not found
+```
+
+**Solution:** Ensure `.claude/agents/` directory contains all 8 agent files (task-decomposer.md, actor.md, monitor.md, predictor.md, evaluator.md, reflector.md, curator.md, documentation-reviewer.md)
+
+### Semantic Search Warning
+
+```
+Warning: sentence-transformers not installed
+```
+
+**Solution:** `pip install -r requirements-semantic.txt`
+See [SEMANTIC_SEARCH_SETUP.md](docs/SEMANTIC_SEARCH_SETUP.md) for detailed troubleshooting
+
+### Infinite Loops
+
+```
+Actor-Monitor loop exceeding iterations
+```
+
+**Solution:** Orchestrator limits iterations to 3-5. Clarify requirements or add constraints.
+
+**More troubleshooting**: See [INSTALL.md](docs/INSTALL.md#troubleshooting) for PATH issues, MCP configuration, and installation problems
+
+## 🔧 Customization
+
+Agent prompts in `.claude/agents/*.md` use Handlebars template syntax for dynamic context injection. You can safely modify instructions, examples, and validation criteria, but **MUST NOT remove template variables** like `{{language}}`, `{{#if playbook_bullets}}`, or `{{feedback}}` — these are critical for orchestration and ACE learning.
+
+**See [ARCHITECTURE.md](docs/ARCHITECTURE.md#customization-guide) for:**
+- Safe vs unsafe modifications with examples
+- Template variable reference
+- Model selection per agent
+- Adding custom agents
+- Template validation and git hooks
+
+## 📊 Success Metrics
+
+- **Monitor approval rate:** >80% first try
+- **Evaluator scores:** average >7.0/10
+- **Iteration count:** <3 per subtask
+- **Playbook growth:** increasing high-quality patterns
+
+## 🤝 Contributing
+
+Improvements welcome:
+- Prompts for specific languages/frameworks
+- New specialized agents
+- CI/CD integrations
+- Success story examples
+- Plugin extensions for MAP Framework
+
+## 📄 License
+
+MIT License — see LICENSE file for details
+
+## 🔗 References
+
+- [MAP Paper - Nature Communications](https://github.com/Shanka123/MAP)
+- [ACE Paper - arXiv:2510.04618v1](https://arxiv.org/abs/2510.04618v1)
+- [Claude Code Documentation](https://docs.anthropic.com/en/docs/claude-code)
+
+---
+
+**MAP is not just automation — it's systematic quality improvement through structured validation and iterative refinement.**

mapify_cli-1.0.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+mapify_cli/__init__.py,sha256=JIRolEMacfn5s7K05lff8wXyp3eUCQJjoheaO3JooEk,67790
+mapify_cli/playbook_manager.py,sha256=DL_xoVMm6zc7GXUUtLNpIgPXvCbc4eJTZITNTt_WyeI,18243
+mapify_cli/recitation_manager.py,sha256=xGvHSSyRF-Fpa4G-akZDxILU3eWw--IJeWRPUjhggFk,18711
+mapify_cli/semantic_search.py,sha256=xhJ5XE8FhbzLzlzFFUMRwv35wi0kS_zJJA13FlkqoKc,13408
+mapify_cli/workflow_logger.py,sha256=0TYAJ8RJhG5ny75ic810oX61mQDJT6qLvFznDGtgrys,13656
+mapify_cli/templates/settings.hooks.json,sha256=-vx0_su8yUaRW0xSOpVbZKBL-5S6lb6FDnr_ve_F9SE,654
+mapify_cli/templates/agents/CHANGELOG.md,sha256=ngEltZqhHNI_AT25LTRNxy9tHPej3_e5oHg7XR581HI,5990
+mapify_cli/templates/agents/MCP-PATTERNS.md,sha256=Mf7GlSP2_nxg38cdXptY5YUoI8kVkbuhUgzZo3BA3HI,10441
+mapify_cli/templates/agents/README.md,sha256=5d52XLMf5HIvyzZAsm69PzkLjN5YgRq7qHIDkCjxEi4,5955
+mapify_cli/templates/agents/actor.md,sha256=jtzrVspLp42kq8l4rFu9l7UgM84XG3NL2N2GuphT8-s,21355
+mapify_cli/templates/agents/curator.md,sha256=LZJn9kgXdOSjiUl4SDUForM9u7bE6rvqqfmVKCQdxXU,40233
+mapify_cli/templates/agents/documentation-reviewer.md,sha256=A_b_XcV3yVXvEc8QJHR7ebIdY-iIpBBasl_6VELtCMs,47421
+mapify_cli/templates/agents/evaluator.md,sha256=_yv8lHsN0Fq3kLIOfAkmic8A9jMFRUiIM74qjY6gse0,34411
+mapify_cli/templates/agents/monitor.md,sha256=HGFcXID6nkIPcbdp6-WHwW3XjDcdstRGqyBFdUrBS1E,34081
+mapify_cli/templates/agents/predictor.md,sha256=_6EG-oeoFklfcIMpC71ZvzzRGWOj4MsA2c7mOOgjCaw,34890
+mapify_cli/templates/agents/reflector.md,sha256=sTrrTSdbJNKkuZLQcRo1hTNiRwe-lGo3VSuNBbxbpnw,47071
+mapify_cli/templates/agents/task-decomposer.md,sha256=eO2suI8hGMHOK8ffQvJ1pdX66DY12qAYliwbfh5ww9M,46011
+mapify_cli/templates/agents/test-generator.md,sha256=NPR_lYYtbeig4aXE-URnRZfBv1psqc8ApxdU5_SOBCg,38966
+mapify_cli/templates/commands/map-debug.md,sha256=aiUp-yolk6vL7a3z-svm5kn__4BRZr89PGLHaCYNI9Y,8531
+mapify_cli/templates/commands/map-feature.md,sha256=YvJedmtLKPJhRTFc8XlXDO6lChMRQ8Djolg9XGM6xuQ,15309
+mapify_cli/templates/commands/map-refactor.md,sha256=XWReF-q6WktxnCy279mFk6BdV23LzfoAXFRrqY_-h9U,9392
+mapify_cli/templates/commands/map-review.md,sha256=YNjAEoEEGBnnIsR87NSqBU2mvHWTA1_3vbUJyj_M2uA,1301
+mapify_cli/templates/hooks/README.md,sha256=uFZHJ7EdFcNtYnjBOhoAu1UMz5eRbxhqvSiH-PTFzIE,1761
+mapify_cli/templates/hooks/validate-agent-templates.sh,sha256=YPtm9fw6oAjKgM68dgcH-ucF42lcTXqYnl5I5hcI7Xs,3262
+mapify_cli-1.0.0.dist-info/METADATA,sha256=ZRbzhsrstY-gEdGhBRrq0gIgBgJfBr6mn5SnJpF4zqQ,10651
+mapify_cli-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+mapify_cli-1.0.0.dist-info/entry_points.txt,sha256=JEbE3NIipHUFQOjczbX0IuqMLxfPHUQgTKWk2q4ihBw,43
+mapify_cli-1.0.0.dist-info/RECORD,,

mapify_cli-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

mapify_cli-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mapify = mapify_cli:main