polycoding 0.1.0__tar.gz

polycoding-0.1.0/.dockerignore

@@ -0,0 +1,80 @@
+# Python
+.tox/
+.venv/
+*.pem
+**/__pycache__
+*.pyc
+*.pyo
+*.pyd
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+node_modules
+**/node_modules
+
+# Virtual environments
+venv/
+**/venv/
+env/
+**/env/
+ENV/
+**/ENV/
+.venv/
+**/.venv/
+
+.ruff_cache
+.git
+.github
+Dockerfile
+
+
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Environment variables
+.env
+
+# OS
+.DS_Store
+Thumbs.db
+
+# CrewAI specific
+crew_output/
+
+# Logs
+*.log
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# uv
+.python-version
+
+*.db
+
+deployment
+Makefile
+.gitignore
+tests

polycoding-0.1.0/.env.example

@@ -0,0 +1,104 @@
+# CrewAI Configuration
+# Copy this file to .env and fill in your values
+
+# OpenAI API Key (or your preferred LLM provider)
+# CrewAI supports multiple providers: OpenAI, Anthropic, Azure, etc.
+# See: https://docs.crewai.com/en/concepts/llms#setting-up-your-llm
+OPENAI_API_KEY=sk-your-api-key-here
+
+# Alternative: Anthropic API Key
+# ANTHROPIC_API_KEY=sk-ant-your-api-key-here
+
+# Alternative: Azure OpenAI
+# AZURE_API_BASE=https://your-resource.openai.azure.com
+# AZURE_API_KEY=your-azure-api-key-here
+# AZURE_API_VERSION=2024-02-15-preview
+# AZURE_DEPLOYMENT_NAME=gpt-4
+
+# Serper API Key (for web search tools, if needed)
+# SERPER_API_KEY=your-serper-api-key-here
+
+# CrewAI Settings
+# CREWAI_PROCESS_MODE=sequential
+# CREWAI_VERBOSE=true
+
+# Optional: Custom Model Configuration
+# CREWAI_LLM=openai/gpt-4
+# CREWAI_TEMPERATURE=0.7
+
+# =============================================================================
+# DATABASE CONFIGURATION
+# =============================================================================
+
+# Database URL - supports SQLite and PostgreSQL
+# SQLite (default): file-based, no server required
+DATABASE_URL=sqlite:///./feature_dev.db
+
+# PostgreSQL: production-ready, requires running PostgreSQL server
+# Automatically uses JSONB for JSON columns
+# DATABASE_URL=postgresql+psycopg2://user:password@localhost:5432/feature_dev
+
+# Enable SQL query logging (useful for debugging)
+# DATABASE_ECHO=true
+
+# =============================================================================
+# WEBHOOK CONFIGURATION
+# =============================================================================
+
+# Webhook timeout in seconds (default: 10)
+# WEBHOOK_TIMEOUT=10
+
+# =============================================================================
+# DATABASE SCHEMA
+# =============================================================================
+#
+# Tables:
+#
+# 1. flow_execution - Main flow run record
+#    - id, flow_id (unique), issue_id, task, repo, branch
+#    - current_phase, verified, tested
+#    - build_cmd, test_cmd, ci_notes, baseline, findings
+#    - current_story_id, current_story_title
+#    - pr_url, pr_number, review_status, diff
+#    - commit_title, commit_message, commit_footer
+#    - changes (JSON), tests (JSON)
+#    - created_at, updated_at
+#
+# 2. story - Individual user stories
+#    - id, story_id, title, description
+#    - acceptance_criteria (JSON/JSONB)
+#
+# 3. flow_story - Junction table (stories planned for a flow)
+#    - id, flow_id -> flow_execution.id, story_id -> story.id, order
+#
+# 4. completed_story - Junction table (stories completed in a flow)
+#    - id, flow_id -> flow_execution.id, story_id -> story.id
+#    - completed_at, changes, tests
+#
+# 5. phase_snapshot - State at each phase transition
+#    - id, flow_id -> flow_execution.id, phase
+#    - state_json (JSON/JSONB), created_at
+#
+# 6. webhook_config - Webhook endpoints
+#    - id, name, url, events (JSON list), active
+#
+# =============================================================================
+# WEBHOOK USAGE
+# =============================================================================
+#
+# Webhooks are configured in the database via webhook_config table.
+#
+# Example: Insert a webhook via SQL
+# INSERT INTO webhook_config (name, url, events, active)
+# VALUES ('slack-notify', 'https://hooks.slack.com/services/...', '["review", "create_pr"]', 1);
+#
+# Available phases: setup, plan_task, create_branch, implement_story,
+#                   test_integration, verify, commit_changes, create_pr, review
+# Use "*" to trigger on all phases
+#
+# Webhook payload format:
+# {
+#   "phase": "review",
+#   "webhook_name": "slack-notify",
+#   "state": { ... full FeatureDevState as dict ... }
+# }

