steerdev 0.4.27__tar.gz

steerdev-0.4.27/.github/workflows/pre-commit.yml

@@ -0,0 +1,34 @@
+name: Pre-commit Checks
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+  workflow_dispatch:
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          submodules: true
+          token: ${{ secrets.PAT_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run pre-commit
+        env:
+          SKIP: bump-version # Skip version bumping in CI
+        run: uv run pre-commit run --all-files

steerdev-0.4.27/.github/workflows/publish.yml

@@ -0,0 +1,65 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+
+permissions:
+  id-token: write
+  contents: write
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Run pre-commit
+        env:
+          SKIP: bump-version
+        run: uv run pre-commit run --all-files
+
+  publish:
+    needs: lint
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Get package version
+        id: version
+        run: echo "version=$(uv version --short)" >> "$GITHUB_OUTPUT"
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+
+      - name: Create git tag and GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          VERSION="v${{ steps.version.outputs.version }}"
+          git tag "${VERSION}"
+          git push origin "${VERSION}"
+          gh release create "${VERSION}" --title "${VERSION}" --generate-notes

steerdev-0.4.27/.gitignore

@@ -0,0 +1,104 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+.cursor/
+*.swp
+*.swo
+*~
+
+# AI tools
+.claude/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pyright
+.pyright/
+
+# ruff
+.ruff_cache/
+
+# uv
+uv.lock
+
+# Local development
+*.local
+.DS_Store
+
+# Project specific
+outputs/
+cc-orc

steerdev-0.4.27/.pre-commit-config.yaml

@@ -0,0 +1,45 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: [--maxkb=1024]
+      - id: check-toml
+      - id: check-merge-conflict
+      - id: detect-private-key
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [--fix]
+      # Run the formatter
+      - id: ruff-format
+
+  # Use local basedpyright with project config
+  - repo: local
+    hooks:
+      - id: basedpyright
+        name: basedpyright
+        entry: uv run basedpyright src/ tests/
+        language: system
+        types: [python]
+        pass_filenames: false
+
+  # Automatic version bumping on commit
+  # Note: This hook modifies files (pyproject.toml), which is not typical for pre-commit hooks.
+  # Uncomment below to enable automatic patch version bumping on each commit:
+  - repo: local
+    hooks:
+      - id: bump-version
+        name: Bump version
+        entry: bash scripts/pre-commit-version-bump.sh
+        language: system
+        pass_filenames: false
+        always_run: true

steerdev-0.4.27/AGENTS.md

@@ -0,0 +1,57 @@
+# AGENTS.md
+
+Guidance for AI coding agents working in this repository.
+
+## Overview
+
+**steerdev-agent** is a Python CLI that orchestrates AI coding agents via subprocess execution, streaming events to the steerdev.com API. It fetches tasks, builds prompts, launches agents (Claude Code, Codex, Aider), and reports activity.
+
+## Project Structure
+
+```
+src/steerdev_agent/
+├── cli.py               # Typer CLI commands
+├── runner.py             # Main orchestrator
+├── daemon.py             # Daemon mode
+├── version.py            # Version management
+├── integration.py        # Integration utilities
+├── api/                  # API clients (tasks, sessions, events, workflows, etc.)
+├── config/               # Pydantic config models and settings
+├── executor/             # Agent subprocess execution (base, claude, stream)
+├── workflow/             # Multi-phase workflow execution and memory
+├── prompt/               # Prompt building and templates
+├── setup/                # Project setup and templates
+├── handlers/             # Task/PRD handlers
+└── git/                  # Git utilities
+```
+
+## Development
+
+- **Python 3.12+** with **uv** package manager
+- `uv sync` — install deps
+- `uv run pytest` — run tests
+- `uv run ruff check . && uv run ruff format .` — lint and format
+- `uv run basedpyright` — type check
+
+## Conventions
+
+- Type hints on all function signatures
+- Pydantic v2 for data models and config
+- Async/await for I/O (HTTP, subprocess)
+- `loguru` for logging
+- Specific exception classes (no bare `except`)
+- Absolute imports (`from steerdev_agent.config.models import ...`)
+- Import order: stdlib, third-party, local
+
+## Key Integration Points
+
+- **steerdev.com API**: Bearer auth via `STEERDEV_API_KEY`. Events POSTed to `/api/v1/sessions/{id}/events`.
+- **Executor**: Launches agents as subprocesses with `--output-format stream-json`. Parses newline-delimited JSON events.
+- **Config**: YAML config file + environment variable overrides.
+
+## Environment Variables
+
+| Variable | Purpose |
+| --- | --- |
+| `STEERDEV_API_KEY` | API authentication |
+| `STEERDEV_PROJECT_ID` | Default project |

steerdev-0.4.27/CLAUDE.md

@@ -0,0 +1 @@
+AGENTS.md

steerdev-0.4.27/PKG-INFO

@@ -0,0 +1,224 @@
+Metadata-Version: 2.4
+Name: steerdev
+Version: 0.4.27
+Summary: Backend task runner for steerdev.com - orchestrates CLI coding agents with activity reporting
+Project-URL: Homepage, https://github.com/pentoai/steerdev-agent
+Project-URL: Repository, https://github.com/pentoai/steerdev-agent
+Project-URL: Documentation, https://github.com/pentoai/steerdev-agent#readme
+Author-email: Leonardo Piñeyro <leopiney@gmail.com>
+License: MIT
+Keywords: agent,ai,automation,cli,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Terminals
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: basedpyright>=1.21.0; extra == 'dev'
+Requires-Dist: ipdb>=0.13.13; extra == 'dev'
+Requires-Dist: pre-commit>=4.0.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# SteerDev Agent
+
+Task runner for [steerdev.com](https://steerdev.com) — orchestrates AI coding agents via subprocess execution while streaming events to the SteerDev platform.
+
+## What It Does
+
+SteerDev Agent connects your AI coding agent (Claude Code, Codex, Aider) to the steerdev.com platform:
+
+1. **Fetches tasks** from your SteerDev project
+2. **Builds prompts** with project context, task details, and workflow instructions
+3. **Launches the agent** as a subprocess with JSON streaming
+4. **Streams events** back to the API for real-time monitoring
+5. **Manages sessions** for tracking and resuming conversations
+
+## Installation
+
+```bash
+# Install with uv (recommended)
+uv tool install steerdev-agent
+
+# Or from source
+git clone https://github.com/pentoai/steerdev-agent.git
+cd steerdev-agent
+uv tool install .
+```
+
+## Quick Start
+
+### 1. Set Up Your Project
+
+```bash
+# Configure the agent for your project
+steerdev-agent setup --project-id YOUR_PROJECT_ID --api-key YOUR_API_KEY
+```
+
+### 2. Set Environment Variables
+
+```bash
+export STEERDEV_API_KEY="your-api-key"
+
+# Ensure your CLI agent is logged in (e.g., `claude login` for Claude Code)
+```
+
+### 3. Run the Agent
+
+```bash
+# Run the next task in your project
+steerdev-agent run --project-id YOUR_PROJECT_ID
+
+# Run a specific task
+steerdev-agent run --project-id YOUR_PROJECT_ID --task-id TASK_ID
+
+# Resume an existing session
+steerdev-agent resume --session-id SESSION_ID --message "Continue working..."
+```
+
+## CLI Commands
+
+### `steerdev-agent run`
+
+Run the agent against a project or specific task.
+
+```bash
+steerdev-agent run --project-id PROJECT_ID
+steerdev-agent run --project-id PROJECT_ID --task-id TASK_ID
+steerdev-agent run -c agent.yaml --prompt "Fix the failing tests"
+```
+
+### `steerdev-agent tasks`
+
+Manage tasks from your SteerDev project.
+
+```bash
+steerdev-agent tasks next          # Get the next task to work on
+steerdev-agent tasks list          # List all tasks
+steerdev-agent tasks get TASK_ID   # Get task details
+steerdev-agent tasks update TASK_ID --status in-progress
+```
+
+### `steerdev-agent setup`
+
+Configure your project for use with the agent.
+
+```bash
+steerdev-agent setup --project-id YOUR_PROJECT_ID --api-key YOUR_API_KEY
+```
+
+### `steerdev-agent config`
+
+Manage YAML configuration files.
+
+```bash
+steerdev-agent config init --output agent.yaml   # Generate config
+steerdev-agent config validate agent.yaml         # Validate config
+steerdev-agent config show agent.yaml             # Show config
+```
+
+## Configuration
+
+### YAML Config File
+
+```yaml
+agent:
+  model: null                # Model override
+  max_turns: null            # Max agent turns per task
+  timeout_seconds: 3600      # Max execution time
+  workflow_id: null           # Workflow ID for multi-phase execution
+
+api:
+  api_endpoint: "https://steerdev.com/api/v1"
+  api_key_env: STEERDEV_API_KEY
+  project_id_env: STEERDEV_PROJECT_ID
+
+executor:
+  type: claude               # claude, codex, aider
+  permission_mode: default
+  allowed_tools: []
+  disallowed_tools: []
+  mcp_config: null
+
+worktrees:
+  enabled: false
+```
+
+### Environment Variables
+
+| Variable | Description |
+| --- | --- |
+| `STEERDEV_API_KEY` | API key for steerdev.com |
+| `STEERDEV_PROJECT_ID` | Default project ID |
+
+> **Note:** CLI agents (Claude Code, Codex, etc.) must be logged in independently before running steerdev-agent. No LLM API keys are needed here.
+
+## Architecture
+
+```
+steerdev-agent run
+  │
+  ├── Fetch task from steerdev.com API
+  ├── Build prompt (project context + task + workflow)
+  ├── Create session
+  ├── Launch agent subprocess (Claude Code)
+  │     └── Stream JSON events
+  │           ├── Parse (assistant, tool_use, tool_result)
+  │           └── Batch & send to steerdev.com API
+  └── Complete session
+```
+
+### Key Modules
+
+| Module | Purpose |
+| --- | --- |
+| `cli.py` | Typer CLI entry point |
+| `runner.py` | Main orchestrator |
+| `executor/` | Agent subprocess management |
+| `api/` | SteerDev API clients |
+| `prompt/` | Prompt building and templates |
+| `workflow/` | Multi-phase workflow execution |
+| `config/` | Configuration models and settings |
+| `setup/` | Project setup utilities |
+
+## Development
+
+```bash
+# Install dependencies
+uv sync --extra dev
+
+# Run tests
+uv run pytest
+
+# Lint & format
+uv run ruff check .
+uv run ruff format .
+
+# Type check
+uv run basedpyright
+```
+
+## Requirements
+
+- Python 3.12+
+- [uv](https://docs.astral.sh/uv/) package manager
+- An AI coding agent CLI (e.g., `claude` for Claude Code)
+- SteerDev API key
+
+## License
+
+MIT — see [LICENSE](LICENSE) for details.