polycoding 0.1.0__py3-none-any.whl

polycoding-0.1.0.dist-info/METADATA

@@ -0,0 +1,225 @@
+Metadata-Version: 2.4
+Name: polycoding
+Version: 0.1.0
+Summary: Coding agent that lives in your project management tool
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: alive-progress==3.3.0
+Requires-Dist: celery>=5.4.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: crewai-tools>=0.76.0
+Requires-Dist: crewai[litellm]>=1.10.0b1
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: flower>=2.0.1
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: langchain-core>=1.2.19
+Requires-Dist: ollama>=0.6.1
+Requires-Dist: pathspec>=0.12.0
+Requires-Dist: psycopg2-binary>=2.9.9
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pygithub>=2.8.1
+Requires-Dist: pygls>=1.3.0
+Requires-Dist: pyjwt[crypto]>=2.9.0
+Requires-Dist: pyright>=1.1.408
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: python-socketio>=5.16.1
+Requires-Dist: redis>=5.2.0
+Requires-Dist: rich>=14.3.3
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: sqlmodel>=0.0.22
+Requires-Dist: tqdm>=4.67.3
+Requires-Dist: tree-sitter-go>=0.23.0
+Requires-Dist: tree-sitter-javascript>=0.23.0
+Requires-Dist: tree-sitter-python>=0.23.0
+Requires-Dist: tree-sitter-rust>=0.23.0
+Requires-Dist: tree-sitter-typescript>=0.23.0
+Requires-Dist: tree-sitter>=0.23.0
+Requires-Dist: ty>=0.0.21
+Requires-Dist: typer>=0.23.1
+Requires-Dist: uvicorn[standard]>=0.32.0
+Description-Content-Type: text/markdown
+
+# Polycode 🚀
+
+Multi-agent software development automation using CrewAI with GitHub App integration for webhook-driven workflows.
+
+## Overview
+
+Polycode automates software development tasks using AI-powered multi-agent workflows built with CrewAI. It integrates as a GitHub App to provide seamless automation across multiple repositories.
+
+**Key Features:**
+
+- **Multi-agent workflows** with CrewAI framework
+- **GitHub App integration** for multi-repo automation
+- **Webhook-driven automation** triggered by labels
+- **Push to external repos** via GitHub App tokens
+- **Label-to-flow mapping** (e.g., `ralph` → `ralph_flow`)
+
+### Available Workflows
+
+- **Ralph Flow** (`ralph`): Fast iterative implementation with automated verification
+- **Feature Development Flow** (`feature-dev`): Comprehensive feature implementation with planning, testing, and review
+
+## Ralph Flow
+
+The Ralph Flow is an iterative development workflow that implements changes with built-in verification loops. It's designed for fast, reliable code changes with automatic quality checks.
+
+### How It Works
+
+1. **Setup** - Initialize worktree and pick up the issue
+2. **Plan** - Decompose the task into ordered user stories
+3. **Ralph Loop** - Iterative implementation with verification:
+   - Implement the current story
+   - Run tests to verify changes
+   - If tests fail, retry with error context (max 3 iterations)
+   - If tests pass, commit the story and move to next
+4. **Verify Build** - Final build and test verification
+5. **Push & PR** - Push changes and create pull request
+
+### Ralph Loop Control Flow
+
+The loop uses a router-based mechanism with status outputs:
+
+- **`retry`** → Continue loop with error context included
+- **`story_done`** → Commit current story, proceed to next
+- **`done`** → All stories complete, run final verification
+
+Key safety features:
+
+- **Per-Story Commits**: Each story is committed immediately upon completion
+- **Safety Brake**: Maximum 3 iterations per story prevents runaway processes
+- **Error Context**: Agent receives previous errors for smarter retries
+
+### Tools Available to Ralph Agents
+
+- **FileReadTool** - Read file contents
+- **FileWriterTool** - Write/modify files
+- **DirectoryReadTool** - Explore directory structure
+- **ExecTool** - Execute shell commands (build, test, lint)
+- **AgentsMDLoaderTool** - Load AGENTS.md context files
+
+## Feature Development Flow
+
+A comprehensive workflow for larger feature implementations:
+
+1. **Plan** - Decompose task into ordered user stories
+2. **Implement** - Implement each story with tests
+3. **Push** - Push changes to repository
+4. **Create PR** - Create pull request
+5. **Review** - Code review with feedback
+
+## Project Structure
+
+```
+polycode/
+├── src/
+│   ├── ralph/               # Ralph Loop workflow
+│   │   ├── crews/
+│   │   │   ├── plan_crew/   # Planning crew
+│   │   │   └── ralph_crew/  # Implementation crew
+│   │   └── __init__.py      # Ralph flow definition
+│   ├── feature_dev/         # Feature development workflow
+│   │   └── crews/
+│   │       ├── plan_crew/
+│   │       ├── implement_crew/
+│   │       ├── verify_crew/
+│   │       ├── test_crew/
+│   │       └── review_crew/
+│   ├── github_app/          # GitHub App integration
+│   ├── project_manager/     # Project management utilities
+│   ├── celery_tasks/        # Async task processing
+│   ├── persistence/         # Database layer
+│   ├── tools/               # Custom CrewAI tools
+│   └── flowbase.py          # Base flow classes
+├── tests/                   # Test files
+└── pyproject.toml           # Project configuration
+```
+
+## Installation
+
+### Prerequisites
+
+- Python 3.13 or higher
+- `uv` package manager
+
+### Setup
+
+```bash
+# Install dependencies
+uv sync
+
+# Configure environment
+cp .env.example .env
+# Edit .env with your credentials
+```
+
+Required environment variables:
+
+- `GITHUB_TOKEN` - GitHub personal access token
+- `DATABASE_URL` - PostgreSQL connection string
+- `REDIS_HOST` / `REDIS_PORT` - Redis configuration
+- `OPENAI_API_KEY` - OpenAI API key
+
+## Usage
+
+### Running Flows
+
+```bash
+# Run Ralph flow example
+uv run ralph
+
+# Run feature development example
+uv run example
+```
+
+### GitHub App Integration
+
+Polycode includes GitHub App support for webhook-driven automation:
+
+1. **Create GitHub App** at <https://github.com/settings/apps/new>
+2. **Configure permissions**: Issues, Projects, Contents, Pull requests (Read & Write)
+3. **Set webhook URL** and secret
+4. **Generate private key** and add to `.env`
+5. **Install app** on target repositories
+6. **Create label mappings** to trigger flows
+
+### Label-to-Flow Mapping
+
+```bash
+# Map "ralph" label to ralph flow
+curl -X POST http://localhost:8000/mappings \
+  -H "Content-Type: application/json" \
+  -d '{
+    "installation_id": 12345,
+    "label_name": "ralph",
+    "flow_name": "ralph_flow"
+  }'
+```
+
+## Development
+
+### Commands
+
+```bash
+uv sync                   # Install dependencies
+uv run ruff check .       # Lint
+uv run ruff format .      # Format
+uv run pytest             # Run tests
+uv run pyright            # Type check
+```
+
+### Code Style
+
+- Line length: 79 characters
+- Use modern Python 3.10+ type annotations
+- See `src/AGENTS.md` for complete guidelines
+
+## Resources
+
+- [CrewAI Documentation](https://docs.crewai.com/)
+- [GitHub Apps Docs](https://docs.github.com/en/apps)
+
+## License
+
+MIT [LICENSE](./LICENSE)

polycoding-0.1.0.dist-info/RECORD

@@ -0,0 +1,41 @@
+cli/__init__.py,sha256=WbkPuGbTRtPCddA5SNXfDrI1qFZuReWz3UjeBOkWfY8,1432
+cli/db.py,sha256=xT_TMMTMRRcpeAPa9e4zuJhB0q0XHYi_lRn8mmlSZ9Y,1898
+cli/flow.py,sha256=kwkNri_un8TAnOOlo903_usVt8TJyDZ50tBdR6vve_0,6348
+cli/main.py,sha256=27CVtngZK3uGkEgRJAiyYtCHDT1iW3xu-1hSGOXZxhM,1383
+cli/project.py,sha256=7-SlPJXRJa9jrJNTOZJOvbAXkp-LM4oZH0trhDEMTdI,5115
+cli/server.py,sha256=CnSbRGkpOYh-2XuqHojvONvFnsdGqrOqoBAOPmuPKqY,3949
+cli/utils.py,sha256=MZDJ_GpRdwoezQbgUse3ELsOWPEcr_ql6ksgpU56gF8,1572
+cli/worker.py,sha256=p8FB43s5qs8zU5ZytrSSjD3NychWadt2Au_kbM9r-nQ,3964
+github_app/__init__.py,sha256=JQbrBpJnm6DdVpLZ6MAY6uGXT0PW7aoUhNhf8D8rmu8,402
+github_app/app.py,sha256=4T5cV-NNpePmZEcO_hCdlAPDpk8Y7v25p2wX8QJIkL4,6617
+github_app/auth.py,sha256=emXMCiU22L6azA7AK1k2qCGfesrfSqkWll6qPqOTMdQ,4417
+github_app/config.py,sha256=RUlH2wA87sEWTVZjXRYNrhO51UrUJL987a2T2UUR5oY,1116
+github_app/installation_manager.py,sha256=97bOOzOXL8G-oA6J1UBAhGaQPqxnzBdJstO6JyVrODg,6829
+github_app/label_mapper.py,sha256=FBaCS_7EmxDjzBc3hJStJ6qyux8g8ApZiGAe79kQfcw,3835
+github_app/models.py,sha256=Tp1zw9_ZB_Xcu4aKJ63SMcr595I0Hpp6gtKIRHaWtts,5208
+github_app/webhook_handler.py,sha256=cS6G1_PsnbteIXMlYptmM0ztEIXxPNvLHsgP9RGs6DU,8521
+persistence/__init__.py,sha256=452FrNX7B1GYXxgo5R4K1ybUF1TsbKxSYKTD4xn93XA,126
+persistence/config.py,sha256=isXOAlaSzMiRSzhKl86vehFS14QKAfD1M5WGVVhQ4W4,330
+persistence/postgres.py,sha256=LNSnIkkzem5TRAmuM9yV5on2Ai0pik_g1I1s8c-S1R4,11756
+persistence/registry.py,sha256=gV6Z8F2wAUmcszOCF0IlhBqtm_Vj7nD3B9OAqlRuK8U,3646
+persistence/tasks.py,sha256=APLJsBlP5ghPFz7V7w5QkL5XhTqK-2suN73CTMiUSVE,6004
+project_manager/README.md,sha256=e5udBtRStqDQ3Aq3k9DpOGoPguQOjkI1TuvSqPaj7YQ,16644
+project_manager/__init__.py,sha256=bRsp6ncHWzz2LGQbQeNcS9ShnSnxGEBFp5o-lxfTMmw,682
+project_manager/base.py,sha256=We4KCRdGDZ7E4J__Eqqo_SyQEyrlindPS7jDA0XcwWs,5203
+project_manager/config.py,sha256=Kji1JtRJoNs-GX7HTBUOZa--OhMJqpIY90Y6fPOFtiI,1038
+project_manager/flow_runner.py,sha256=YYC-wN1Gqh2TLo9T8CWxl69AhizeO1jfB0j7MY4NpRM,5620
+project_manager/git_utils.py,sha256=CSqMopjVpJNq0RGWdmxkOuMCT8HnCK0VoaDU7XZj0jc,772
+project_manager/github.py,sha256=OUEqSVkVA0gSOwHSUiNzjiZ7o2a5p_7CSn2xaU-6iss,12413
+project_manager/github_conversation.py,sha256=I4EXtYflTA_cODgzczoNq6EEKSI4HlHb0GLciiygUW8,4834
+project_manager/github_projects_client.py,sha256=2uw3NX3EjNkK81_NIzwIwqHg7EQLVQ_jyLcScTkc7gE,10115
+project_manager/hooks.py,sha256=KRRAo-d4GHLMX_zu9Yq1MYvR_l7IqSlx6gUAvZZ7Jro,13255
+project_manager/module.py,sha256=wWRXvJT60kEymIW3nHeo2PTCHRtwaRbJqcwRfa7DHZQ,2242
+project_manager/types.py,sha256=xWESlIhFcDBjIcChXgftdpEDfrlktPh-glcuM_k0zEw,1998
+project_manager/conversation/__init__.py,sha256=Ji3Ppww80tbcC_nKfTm8IjbKFlezzEsx3a-j2vGJlis,391
+project_manager/conversation/flow.py,sha256=qlNLcDKppoE7av5qhtuLQHL27OdscJikSMiVay0PE40,8514
+project_manager/conversation/types.py,sha256=gkD6aO1JJuclvkbNSOIfhtf6wAYragF6OLPYh5XJMgo,2164
+polycoding-0.1.0.dist-info/METADATA,sha256=17MeyQPNYTgQGKeA_fEyxKDXM87qhvYfMkFSB0nc1Fk,6927
+polycoding-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+polycoding-0.1.0.dist-info/entry_points.txt,sha256=-1r49Dppa8rFqKqEWj9nS0x44wzMzAjwr1htd478C1A,66
+polycoding-0.1.0.dist-info/licenses/LICENSE,sha256=d-kk7WiJFLP7jYZo-MemeVYOWwK-N_5YBZeijVntY2o,1065
+polycoding-0.1.0.dist-info/RECORD,,

polycoding-0.1.0.dist-info/WHEEL

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

polycoding-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+example = ralph:example
+polycode = cli.main:app

polycoding-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+Copyright 2026, ChainSquad GmbH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+