Executor

Content pipeline and publishing system for Initiative Engine.

Overview

Executor is the content execution layer of the Initiative Engine platform. It handles:

• Content pipeline processing
• Multi-channel publishing (social, blog, newsletter, etc.)
• Content transformation and optimization
• Scheduling and automation
• Analytics integration

Quick Start

Installation

# Clone the repository
git clone git@github.com:gofullthrottle/executor.git
cd executor

# Create virtual environment and install dependencies
uv venv
uv sync --dev

Development

# Run tests
make test

# Run linting
make lint

# Run type checking
make typecheck

# Format code
make format

Pre-commit Hooks

Pre-commit hooks are installed automatically. To run manually:

pre-commit run --all-files

Architecture

Pipeline Components

1. Ingestion - Accept content from various sources
2. Transformation - Convert, optimize, and enrich content
3. Validation - Ensure content meets quality standards
4. Publishing - Distribute to configured channels
5. Tracking - Monitor performance and analytics

Integration Points

• LiberatorAgent - Receives extracted content
• OrchestratorAgent - Receives publishing assignments
• AnalyticsAgent - Reports publishing metrics
• SchedulerAgent - Coordinates publication timing

Configuration

Configuration is managed via environment variables and Pydantic settings.

# Required environment variables
EXECUTOR_API_KEY=...        # API authentication
EXECUTOR_REDIS_URL=...      # Redis for job queue
EXECUTOR_DATABASE_URL=...   # PostgreSQL connection

Versioning

This project uses Commitizen for version management.

# Create a release
make release

# Dry-run release
make release-dry

# Interactive commit
make commit

License

Proprietary - All rights reserved.