polycoding-0.1.0/.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+.venv
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Environment variables
+.env
+
+# OS
+.DS_Store
+Thumbs.db
+
+# CrewAI specific
+crew_output/
+
+# Logs
+*.log
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# uv
+.python-version
+
+feature_dev.db
+flow_state.db
+*.db

polycoding-0.1.0/AGENTS.md

@@ -0,0 +1,299 @@
+# Polycode — Coding Agent Guidelines
+
+Instructions for AI coding agents (Claude Code, Cursor, etc.) working in this repository.
+
+---
+
+## Project Overview
+
+Multi-agent software development automation using CrewAI. GitHub App integration for
+webhook-driven workflows across multiple repositories.
+
+**Stack:** Python 3.13, CrewAI, FastAPI, Celery, Redis, PostgreSQL, Pydantic
+
+---
+
+## Build / Lint / Test Commands
+
+### Package Management
+
+```bash
+uv sync                   # Install dependencies
+uv add <package>          # Add dependency
+uv lock                   # Update lock file
+```
+
+### Linting & Type Checking
+
+```bash
+uv run ruff check .                    # Lint all files
+uv run ruff check --fix .              # Auto-fix lint errors
+uv run ruff format .                   # Format code
+uv run pyright                         # Type check (via pre-commit)
+```
+
+### Testing
+
+```bash
+uv run pytest                                        # Run all tests
+uv run pytest tests/test_github_manager.py           # Run single test file
+uv run pytest tests/test_github_manager.py::test_has_label_returns_true_when_label_exists  # Single test
+uv run pytest -k "label"                             # Run tests matching pattern
+uv run pytest -v                                     # Verbose output
+```
+
+### Running the Application
+
+```bash
+uv run python -m project_manager.cli    # CLI entry point
+uv run uvicorn github_app.app:app       # FastAPI webhook server
+```
+
+### Docker
+
+```bash
+make docker       # Build and push (uses timestamp as version)
+```
+
+---
+
+## Code Style Guidelines
+
+### Linting Rules (ruff)
+
+- Line length: 79 characters
+- Enabled rules: E, F, I, N, W (E501 ignored)
+- Always run `uv run ruff check --fix .` before committing
+
+### Imports
+
+```python
+"""Module docstring."""
+
+# 1. Standard library (alphabetical)
+import json
+import logging
+import os
+import re
+from pathlib import Path
+from typing import Optional, TypeVar
+
+# 2. Third-party (alphabetical)
+import git
+from crewai import Flow
+from pydantic import BaseModel, Field
+
+# 3. Local imports (alphabetical)
+from glm import GLMJSONLLM
+from persistence.postgres import SessionLocal
+from project_manager.types import ProjectConfig
+```
+
+### Type Annotations
+
+Use modern Python 3.10+ syntax:
+
+```python
+# Prefer union syntax
+def get_issue(self, issue_id: int) -> Issue | None:
+
+# Over Optional
+def get_issue(self, issue_id: int) -> Optional[Issue]:
+
+# List/dict generics without importing from typing
+labels: list[str] = []
+config: dict[str, Any] = {}
+```
+
+### Pydantic Models
+
+```python
+class ProjectConfig(BaseModel):
+    """Configuration for a project manager."""
+
+    provider: str
+    repo_owner: str
+    repo_name: str
+    project_identifier: str | None = None
+    token: str | None = None
+    extra: dict[str, Any] = {}
+```
+
+- Always include docstrings for classes
+- Use `Field()` for field descriptions when helpful
+- Use `| None` for optional fields with defaults
+
+### Naming Conventions
+
+```python
+# Classes: PascalCase
+class GitHubProjectManager:
+
+# Functions/methods: snake_case
+def get_open_issues(self) -> list[Issue]:
+
+# Variables: snake_case
+project_items = []
+
+# Constants: UPPER_SNAKE_CASE
+MERGE_REQUIRED_LABEL = "approved"
+
+# Private methods: prefix with underscore
+def _prepare_work_tree(self):
+
+# Properties for lazy-loaded values
+@property
+def project_id(self) -> str:
+```
+
+### Error Handling
+
+```python
+# Raise specific exceptions with helpful messages
+if not token:
+    raise ValueError(
+        "GitHub token must be provided via config or GITHUB_TOKEN env var"
+    )
+
+# Handle exceptions gracefully, return sensible defaults
+try:
+    result = self.projects_client.get_project_id(owner, number)
+except github.UnknownObjectException:
+    log.warning(f"Project not found for {owner}")
+    return []
+
+# Log errors with context
+except Exception as e:
+    log.error(f"Failed to update PostgreSQL status: {e}")
+```
+
+### Logging
+
+```python
+import logging
+
+log = logging.getLogger(__name__)
+
+# Use emoji prefixes for visual scanning in logs
+log.info(f"🏹 Created worktree at: {worktree_path}")
+log.warning(f"⚠️ No test command, skipping verification")
+log.error(f"🚨 Failed to ensure request exists: {e}")
+```
+
+### Docstrings
+
+```python
+def get_open_issues(self) -> list[Issue]:
+    """Get all open issues from the repository.
+
+    Returns:
+        List of open issues
+    """
+
+def __init__(self, config: ProjectConfig) -> None:
+    """Initialize GitHub project manager.
+
+    Args:
+        config: Project configuration
+
+    Raises:
+        ValueError: If token is not provided
+    """
+```
+
+### Testing Patterns
+
+```python
+"""Test module docstring."""
+
+from unittest.mock import MagicMock
+
+from project_manager.github import GitHubProjectManager
+from project_manager.types import ProjectConfig
+
+
+def test_has_label_returns_true_when_label_exists():
+    """Test that has_label returns True when the label is present."""
+    # Arrange
+    config = ProjectConfig(
+        repo_owner="testowner",
+        repo_name="testrepo",
+        token="fake_token",
+    )
+    manager = GitHubProjectManager(config)
+    mock_repo = MagicMock()
+    mock_pr = MagicMock()
+    mock_pr.labels = [MagicMock(name="approved")]
+    mock_repo.get_pull.return_value = mock_pr
+    manager.github_client.get_repo = MagicMock(return_value=mock_repo)
+
+    # Act
+    result = manager.has_label(123, "approved")
+
+    # Assert
+    assert result is True
+    mock_repo.get_pull.assert_called_once_with(123)
+```
+
+- Use descriptive test names: `test_<method>_<scenario>_<expected_result>`
+- AAA pattern: Arrange, Act, Assert
+- Use `unittest.mock` for mocking
+
+---
+
+## Project Structure
+
+```
+polycode/
+├── src/
+│   ├── project_manager/    # GitHub project management
+│   ├── github_app/         # GitHub App webhook server
+│   ├── celery_tasks/       # Async task processing
+│   ├── persistence/        # Database layer
+│   ├── feature_dev/        # Feature development crew
+│   └── flowbase.py         # Base flow classes
+├── tests/                  # Test files
+├── pyproject.toml          # Project config
+└── .env                    # Environment variables
+```
+
+---
+
+## Pre-commit Hooks
+
+Configured in `.pre-commit-config.yaml`:
+
+- trailing-whitespace
+- commitizen (conventional commits with gitmoji)
+- markdownlint
+- pyright (type checking)
+
+Run manually: `pre-commit run --all-files`
+
+---
+
+## Environment Variables
+
+Required in `.env`:
+
+```
+GITHUB_TOKEN=ghp_...
+DATABASE_URL=postgresql://...
+REDIS_HOST=localhost
+REDIS_PORT=6379
+OPENAI_API_KEY=sk-...
+OPENAI_URL_BASE=http://...
+```
+
+---
+
+## CrewAI Reference
+
+See `src/AGENTS.md` for detailed CrewAI patterns, agent/task configuration, and flows.
+
+**Key points:**
+
+- Use `crewai.LLM` or string shorthand like `"openai/gpt-4o"`
+- Agents and tasks in YAML configs
+- `@CrewBase` decorator on crew classes
+- `# type: ignore[index]` for config dictionary access

polycoding-0.1.0/Dockerfile

@@ -0,0 +1,39 @@
+# Use the official Python 3.13 slim image as the base
+FROM python:3.13-slim AS base
+
+# Set environment variables to avoid interactive prompts during installation
+ENV DEBIAN_FRONTEND=noninteractive
+
+# Install system dependencies, Node.js (from NodeSource), and clean up
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    git \
+    ssh \
+    curl \
+    ca-certificates \
+    && curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
+    && apt-get install -y nodejs \
+    && apt-get clean \
+    && rm -rf /var/lib/apt/lists/*
+RUN node --version && npm --version && npm install -g pnpm && pnpm --version
+
+FROM base
+WORKDIR /app
+
+COPY pyproject.toml uv.lock README.md ./
+RUN pip install --no-cache-dir "crewai[litellm]>=1.10.0b1" && uv sync
+
+COPY entrypooint.sh /usr/local/bin/entrypoint.sh
+RUN chmod +x /usr/local/bin/entrypoint.sh
+
+# Creates a non-root user and adds permission to access the /app folder
+RUN    useradd --create-home appuser \
+    && chown -R appuser /app
+USER appuser
+
+# Need to whitelist fingerprint of github
+RUN mkdir /home/appuser/.ssh && ssh-keyscan github.com >> /home/appuser/.ssh/known_hosts
+
+VOLUME [ "/data" ]
+COPY . .
+
+ENTRYPOINT ["/usr/local/bin/entrypoint.sh"]

polycoding-0.1.0/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.
+

polycoding-0.1.0/Makefile

@@ -0,0 +1,9 @@
+VERSION := $(shell date +%Y%m%d%H%M)
+
+docker_build:
+	docker build -t ghcr.io/xeroc/polycode:$(VERSION) .
+
+docker_push:
+	docker push ghcr.io/xeroc/polycode:$(VERSION)
+
+docker: docker_build docker_push